Douyin Comments

douyin-comments — 工具说明

本文是 expert-douyin 专家包内的工具说明书，不独立出现在技能列表中。由相关 Workflow 指引调用。

抓取指定抖音视频的评论，供对标分析、起号标签反推、评论动机解读使用。

输入：视频 aweme_id 或视频链接（支持 v.douyin.com 短链，自动展开）。 输出：JSON（stdout，含评论全文、点赞数、回复数、用户昵称、IP 属地、日期）；--output 时额外落一份按点赞降序的 markdown 摘要。

登录态复用中央存储导出的 douyin cookie + UA（与 douyin 持久化 session 同一登录态），纯 HTTP 请求，不启动浏览器。

使用方式

# 按 aweme_id 抓（默认前 40 条热度评论）
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

参数说明：

返回 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