下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/aidata--dy-sub-comments.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @aidata/dy-sub-comments。- 抖音视频二级评论(回复/楼中楼)采集工具(分步会话)。当用户需要采集抖音视频评论区的回复——某条评论下的二级评论、楼中楼对话、回复@关系(昵称、IP属地、回复内容、时间、点赞数、回复对象),导出回复 CSV(Excel 直开),或提到"
- 抖音二级评论/抖音回复采集/楼中楼/评论回复导出/评论区对话采集"
- 时使用本 skill。支持 douyin.com/video/<
- id>
- 直链与 v.douyin.com 短链(短链由节点自动还原)。分步会话制:start 建会话(免费)后节点自动逐楼推进——每步自动挑下一楼有未采回复的主评论点一次展开(一批约 10-20 条 = 1 点数),滚动加载主评论不另收费(0 回复步自动返还),每步实时返回增量并由 AI 询问用户是否继续(注册送 10 点)。如需同时采集一级评论+二级回复,请改用 …
阅读全文 (展开查看完整说明)
概述
抖音二级评论采集 Skill(dy-sub-comments)
AI 调用来源参数(必填)
所有会访问后端 API 的命令必须携带 --skill-name dy-sub-comments 和 --ai-entry <AI工具标识>(例如 claude-code、codex、workbuddy)。IP 无需传递,由服务端自动获取。首次缺参会告警放行,第二次起拒绝。
示例:node cli.js quota --skill-name dy-sub-comments --ai-entry claude-code。
产品定位:输入抖音视频链接 → 平台调度内网浏览器节点打开该视频页 → 自动逐楼推进采集二级回复(无需指定主评论)→ 结果实时分步返回、可 CSV 导出。
与 dy-comments 的分工:本 skill 只采二级评论(回复);dy-comments 采一级评论(默认不含子评论,加 --with-subs 才一二级同采)。数据落在同一套表里,导出 CSV 列结构一致。
会话制(与 dy-comments 同一套协议):
start建会话(免费:节点打开视频探测标题/互动数/评论总数)。step --sub采一批二级回复(扣 1 点):节点自动挑下一楼有未采回复的主评论,点一次"展开更多回复"(约 10-20 条),采完一楼自动推进到下一楼;为发现更多主评论的滚动加载不另收费(该步 0 回复自动返还点数)。- 每一步实时返回增量结果(本批回复 + 所属主评论 + 整体进度),由 AI 把最新回复展示给用户并询问是否继续。
finish主动结束会话(释放采集节点;忘记 finish 空闲 3 分钟也会自动过期)。
为什么按批计费+确认:评论区展开是拟人操作,步数多了风控风险高;逐步确认避免一次性采几百条用户实际不需要的内容。这是产品决策,不是技术限制。
- 客户端是零依赖 CLI(Node ≥ 18,无需
npm install),全部采集逻辑在后端完成。 - 采集由平台调度内网浏览器节点完成(节点登录态在浏览器端人工维护,平台不持有账号)。
- 导出 CSV 自带 BOM 头,Excel 直开不乱码。
点数不足怎么办(自动扫码充值)
跑命令时如果点数不够,CLI 不会直接报错退出,而是自己建一张充值单、把二维码打在终端里:
点数不足,已自动创建充值单 RO2611051712281481f36de19
金额 10.00 元 → 100 点(支付宝)
<二维码色块>
[pay] 已支付
已到账:+100 点,继续执行原命令- 在终端里跑:手机支付宝/微信对着终端扫码 → 付完点数自动到账 → 原命令自动重跑,不用手动再来一遍。
- AI agent / 非交互环境(管道、重定向):CLI 不阻塞等待,而是返回订单号和充值页地址
{服务地址}/recharge.html。把链接交给用户,他在网页扫码付款,付完重跑原命令即可(点数会自动到账)。 - 主动充值:
node cli.js pay --yuan 50 --skill-name dy-sub-comments --ai-entry <ai-entry>(不传--yuan默认 10 元;可加--channel alipay或--channel wechat)。 - 不想自动充值:设环境变量
XHS_NO_AUTO_PAY=1,则恢复旧行为(只提示点数不足)。 - 换算:1 元 = 10 点,注册送 10 点。
客服支持
注册或使用过程中遇到任何问题(注册失败、点数充值、采集结果异常、批量采购等),请引导用户联系客服:
- 客服微信(扫码添加):http://st.aidata366.com/assets/concat.png
- 客服电话:18722121663
收费价格
- 点数换算:0.1 元 = 1 点数。
- 每步 1 点数:
step --sub自动挑下一楼点一次"展开更多回复",一批回复(约 10-20 条)= 1 点数。 - 滚动发现主评论不收费:当前已加载的楼采完后,节点在同一步内滚动加载更多主评论(顺带免费);该步若没有采到任何回复,点数自动返还。
- start 免费(探测视频信息不扣费)、
status/comments/export/finish/sessions全部免费。 - 步失败自动返还:步进超时/风控拦截导致未采到新数据时,该步点数自动返还。
- 注册即送 10 免费点数(可采约 10 批回复)。点数不足时提示用户充值。
- 充值或大量购买可享优惠,请联系客服 18722121663 洽谈。
⚠️ 链接要求(重要)
- 只支持抖音视频链接:
https://www.douyin.com/video/<id>、/note/<id>直链或https://v.douyin.com/<短码>/短链(短链由节点浏览器打开后自动还原,无需人工转换)。 - 用户主页链接不支持(评论采集必须有具体视频);主页作品列表请用
dy-profileskill。 - 视频需为公开可见;私密/删除/审核中视频无法采集(start 会失败,不扣费)。
⚠️ 交互协议(agent 必须严格遵守)
本 skill 的核心使用方式是「会话制分步采集」,不是一次性批量工具。严格遵守以下流程(这是产品决策——评论区展开是拟人操作,步数多了风控风险高,按批计费+用户确认,避免一次性采集用户实际不需要的内容):
流程
- 查余额:
node cli.js quota --skill-name dy-sub-comments --ai-entry <ai-entry>确认点数充足(余额 < 1 无法 step)。 - 建立会话(免费):
node cli.js start --url <视频链接> --skill-name dy-sub-comments --ai-entry <ai-entry>→ 返回session_id、视频文案、评论总数(metrics.comment_count,含回复)。 - 报价确认(必须):把评论总数和计费口径告诉用户,等用户确认后再开始 step:
- 例:
这个视频共 N 条评论(含回复)。二级回复按批采集:节点每步自动挑下一楼有回复的主评论点一次展开,一批约 10-20 条 = 1 点;批次数取决于各楼回复量,逐步确认、随时可停。
- 例:
- 逐步采集:
node cli.js step --session <id> --sub --skill-name dy-sub-comments --ai-entry <ai-entry>采下一批回复。每步返回后:- 把本批新增回复(昵称/内容/时间/点赞/IP属地/回复对象/所属主评论)展示给用户;
- 告知整体进度(
expand_pending待展开楼数 /expand_done已完成楼数); - 每步都要询问用户是否继续采下一批。
- 中途可随时:
status查会话状态与余额;comments免费翻看已采累计明细;export免费导出已采部分 CSV。 - 结束会话:
finish主动结束(推荐,立即释放采集节点);或用户不想采了放着 3 分钟自动过期。
会话保持时间:采集节点绑定到会话直到 finish 或 3 分钟空闲自动过期。会话过期后需重新 start(probe 重新探测,免费)。已采集的评论数据不会丢失(落库),comments / export 对已过期会话依然有效。
绝对红线
- 报价未确认前禁止执行 step(start/status/comments/export 免费,可随意调用)。
- 每步后必须询问用户是否继续,不要连续 step 多批。
- 绝不把 start 返回的
session_id泄露给终端用户(他人可用它枚举你的会话数据)。 - 不要将免费额度(start probe)用于资源探测(如对同一视频反复 start 试图刷探测结果)。
时长与超时预期
step单步服务端最长可执行 180 秒(节点滚动+展开+数据回传),CLI 客户端超时 200 秒。单步超时是正常现象,该步点数已自动返还,直接重试同一步即可。- 会话空闲 3 分钟自动过期(过期后
step返回 1404 会话不存在,重新start即可,已采数据不丢)。 - 采集节点池紧张时
step可能排队等待几十秒,属正常。
前置条件
- Node.js ≥ 18(使用内置 fetch,零 npm 依赖)。
- 不注册不登录没有任何点数:所有接口都需要 token,10 免费点数在注册成功后发放到账号。
- 首次使用需先
register --link(注册即送 10 点数;用户手机微信扫码/点链接在网页完成,页面自带图形+短信验证码)或login --link(已有账号)。成功后 token 自动保存,后续调用免输。 - 配置文件(含 token)存放于用户级目录
~/.xhs-platform/config.json(升级/重装 skill 不丢配置;与小红书系列 skill 共用同一账号体系)。可用环境变量XHS_CONFIG_PATH覆盖(测试隔离用)。 - 安全策略:登录和注册(发短信)每次都强制图形验证码,终端无法展示,所以一律走
--link微信扫码/链接方式。 - 后端服务地址默认
http://st.aidata366.com,可用node cli.js config set base-url <url>修改,或单次加--base-url <url>覆盖。 - ⚠️ 安全提示(重要):默认服务地址是明文 http,token 会在公网明文传输。客户端每次请求都会在 stderr 提示。请知悉该风险;如环境允许,建议通过
config set base-url https://...切换到 https 服务地址(需服务端已配好证书)。 - 所有命令支持全局参数
--token <token>(临时覆盖配置文件中的 token)。 ~/.xhs-platform/config.json含 token,不要泄露、不要提交 git。
输出规约(重要)
- stdout 只输出 JSON:成功
{"ok":true,"data":{...}},失败{"ok":false,"code":<业务码>,"message":"..."}。直接解析 stdout 即可。 - 交互提示(如「请把计费口径报给用户确认」)一律走 stderr,不要解析,但其中给用户的引导话术应照做。
- 退出码:
0成功;1参数/用法错误;2认证失败(重新 login);3点数不足;4网络/服务不可达;5其它业务错误。
命令清单
version — 查看版本与安装信息
node cli.js version{"ok":true,"data":{"name":"dy-sub-comments","version":"1.0.0","capability":"dy_comments"}}register — 注册(注册即送 10 点数)
方式一:扫码/链接注册(唯一方式,用户在手机上完成)
node cli.js register --link --skill-name dy-sub-comments --ai-entry <ai-entry> # 生成注册二维码/链接
node cli.js register --check --access-token "<上一步下发的串>" --skill-name dy-sub-comments --ai-entry <ai-entry> # 用户完成后确认并保存 tokenregister --link 的 stdout 返回 qr_url / register_url / access_token。agent 必须把注册引导原样发给用户(stderr 里也给出了同样话术,可直接复制):
需要先注册账号(注册即送 10 免费点数;不注册不登录没有点数,无法采集)。请用手机微信扫码或打开链接注册:
注册方式(二选一)
二维码图片:<qr_url>
注册链接:<register_url>
access_token(注册后校验用):<access_token>
微信扫码/注册完成后告诉我一声,我会执行校验并保存凭证,然后继续之前的操作:
(注册/使用中如遇问题,请拨打客服电话 18722121663)用户说「注册完成」后执行 register --check --access-token "<access_token>":
- 成功:token 自动保存,返回
quota_balance: 10,继续之前的操作。 LOGIN_PENDING:用户还没完成注册,提醒后再试。LOGIN_EXPIRED:会话过期(10 分钟)或已使用,重新执行register --link。
login — 登录
node cli.js login --link --skill-name dy-sub-comments --ai-entry <ai-entry>
node cli.js login --check --access-token "<上一步下发的串>" --skill-name dy-sub-comments --ai-entry <ai-entry>引导话术同 register(把"注册"换成"登录")。成功后 token 自动保存。
quota — 查询点数
node cli.js quota --skill-name dy-sub-comments --ai-entry <ai-entry>{"ok":true,"data":{"quota":10,...}}start — 建立会话(免费)
node cli.js start --url "https://www.douyin.com/video/7312345678901234567" --skill-name dy-sub-comments --ai-entry <ai-entry>
node cli.js start --url "https://v.douyin.com/iAbCdEf/" --skill-name dy-sub-comments --ai-entry <ai-entry> # 短链直接提交, 节点自动还原输出示例:
{"ok":true,"data":{
"session_id":"e3b0c44298fc1c149afbf4c8996fb924",
"mode":"sub",
"video_id":"7312345678901234567",
"url":"https://www.douyin.com/video/7312345678901234567",
"title":"机油怎么选?一篇讲透",
"metrics":{"aweme_id":"7312345678901234567","digg_count":"1.2万","comment_count":"156",
"collect_count":"890","share_count":"45","play_count":"56万"},
"comment_count":156,
"status":"active",
"expires_in":180,
"quota_balance":10
}}拿到 session_id + 评论总数后,必须把数字和计费口径报给用户做报价确认(每批回复 1 点),确认后才能 step。
step –sub — 采集一批二级回复(扣 1 点)
node cli.js step --session <session_id> --sub --skill-name dy-sub-comments --ai-entry <ai-entry>节点自动挑下一楼有未采回复的主评论点一次展开,返回示例:
{"ok":true,"data":{
"type":"sub",
"root_cid":"7350000000000000001",
"comments":[{"comment_id":"7350000000000000002","nickname":"车友B","content":"同感",
"create_time":"03-15","like_count":"2","ip_location":"广东",
"reply_nickname":"车友A"}],
"sub_has_more":true,
"subs_collected_for_root":13,
"new_mains_count":0,
"has_more_main":true,
"all_done":false,
"expand_pending":7,
"expand_done":2,
"mains_collected":20,
"subs_collected":15,
"quota_balance":9,
"session_status":"active"
}}解读要点(agent 必读):
root_cid:本批回复所属的主评论 cid(展示时标注"以下回复来自主评论 xxx 下方");空串表示本步只滚动加载了主评论、未展开回复(该步点数已自动返还)。sub_has_more: true表示该楼回复未采完(后续 step 会接着采该楼,再扣 1 点)。expand_pending/expand_done:整体进度(待展开/已完成的主评论楼数),每步报给用户。all_done: true表示二级回复已全部采完(再 step 返回no_more: true,不扣费)。quota_balance为当前余额,每步后必须核对,余额不足时提醒用户充值。- 每一步输出中的回复是本步增量,不是全量。全量累计请用
comments命令翻页获取,或export导出。
status — 查询会话状态(免费)
node cli.js status --session <session_id> --skill-name dy-sub-comments --ai-entry <ai-entry>返回会话状态(active/expired/finished)、视频信息、累计采集量(mains_collected/subs_collected)、整体进度(expand_pending/expand_done)、quota_balance。
comments — 拉取累计评论明细(免费)
node cli.js comments --session <session_id> --skill-name dy-sub-comments --ai-entry <ai-entry> # 默认第 1 页, 100 条/页
node cli.js comments --session <session_id> --page 2 --page-size 50 --skill-name dy-sub-comments --ai-entry <ai-entry>返回该会话累计采集的全部评论(主评论+回复,分页),落库数据,会话过期后依然可查。字段含 comment_id、nickname、content、create_time、like_count、ip_location、sub_comment_count、root_cid(回复所属主评论)、reply_nickname。
export — 导出会话结果 CSV(免费)
node cli.js export --session <session_id> --out 二级回复导出.csv --skill-name dy-sub-comments --ai-entry <ai-entry>
node cli.js watch --session <id> --skill-name dy-sub-comments --ai-entry <ai-entry>
node cli.js inbox --days 7 --skill-name dy-sub-comments --ai-entry <ai-entry>下载该会话累计评论 CSV(BOM 头,Excel 直开不乱码),列含评论 ID、所属主评论 ID、昵称、IP 属地、内容、时间、点赞数、回复对象等。含已过期会话——只要 session_id 在,随时可导出。
finish — 结束会话(免费)
node cli.js finish --session <session_id> --skill-name dy-sub-comments --ai-entry <ai-entry>主动结束会话、立即释放采集节点。返回 status: "finished"。
sessions — 列出自己的会话(免费)
node cli.js sessions --skill-name dy-sub-comments --ai-entry <ai-entry> # 全部会话
node cli.js sessions --status active --skill-name dy-sub-comments --ai-entry <ai-entry> # 只看进行中分页列出当前用户的历史会话(session_id、mode、视频链接、状态、累计采集量、创建时间)。
logout — 登出(切换账号)
node cli.js logout --skill-name dy-sub-comments --ai-entry <ai-entry>config — 配置管理
node cli.js config set base-url http://127.0.0.1:8084
node cli.js config show # token 脱敏显示典型工作流(agent 照此执行)
用户:帮我采集这个抖音视频评论区的回复 https://v.douyin.com/iAbCdEf/
- 检查链接:
v.douyin.com短链直接可提交(节点自动还原),不需要人工转换。 - 登录检查:
node cli.js quota --skill-name dy-sub-comments --ai-entry <ai-entry>→ 未登录则引导login --link(或注册register --link送 10 点数)。 - 建立会话(免费):
node cli.js start --url "https://v.douyin.com/iAbCdEf/" --skill-name dy-sub-comments --ai-entry <ai-entry>。 - 报价确认:把
comment_count(评论总数,含回复)与计费口径报给用户:- 例:
这个视频共 156 条评论(含回复)。二级回复按批采集:每步自动挑下一楼有回复的主评论点一次展开,一批约 10-20 条 = 1 点;批次数取决于各楼回复量,每步我都会把最新回复给你看并确认是否继续,随时可停。是否开始? - 用户确认后才继续;余额不足先引导充值。
- 例:
- 采集第一批:
node cli.js step --session <sid> --sub --skill-name dy-sub-comments --ai-entry <ai-entry>。 - 展示 + 询问:把本批回复摘要(昵称/内容/点赞/IP属地/所属主评论)展示给用户;报整体进度(待展开 X 楼 / 已完成 Y 楼);问「是否继续采下一批?」。
- 循环 step:用户确认继续 → 再采一批,直到用户喊停 /
all_done: true/ 点数不足。 - 收尾:用户不再继续 →
node cli.js finish --session <sid> --skill-name dy-sub-comments --ai-entry <ai-entry>释放节点(数据已落库)。 - 交付:
node cli.js export --session <sid> --out <视频文案或日期>_二级回复.csv --skill-name dy-sub-comments --ai-entry <ai-entry>→ 把 CSV 路径交给用户。 - 用户要求分析回复(舆情/问答还原/争议点统计)→ 可基于导出 CSV 或
comments明细直接分析,无需重新采集。 - 会话过期不等于失败:
step拿到 3006 时结果已随错误输出带回,或跑watch/inbox取回,把已采条数 + CSV 路径交给用户;要接着采只能重新start。
错误处理指引
| code | 含义 | agent 下一步 |
|---|---|---|
| 1001 | 参数错误(session id 不合法/step 类型不合法/会话模式不匹配) | 检查 --session <32位id>;「本会话不是二级评论采集会话」= 该会话由 dy-comments 建立,二级回复请用本 skill 重新 start(退出码 1) |
| 1002 / 1003 | 未登录 / token 失效 | 引导 login --link(未注册先 register --link 送 10 点数)(退出码 2) |
| LOGIN_PENDING / LOGIN_EXPIRED | 用户未完成 / 会话过期 | 提醒用户完成扫码后重试 --check,或重新 --link(退出码 2) |
| 2003 | 需要图形验证码 | 终端无法完成,统一走 --link;仍无法解决拨打客服电话 18722121663 |
| 3001 | 点数不足 | 提示用户拨打客服电话 18722121663 充值,不要重试(退出码 3) |
| 3006 | 会话不存在/已过期/已结束 | 已采结果会自动带在错误输出的 data 里(collected / comments_count / comments_preview / csv_path)→ 直接把摘要和 CSV 交给用户;想提前拿结果用 watch,回来时用 inbox;继续采集需重新 start |
| 1404 | 会话不存在(含已过期/已 finish) | 重新 start 建会话(probe 免费),已采数据不丢可继续 export |
步超时 / no_new | 单步超时(最长 180s) | 该步点数已自动返还;直接重试同一步(step --sub) |
| 风控拦截 | 页面要求滑块/验证码 | 点数已返还;稍等几分钟再试;持续拦截提示联系客服 18722121663 |
| 4290 | 触发限流 | 稍等后重试 |
| TIMEOUT | step 客户端超时(200s) | 服务端可能仍在执行;先 status 查累计量再决定是否重试本步 |
| NETWORK_ERROR | 网络/服务不可达 | 检查 config show 的 base_url(退出码 4) |
计费规则提示
- 免费:start(探测)/ status / comments / export / finish / sessions / quota / query,以及被参数校验拒绝的请求。
- 计费:仅 step –sub(每步 1 点 = 一次展开回复);
no_more步不扣费。 - 自动返还:步进超时/风控拦截等未采到新数据的失败步,点数自动返还;只滚动加载了主评论、未采到回复的步同样全额返还(滚动发现主评论不收费)。
- 不返还:已成功采到新回复的步(即使该批回复少于预期也收 1 点)。
红线
- 仅采集公开评论数据;不用于任何违法违规用途。
- 报价未确认不 step、每步后必须询问(见「交互协议」),不要擅自连续采集。
- 不要向用户承诺 100% 成功;风控/超时失败如实透出(失败步点数已返还)。
- 评论含用户公开昵称与 IP 属地:仅用于用户已授权或公开可获取的舆情/调研场景,遵守平台与数据合规要求;不在未授权场景下转售、滥用;CSV 导出文件请告知用户自行妥善保管。
会话结束/过期:必须主动把结果交给用户
会话有 3 分钟空闲上限(步进中断兜底 15 分钟)。过期/结束不是失败:已采数据仍然有效、仍然能读能导,服务端不会推送,必须由你主动交给用户。三条路,按场景选:
step撞上code=3006:CLI 已把结果收敛进错误输出的data(status/expired_reason/collected/comments_count/comments_preview/csv_path),退出码 5。直接把这份摘要 + CSV 路径告诉用户,不要只回一句「会话已结束」。- 用户说「我先忙,等它采完」:跑
watch --session <id>守候,过期那一刻自动导出并输出结果;--interval(默认 10s)控制轮询间隔,--max-wait(默认 1800s)到点返回watching_timeout:true+ 当前进度。 - 用户隔一段时间回来:先跑
inbox,列出近 7 天「已结束但还没播报过」的二级回复会话(本地~/.xhs-platform/session_inbox_seen.json去重,最多 10 条),有就主动告知标题/状态/已采条数/CSV 路径。
watch / inbox 都不扣点。要继续采集只能重新 start 建新会话(原会话已采数据仍可用 comments --session <id> / export 读取)。