技能介绍

解决的问题

处理抖音内容时，常见难点不只是下载单个视频：同一分享链接可能对应纯视频、图文笔记、混合媒体或动图/slides，解析接口和输出文件也不同。若只做单一视频下载，容易漏掉图片，或无法统一保存目录和文件名。这个技能面向的是：拿到一个抖音链接或分享口令后，自动判断作品类型，并把可下载的媒体整理成规范目录。

技能如何工作

核心路径是 多源降级解析 + 统一媒体落盘：优先尝试 iesdouyin，失败后回退到 douyin 网页解析，再继续尝试 API，以提高不同作品类型的可用性。技能会自动识别作品类型，包括：

纯图文：下载所有图片
纯视频：获取无水印视频下载链接并保存文件
混合作品：同时保存图片和视频
动图/slides：保存帧图片与视频文件

下载结果统一写入 douyin-scraper-downloads/YYYYMMDD_作者_标题/，文件名采用 作者_标题 或 作者_标题_01 的形式，便于按日期、作者和标题检索。对视频部分，还可以调用语音转文字能力提取文案，该能力需要配置 DOUYIN_API_KEY 或 API_KEY。

适用边界

该技能更适合链接解析、媒体下载和本地归档场景，不是完整的抖音账号采集或实时数据管道。输入支持短链、视频页、图文页以及包含链接的分享口令；输出文件名会过滤 emoji、空格、标点和 hashtag 等字符，并对作者/标题做长度截断。语音文案提取依赖外部 API，未配置密钥时应仅使用基础下载能力。