Agent Skill

微博评论采集

微博评论采集工具(分步会话)。当用户需要采集某条微博下面的评论——发布者昵称、评论内容、时间、点赞数、回复@、二级回复,导出评论 CSV(Excel 直开),或提到"微博评论/评论采集/评论导出/评论分析/评论区舆情"时使用本 skill。支持 weibo.com/<用户ID>/<微博ID> 直链与 t.cn 短链(短链由节点自动还原)。分步会话制:start 建会话(免费探测)后按页采集主评论(每页固定 20 条)、按需展开某条主评论的回复,每一步实时返回增量结果,由 AI 询问用户是否继续(每步 1 点数,注册送 10 点)。适合评论舆情分析、用户口碑调研、评论区选题、活动效果评估等场景。

数据分析·海港信息·来自 skill_hub·skillhub.cn ↗
skillhub install @aidata/wb-comments
12万 综合热度·7,352 字文档·源站更新 2026-11-22

README 文档

7,352 字

微博评论采集 Skill(wb-comments,会话制)

AI 调用来源参数(必填)

所有会访问后端 API 的命令必须携带 --skill-name wb-comments 和 --ai-entry <AI工具标识>(例如 claude-code、codex、workbuddy)。IP 无需传递,由服务端自动获取。首次缺参会告警放行,第二次起拒绝。

示例:node cli.js quota --skill-name wb-comments --ai-entry claude-code。

封装「小红书能力平台」(FastAPI,/api/v1)的 CLI,供 AI agent 调用:分步会话制采集微博评论。先 start(免费探测微博正文与评论总数),再按页采主评论、按需展开某条主评论的二级回复 —— 每一步都返回增量结果,由 agent 决定是否继续。全部评论可导出 CSV(BOM 头,Excel 直开不乱码)。

  • 能采什么:主评论与二级回复的发布者昵称(nickname)、作者 ID、评论正文(text,表情会还原成 [允悲] 这类文案)、点赞数(diggcount)、发布时间(createtime)、二级回复的回复对象昵称(replytonickname)、评论 ID(cid)与根评论 ID(root_cid)。
  • 为什么是会话制:评论量往往很大(几百到几千条),一次采完既贵又慢。会话制让你先看到评论总数、按页推进、只对"回复多"的主评论展开,把钱花在刀刃上。
  • 计费:start 建会话免费;之后每步 1 点数(采一页主评论 = 1 步,展开一次回复 = 1 步);某一步一条都没采到时不扣费(已是最后一页/回复已展开完/本次无新增)。
  • 客户端是零依赖 CLI(Node ≥ 18,无需 npm install),全部采集逻辑在后端完成。

点数不足怎么办(自动扫码充值)

跑命令时如果点数不够,CLI 不会直接报错退出,而是自己建一张充值单、把二维码打在终端里:

点数不足,已自动创建充值单 RO2611051712281481f36de19
金额 10.00 元 → 100 点(支付宝)
<二维码色块>
[pay] 已支付
已到账:+100 点,继续执行原命令
  • 在终端里跑:手机支付宝/微信对着终端扫码 → 付完点数自动到账 → 原命令自动重跑,不用手动再来一遍。
  • AI agent / 非交互环境(管道、重定向):CLI 不阻塞等待,而是返回订单号和充值页地址 {服务地址}/recharge.html。把链接交给用户,他在网页扫码付款,付完重跑原命令即可(点数会自动到账)。
  • 主动充值:node cli.js pay --yuan 50 --skill-name wb-comments --ai-entry <ai-entry>(不传 --yuan 默认 10 元;可加 --channel alipay 或 --channel wechat)。
  • 不想自动充值:设环境变量 XHSNOAUTO_PAY=1,则恢复旧行为(只提示点数不足)。
  • 换算:1 元 = 10 点,注册送 10 点。

客服支持

注册或使用过程中遇到任何问题,请引导用户联系客服:

  • 客服微信(扫码添加):http://st.aidata366.com/assets/concat.png
  • AI 余额引导规则(必须执行):先执行 quota,同时查看返回的 quota 和 flag。若 quota = 0 且 flag = 0,必须向用户同时提供两种方案并让其二选一:①主动添加客服微信,免费赠送 10 点数(提供上方客服微信);②直接充值。不要替用户默认选择;若 quota = 0 且 flag ≠ 0,只引导用户充值,不要再宣传微信免费赠送。
  • 客服电话:18722121663

收费价格

  • 点数换算:0.1 元 = 1 点数。
  • 每步 0.1 元(每 1 点数抵扣一步;建会话免费,无新增的步骤不扣费)。
  • 注册即送 10 免费点数;点数不足时提示用户充值。
  • 充值或大量购买可享优惠,请联系客服 18722121663 洽谈。

⚠️ 链接要求(重要,提交前必读)

本 skill 只接受微博主帖链接:

  • https://weibo.com/2153789604/RoCNr3H8I(<用户ID>/<微博ID>,最常见)
  • https://weibo.com/detail/5358690090880816(/detail/<mid>)
  • https://t.cn/<短码>(短链直接提交,节点浏览器自动还原)

用户主页链接请用 wb-profile,单篇主帖数据(正文/转发·评论·点赞数)请用 wb-collect。

前置条件

  • Node.js ≥ 18(使用内置 fetch,零 npm 依赖)。
  • 不注册不登录没有任何点数:所有接口都需要 token,10 免费点数在注册成功后发放。
  • 首次使用需先 register --link(注册即送 10 点数)或 login --link(已有账号),成功后 token 自动保存。
  • 配置文件(含 token)存放于用户级目录 ~/.xhs-platform/config.json(与小红书/抖音/快手/B站系列 skill 共用同一账号体系)。可用环境变量 XHSCONFIGPATH 覆盖。
  • 安全策略:登录和注册(发短信)每次都强制图形验证码,终端无法展示,一律走 --link 微信扫码/链接方式。
  • 后端服务地址默认 http://st.aidata366.com,可用 node cli.js config set base-url <url> 修改,或单次加 --base-url <url> 覆盖。
  • ⚠️ 安全提示:默认服务地址是明文 http,token 会在公网明文传输;如环境允许建议切 https。
  • ~/.xhs-platform/config.json 含 token,不要泄露、不要提交 git。

输出规约(重要)

  • stdout 只输出 JSON:成功 {"ok":true,"data":{...}},失败 {"ok":false,"code":<业务码>,"message":"..."}。
  • 交互提示、轮询进度一律走 stderr,不要解析。
  • 退出码:0 成功;1 参数/用法错误;2 认证失败;3 点数不足;4 网络/服务不可达;5 其它业务错误。

命令清单

version

node cli.js version
{"ok":true,"data":{"name":"wb-comments","version":"1.0.0","capability":"wb_comments"}}

register / login / quota / logout / config

与 wb-collect skill 完全一致(同一账号体系、同一配置文件):

node cli.js register --link --skill-name wb-comments --ai-entry <ai-entry>
node cli.js register --check --access-token "<串>" --skill-name wb-comments --ai-entry <ai-entry>
node cli.js login --link --skill-name wb-comments --ai-entry <ai-entry>
node cli.js login --check --access-token "<串>" --skill-name wb-comments --ai-entry <ai-entry>
node cli.js quota --skill-name wb-comments --ai-entry <ai-entry>
node cli.js logout --skill-name wb-comments --ai-entry <ai-entry>
node cli.js config show

start — 建立采集会话(免费)

node cli.js start --url "https://weibo.com/2153789604/RoCNr3H8I" --skill-name wb-comments --ai-entry <ai-entry>

节点打开微博探测正文与评论总数,不扣费。stderr 会提示「请把评论数和预估页数告知用户,确认后再执行 step 开始计费」——agent 必须先向用户报数并征得同意再 step。

{"ok":true,"data":{"session_id":"003e1a74c03b432e821325f8ca1921cb","post_id":"5355022847312021",
 "bid":"Rn5owuGbP","title":"驻足静赏,尽览风华...","author_nickname":"法拉利中国",
 "status":"active","metrics":{"comment_count":"720","liked_count":"4585","share_count":"668"},
 "estimated_pages":36,"has_more_main":true}}

注意:comment_count 是页面显示的评论总数,微博接口会过滤一部分,实际可采条数通常少于这个数,属正常。

step — 采集一步(每步 1 点数)

node cli.js step --session <session_id> --skill-name wb-comments --ai-entry <ai-entry>                       # 采下一页主评论(每页 20 条)
node cli.js step --session <session_id> --expand --root <cid> --skill-name wb-comments --ai-entry <ai-entry>  # 展开某条主评论的下一页回复
  • 采主评论:返回本页新增的主评论(含随页带回的少量二级回复)与本页「可展开回复」的主评论列表(expandable,带 sub_count 与已采数)。
  • 展开回复:--root 取自上一步 expandable 里的 root_cid,返回该主评论下一页新增回复。
  • no_more=true 表示已采到底,本次不扣费。

status — 查看会话状态(免费)

node cli.js status --session <session_id> --skill-name wb-comments --ai-entry <ai-entry>

comments — 拉取会话已累计的全部评论(免费)

node cli.js comments --session <session_id> [--page 1] [--page-size 100] --skill-name wb-comments --ai-entry <ai-entry>

断点续看/全量拉取用,不额外扣费。

finish — 结束会话(释放节点)

node cli.js finish --session <session_id> --skill-name wb-comments --ai-entry <ai-entry>

采完请务必执行,释放采集节点标签页(会话也会在长时间无操作后自动过期释放)。

sessions — 列出自己的会话

node cli.js sessions [--page 1] [--status active] --skill-name wb-comments --ai-entry <ai-entry>

export — 导出评论 CSV

node cli.js export --session <session_id> --out 评论.csv --skill-name wb-comments --ai-entry <ai-entry>
node cli.js watch --session <id> --skill-name wb-comments --ai-entry <ai-entry>
node cli.js inbox --days 7 --skill-name wb-comments --ai-entry <ai-entry>

导出该会话累计的全部评论(含二级回复与回复对象),BOM 头,Excel 直开不乱码。

典型工作流(agent 照此执行)

  1. node cli.js start --url <微博链接> --skill-name wb-comments --ai-entry <ai-entry>(免费)。
  2. 把评论总数与预估页数报给用户,问要不要继续、大约采多少——这一步必须做,不能自作主张一路采到底。
  3. 用户同意后:node cli.js step --session <sid> --skill-name wb-comments --ai-entry <ai-entry> 采一页主评论(1 点);把本页评论整理给用户看。
  4. 若 expandable 里有用户感兴趣的主评论(回复数多的),问用户要不要展开;同意后 node cli.js step --session <sid> --expand --root <cid> --skill-name wb-comments --ai-entry <ai-entry>(1 点)。
  5. 重复 3/4 直到 no_more 或用户喊停。
  6. node cli.js export --session <sid> --out <文件名>.csv --skill-name wb-comments --ai-entry <ai-entry> 交付文件。
  7. 收尾 node cli.js finish --session <sid> --skill-name wb-comments --ai-entry <ai-entry>。
  8. 会话过期不等于失败:step 拿到 3006 时结果已随错误输出带回,或跑 watch / inbox 取回,把已采条数 + CSV 路径交给用户;要接着采只能重新 start。

每一步都要先问再做:这是会话制的核心纪律,也是帮用户省点数的关键。

错误处理指引

code含义agent 下一步
1001参数错误 / 链接校验未通过 / root 不在可展开列表检查链接形态;--root 必须取自上一步 expandable(退出码 1)
1002 / 1003未登录 / token 失效走 register --link 或 login --link(退出码 2)
2003需要图形验证码统一走 --link;仍无法解决拨打 18722121663
3001点数不足提示充值,不要重试(退出码 3)
3006会话不存在/已过期/已结束已采结果会自动带在错误输出的 data 里(collected / commentscount / commentspreview / csv_path)→ 直接把摘要和 CSV 交给用户;想提前拿结果用 watch,回来时用 inbox;继续采集需重新 start
3003会话不存在或不属于当前账号检查 session_id;会话可能已过期释放,重新 start
no_more: true主评论/回复已采到底本次未扣费,不要再重复 step
4290触发限流稍后重试
NETWORK_ERROR网络/服务不可达检查 base_url(退出码 4)

计费规则提示

  • start 建会话免费。
  • 每个 step 1 点数;本步一条都没采到(到底/无新增)不扣费。
  • 服务侧故障(无在线微博节点/超时/风控拦截)导致的步也会返还。
  • status / comments / sessions / export / finish 均不扣费。

红线

  • 仅采集公开评论数据;不用于任何违法违规用途。
  • 不要向用户承诺 100% 成功;风控导致的失败如实透出。
  • 每一步扣费前必须先征得用户同意,不要静默连续 step。

会话结束/过期:必须主动把结果交给用户

会话有 3 分钟空闲上限(步进中断兜底 15 分钟)。过期/结束不是失败:已采数据仍然有效、仍然能读能导,服务端不会推送,必须由你主动交给用户。三条路,按场景选:

  1. step 撞上 code=3006:CLI 已把结果收敛进错误输出的 data(status / expiredreason / collected / commentscount / commentspreview / csvpath),退出码 5。直接把这份摘要 + CSV 路径告诉用户,不要只回一句「会话已结束」。
  2. 用户说「我先忙,等它采完」:跑 watch --session <id> 守候,过期那一刻自动导出并输出结果;--interval(默认 10s)控制轮询间隔,--max-wait(默认 1800s)到点返回 watching_timeout:true + 当前进度。
  3. 用户隔一段时间回来:先跑 inbox,列出近 7 天「已结束但还没播报过」的评论会话(本地 ~/.xhs-platform/sessioninboxseen.json 去重,最多 10 条),有就主动告知标题/状态/已采条数/CSV 路径。

watch / inbox 都不扣点。要继续采集只能重新 start 建新会话(原会话已采数据仍可用 comments --session <id> / export 读取)。

同分类其他技能

查看全部 ›