一、这个 skill 是做什么的
当你想在抖音上找爆款视频来「对标」、或者想把某个视频的口播文案扒下来参考、又或者只是想把视频存到本地,这个 skill 就能帮你。它做三件事:筛选(按点赞/评论/分享数挑高互动视频)、下载(把视频文件存到本地)、文案提取(把视频里说的口播台词转成文字)。
文案提取用的是「双层方案」:优先读视频自带的字幕轨(API 字幕),没有字幕的视频再用语音识别(ASR)兜底,把音频转成文字。最终视频和文案会按「搜索关键字」分目录保存,方便你整理。
它还附带「信息查询」能力,能看某个视频的点赞、评论、收藏、分享等互动数据。如果脚本方式拿不到数据,它还能改用 Chrome 浏览器自动化(Chrome MCP)去拦截抖音的网络请求,拿到更完整的数据。
二、什么时候用它
- 「帮我下载这个抖音视频」
- 「提取这条视频的口播文案 / 转成文字」
- 「筛选抖音上的高赞 / 爆款视频」
- 「看看这个视频的互动数据(点赞、评论多少)」
- 「扒一下这个抖音博主的口播台词」
- 你想批量采集一类视频做竞品分析
三、前置条件 / 准备
必需环境
- Python 3.10+:脚本运行环境。
- Chrome 浏览器:需要已安装,并且已登录抖音账号(很多数据需要登录态才能拿到)。
- httpx 库:运行
pip install httpx 安装。
提取无字幕视频的文案时需要(可选)
- FFmpeg:音频提取用,Windows 需下载安装并加入 PATH。
- faster-whisper:本地语音识别,运行
pip install faster-whisper 安装(首次会自动下载模型,约 75MB,请确保网络通畅)。
⚠️ 合规提醒:下载和提取文案请仅用于个人学习、竞品参考等合法用途;大量频繁下载可能触发抖音反爬,建议控制频率、不要滥用。
四、具体用法(步骤)
- 确定要做什么:下载、提取文案、筛选爆款、还是只看数据。把视频链接或视频 ID 发给它(链接形如
https://www.douyin.com/video/数字,数字那串就是 video_id)。
- 筛选爆款(可选):如果想批量筛,可以先在
config.json 的 filter.candidates 里填候选视频列表(格式:视频ID、标题、作者、点赞、评论、收藏、分享),或临时用命令降低门槛。
- 执行操作:它跑脚本完成下载 / 提取 / 查询,视频存到
~/抖音下载/关键字/ 下,命名形如 2026-04-19 一周AI大事盘点.mp4 和同名 .txt 文案。
- 看结果:文案文件里包含视频ID、标题、作者、互动数(👍💬⭐🔗)和口播正文,直接给你看。
五、可直接照用的示例
你直接对 AI大模型或AI智能体 说:
帮我下载这个抖音视频并提取口播文案:https://www.douyin.com/video/7611489793444171048
AI大模型或AI智能体 会:
自动从链接里取出视频 ID 7611489793444171048,下载视频文件,先尝试读内置字幕;若没有字幕就调用语音识别把台词转成文字,最后把视频路径、文案内容、互动数据一并发给你,文件按关键字分目录存好。
你直接对 AI大模型或AI智能体 说:
帮我筛选一批抖音高赞视频,最低点赞 1 万以上的那种,关键字记成「赚钱干货」。
AI大模型或AI智能体 会:
用筛选规则(你也可临时调低门槛)挑出符合条件的高互动视频,逐个下载并按「赚钱干货」分目录存放视频与文案,完成后汇报筛选和下载结果。
进阶 / 可选:熟悉命令行可直接调主脚本 douyin_fetch.py。下面是大白话版的常见用法——「filter」是按规则筛+下,「download」是下指定视频,「transcript」是只提文案,「info」是只看数据:
# 筛选+下载(用 config.json 里的候选和规则)
python douyin_fetch.py filter
# 临时降低门槛:只要点赞≥10000
python douyin_fetch.py filter --min-digg 10000 --min-comment 0 --min-share 0
# 下载指定视频
python douyin_fetch.py download 7611489793444171048
# 只提取文案(无本地文件时在线提取)
python douyin_fetch.py transcript 7611489793444171048
# 只看视频信息
python douyin_fetch.py info 7611489793444171048
六、常见注意 / 避坑
- 视频得有口播内容:纯音乐、无台词的视频提取不出文案。
- API 字幕可能为空:部分视频没内置字幕,会自动转用语音识别(ASR)兜底;若 ASR 报错,检查 FFmpeg 和 faster-whisper 是否装好。
- 「无声音」的处理:抖音对部分视频分离了音视频轨道,脚本下载可能没声音,可改用 Chrome MCP 方式拿到更完整的视频地址。
- 拿不到数据先试 Chrome MCP:脚本失败多半是缺登录态,让它通过浏览器自动化拦截网络请求通常能解决。
- 下载可能失败:受网络或抖音限制影响,失败可重试;别短时间大量下载,容易触发风控。
七、相关 skill / 延伸
- douyin-hot-trend:获取抖音实时热榜/热搜,先找热点再来决定采集哪些视频,和它配合最好。
- laoyi-koubo-edit:把提取到的口播视频拿去剪气口、加字幕、出封面,形成「采集→剪辑」流水线。
- video-editor:通用本地视频剪辑,对已下载视频再加工可用它。
- daihuo-video-gen:参考爆款文案后,用它反过来生成自己的带货视频。