| name | douyin-comments |
| description | 抓取抖音视频的评论列表(纯 HTTP + cookie + 签名,不起浏览器),输出 JSON 与按点赞排序的 markdown 摘要。 |
douyin-comments — 工具说明
本文是 expert-douyin 专家包内的工具说明书,不独立出现在技能列表中。由相关 Workflow 指引调用。
抓取指定抖音视频的评论,供对标分析、起号标签反推、评论动机解读使用。
输入:视频 aweme_id 或视频链接(支持 v.douyin.com 短链,自动展开)。
输出:JSON(stdout,含评论全文、点赞数、回复数、用户昵称、IP 属地、日期);--output 时额外落一份按点赞降序的 markdown 摘要。
登录态复用中央存储导出的 douyin cookie + UA(与 douyin 持久化 session 同一登录态),纯 HTTP 请求,不启动浏览器。
使用方式
douyin-comments fetch --aweme-id 7389012345678901234
douyin-comments fetch \
--url "https://www.douyin.com/video/7389012345678901234" \
--limit 60 \
--output douyin/ref/dna-0/comments/sample-1.comments.md
参数说明:
| 参数 | 说明 |
|---|
--aweme-id / --url | 二选一;--url 支持短链,自动展开解析 |
--limit | 抓取条数上限,1-200(上限是防批量请求触风控),默认 40 |
--output | 可选;写入按点赞降序的 markdown 摘要,路径由调用方指定 |
返回 JSON 主要字段:
{
"ok": true,
"awemeId": "...",
"total": 1234,
"fetched": 40,
"truncated": true,
"comments": [
{"cid": "...", "text": "...", "likeCount": 89, "replyCount": 3, "userName": "...", "ipLabel": "...", "createTime": "2026-08-01"}
]
}
必做约束
- 只读抓取,不发表、不点赞、不回复任何评论。
- 单次任务批量抓多条视频评论时逐条串行调用,控制总条数(每条 ≤
--limit),避免批量请求触风控。
- 评论文本是用户原话,分析时按动机归类(喜欢内容价值 / 喜欢人物状态 / 喜欢形式设定 / 提出具体问题 / 非恶意吐槽),不要把评论数直接当内容质量。
Exit codes
| code | 含义 | 调用方动作 |
|---|
0 | 抓取成功(truncated=true 表示达到 limit 或分页中断,未抓全) | 继续分析 |
1 | 参数错 / 网络错 / 签名不可用(stderr 有原因) | 排查后重试;签名不可用交 IT engineer 配凭证 |
2 | SESSION_EXPIRED——cookie 缺失或失效 | 走 login-manager --platform douyin 有头重登后重试 |