抖音下载
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8dd18822/douyin-save。
技能介绍
要解决什么问题
工程师或 Agent 经常拿到一条抖音短链(https://v.douyin.com/...)或完整视频页 URL,需要去水印保存视频、批量拉取图文帖里的图片,或读出标题、作者、点赞/评论/分享等元数据。手工在浏览器里找真实 CDN 地址既费时,又容易踩到带 playwm 的水印流。
技能如何工作
本技能不依赖额外 npm 包,核心在随附的 scripts/douyin-parse.cjs:用移动端 User-Agent 拉页面,从 window._ROUTER_DATA 里解析 video(...) / note(...) 等动态 key;短链会自动跟 302 到完整地址。视频侧把跳转 URL 里的 playwm 换成 play 得到无水印地址并下载为 .mp4;图文侧收集图片 URL 并落盘。
调用方式很简单:第一个参数是抖音链接,第二个可选输出目录(默认 ./output)。进度打在 stderr,结构化结果 JSON 打在 stdout,便于 Agent 直接解析:
- 视频:
type="video",videoUrl为无水印地址,savedFiles含本地 mp4 路径。 - 图文:
type="images",images为全部图片 URL,savedFiles为已下载文件路径。
处理结果时:无 error 则向用户说明类型与 savedFiles;图文超过 3 张时脚本只下前 3 张,note 会说明剩余张数,需一并转述并给出 images.length。
边界与注意
部分作品需登录或受地域/版权限制,可能出现 error 或视频 savedFiles 为空且 note 提示——应如实说明,不要假装成功。CDN URL 临时有效,解析后应尽快下载。内容仅供个人学习与备份,遵守平台规则与版权法规。
使用场景
- 用户在对话中粘贴 `v.douyin.com` 短链,要求将无水印视频保存到工作区指定或默认 `output` 目录。
- 收到抖音图文链接,需要知道共有几张图,并把脚本实际下载的前几张路径反馈给用户。
- 解析抖音视频页链接,提取标题、作者及点赞/评论/分享数,用于整理素材或归档记录。
- 在自动化流程中调用 `douyin-parse.cjs`,根据 stdout 的 `type` 与 `savedFiles` 决定如何回复用户。
适合人员
- 维护 Agent 对话流程、需把「帮我把这个抖音存下来」类请求转成本地文件的工程师
- 经常收到群聊转发的抖音短链、要把无水印视频或图文备份到本机的内容创作者
- 只做公开页可访问素材、需从链接拉元数据与媒体文件的竞品/舆情分析同学
- 负责封装 Node 脚本调用、须根据 `error` 与 `note` 向用户如实说明成败的全栈开发者