- name
SKILL.md
O arquivo da skill permanece no repositório do publicador.
Cole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add Pluviobyte/saas-growth-agents --skill douyin-comments -a cursor -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add Pluviobyte/saas-growth-agents --skill douyin-comments -a claude-code -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add Pluviobyte/saas-growth-agents --skill douyin-comments -a codex -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add Pluviobyte/saas-growth-agents --skill douyin-comments -a grok -yEnvie a mensagem copiada em um chat do Grok Bot. O Bot busca este SKILL.md no GitHub e o adiciona às skills que todos os seus Bots compartilham.
Install this skill: https://github.com/Pluviobyte/saas-growth-agents/tree/HEAD/bots/social-kb/douyin-commentsDo publicador
device_platform/aid 直接调楼中楼接口,会立刻弹文字点选验证码,请求挂起(2026-10-30 实测)。原因是缺了页面正常请求才有的公共参数(channel、version_code、浏览器信息、msToken 等)。所以:
page_fetch.js:先拦截页面自己发出的一次真实评论请求当模板,之后只替换 aweme_id / cursor / comment_id,其余参数照抄。page_ui_expand.js:在评论区逐个点「展开N条回复」,由页面自己发请求,我们只截获响应。慢,但实测不触发风控。.internal/抖音评论/<aweme_id>/。源链接、作者、原文评论只留在 .internal/;给成稿用的归纳文件不写源信息。window.__dyc 上轮询,数据经本地接收服务落盘。下文 $SK = 本 skill 目录,$OUT = 输出目录。下面的步骤按 Claude Code + Claude in Chrome 写(实测过的环境);在 Grok Bot 等其他 Agent 里用,先看文末「在其他 Agent 里用」。
douyin.com/video/<id> → id;主页链接带 modal_id=<id> → id;v.douyin.com/… 短链先在 Chrome 打开,看跳转后的 URL。run_in_background,端口被占就换一个,并在页面设 window.__DYC_RECV):
python3 -I "$SK/scripts/recv.py" --out "$OUT/raw" --port 8765
tabs_context_mcp → tabs_create_mcp 新开标签页 → navigate 到 https://www.douyin.com/video/<id>。扩展未连接时,请用户在 Claude Code 里执行 /chrome 连接。page_hook.js 的全文(读文件后原样传入),返回 hooked。刷新或跳转页面后必须重新注入。window.__DYC_UI_MAX = 1,执行 page_ui_expand.js,让页面真实展开一个楼,拿到楼中楼模板。不做的话,主路线会用一级模板派生。Object.keys(window.__dyc.templates).join(','),至少要有 top。不要在 javascript_tool 里打印模板 URL:带 Cookie 和查询串的输出会被工具拦截。要看参数,读 $OUT/raw/template_top.json。window.__DYC_CFG = { awemeId: '<id>' }; // 可选 skipDetail: true;skipThreads: [已抓全的 cid]
然后执行 page_fetch.js 全文。每 20~40 秒用一次 browser_batch(几个 10 秒 wait + 一次 javascript_tool 读 JSON.stringify(window.__dyc))轮询,同时看 $OUT/raw/_recv.log 的增长。耗时大约是:总请求数 × 3 秒。
done → 进入第 5 步fallback → 先截图。有验证码就请用户手动过,再走第 4 步;没有验证码,说明这一页返回为空或被拒(看 reason),也走第 4 步need_template → 回到第 2 步第 3 小步,让评论区加载出来page_hook.js → 点开评论区。page_ui_expand.js(不设 __DYC_UI_MAX)。状态 ui_captcha 表示又弹了验证码:请用户手动过,脚本会自动继续。ui_done 后进入第 5 步。主路线和兜底路线的数据会自动合并去重。python3 -I "$SK/scripts/build_report.py" "$OUT"
python3 -I "$SK/scripts/download_video.py" "$OUT"(720p,带 Referer,不需要 Cookie)。转写用本机 mlx_whisper 或你手边的语音识别工具;看画面就抽帧拼联系表直接看图,不要跑 OCR。评论全文.md,按「质疑 / 疑问 / 对比 / 使用经验」归类,归纳文件放在项目根目录,不写源信息。已知限制:上千条评论的视频,一级评论 offset 超过约 500 后接口会返回重复内容,被折叠的评论也拿不到,所以总数会明显少于显示的评论数(实测 823 / 1067)。需要更全时,可以在 __DYC_CFG 之外手动加 sort_type: 1 再翻一遍,build_report.py 会自动去重合并。
还没覆盖到的情况:单个楼超过 20 条回复的翻页;ui_captcha 状态的自动检测。遇到时把结果补进上表。
$OUT/
├── raw/ # 模板、每页原始响应、_recv.log(可删)
├── comments_top.json # 一级评论(去重)
├── comments_replies.json
├── 评论全文.md # 按点赞排序,楼中楼缩进在下面
└── 参考视频.mp4 # 可选
脚本本身不依赖 Claude,只要 Agent 具备这三样就能跑:
window.__dyc 的值。127.0.0.1(接收服务 recv.py)。步骤对照:
注意:
page_hook.js 截获响应,所以至少要能注入一次脚本。抓取抖音单条视频的完整评论区(一级评论 + 全部楼中楼回复)和视频详情,可选下载视频,输出按点赞排序的「评论全文.md」和原始 JSON。在已登录抖音的真实浏览器里运行(Claude in Chrome,或 Grok Bot 等 Agent 自带、能执行页面脚本的浏览器),借页面自带 SDK 签名,不需要 TikHub、Playwright 或 a_bogus 逆向。用户给出抖音视频链接(douy
---name: douyin-commentsdescription: 抓取抖音单条视频的完整评论区(一级评论 + 全部楼中楼回复)和视频详情,可选下载视频,输出按点赞排序的「评论全文.md」和原始 JSON。在已登录抖音的真实浏览器里运行(Claude in Chrome,或 Grok…---# bots/social-kb/douyin-comments/SKILL.mdVisão geral
抓取抖音单条视频的完整评论区(一级评论 + 全部楼中楼回复)和视频详情,可选下载视频,输出按点赞排序的「评论全文.md」和原始 JSON。在已登录抖音的真实浏览器里运行(Claude in Chrome,或 Grok Bot 等 Agent 自带、能执行页面脚本的浏览器),借页面自带 SDK 签名,不需要 TikHub、Playwright 或 a_bogus 逆向。用户给出抖音视频链接(douyin.com/video/…、带 modal_id 的主页链接、v.douyin.com 短链),并说"看评论区""抓评论""拉评论""评论区有什么质疑/疑问""参考评论区"时使用。只适用于抖音单条视频;小红书、B 站、批量采集博主全部作品不适用。
Perguntas frequentes
Baixe bots/social-kb/douyin-comments/SKILL.md do publicador ou copie o caminho e abra o repositório. O PlugMCP lista a skill e não hospeda o arquivo.
O publicador o mantém em https://github.com/Pluviobyte/saas-growth-agents.
Claude, Cursor, Codex e Grok Build conseguem ler um SKILL.md que você adiciona a partir do repositório do publicador. O Grok Bot o instala quando você envia em um chat o link da pasta da skill no GitHub.