微博互动数采集
微博主帖采集工具。当用户需要采集/查询某条微博的正文、作者、发布时间、转发数、评论数、点赞数,提交一批微博主帖链接一键批量采集、导出采集结果 CSV(Excel 直开),或提到"微博采集/主帖采集/微博正文/转发数/评论数/点赞数/社媒指数"时使用本 skill。适合微博投放结案、内容数据盘点、活动效果监测、爆款内容分析、达人微博分析等场景。支持 weibo.com/<用户ID>/<微博ID>、/detail/<mid> 直链与 t.cn 短链。收费服务(1 条微博 = 1 点数,注册送 10 点)。
skillhub install @aidata/wb-collect
README 文档
8,412 字微博主帖采集 Skill(wb-collect)
AI 调用来源参数(必填)
所有会访问后端 API 的命令必须携带 --skill-name wb-collect 和 --ai-entry <AI工具标识>(例如 claude-code、codex、workbuddy)。IP 无需传递,由服务端自动获取。首次缺参会告警放行,第二次起拒绝。
示例:node cli.js quota --skill-name wb-collect --ai-entry claude-code。
封装「小红书能力平台」(FastAPI,/api/v1)的 CLI,供 AI agent 调用:提交微博主帖链接 → 平台调度内网浏览器节点调用 /ajax/statuses/show?isGetLongText=true → 拿到该条微博的正文、作者、发布时间、转发 / 评论 / 点赞三项计数。批量采集,结果直接导出 CSV(BOM 头,Excel 直开不乱码)。
- 能采什么:正文(
title/text,长文直接拿全文,无需点「展开」)、作者昵称与 ID、发布时间(createtime)、转发数(sharecount)、评论数(commentcount)、点赞数(likecount)、微博 ID(post_id)与 bid、原帖链接。 - 适用场景:微博投放结案、内容数据盘点、活动效果监测、爆款内容分析、达人微博分析等。
- 省心机制:批量采(单次 1~50 条)、无效链接不扣费、服务侧失败按条自动返还点数(详见「计费规则提示」)、Agent 友好(stdout 纯 JSON + 统一退出码)。
- 不采集评论正文。需要评论内容请改用评论采集 skill
wb-comments(会话制,按步计费)。 - 客户端是零依赖 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-collect --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 点数抵扣 1 条微博的采集;无效链接不扣费)。
- 注册即送 10 免费点数(可采集 10 条微博);点数不足时提示用户充值。
- 充值或大量购买可享优惠,请联系客服 18722121663 洽谈。
⚠️ 链接要求(重要,提交前必读)
本 skill 只接受微博主帖链接,这是硬性要求(客户端提交前会做本地预检——域名白名单与路径格式检查,不通过直接报错、不扣费;服务端还会做更严格校验,未通过的条目判 invalid 不计费):
- 支持的链接形态:
https://weibo.com/2153789604/RoCNr3H8I(<用户ID>/<微博ID>,最常见)https://weibo.com/detail/5358690090880816(/detail/<mid>,mid 为纯数字微博 ID)https://weibo.com/status/5358690090880816(/status/<mid>)https://t.cn/<短码>(短链直接提交即可,采集节点浏览器打开后自动跳转还原,无需人工转换)
- 用户主页链接(
weibo.com/u/<用户ID>)不要提交本 skill:主页微博列表采集请用wb-profileskill;评论采集请用wb-commentsskill。传了主页链接会被识别并提示改用什么 skill,不会误扣费。 - 提交前逐条检查链接;批量场景中只要有一条不合规,本 skill 会拒绝整批提交并列出问题条目(不会部分扣费)。
agent 工作流提示:拿到用户给的链接后先判断形态;
t.cn短链直接提交即可,不要反复试错浪费轮次。带?xxx=查询串的直链同样支持。
前置条件
- Node.js ≥ 18(使用内置 fetch,零 npm 依赖)。
- 不注册不登录没有任何点数:所有接口都需要 token,10 免费点数在注册成功后发放到账号。
- 首次使用需先
register --link(注册即送 10 点数;用户手机微信扫码/点链接在网页完成,页面自带图形+短信验证码)或login --link(已有账号)。成功后 token 自动保存,后续调用免输。 - 配置文件(含 token)存放于用户级目录
~/.xhs-platform/config.json(升级/重装 skill 不丢配置;与小红书/抖音/快手/B站系列 skill 共用同一账号体系)。可用环境变量XHSCONFIGPATH覆盖(测试隔离用)。 - 安全策略:登录和注册(发短信)每次都强制图形验证码,终端无法展示,所以一律走
--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":"wb-collect","version":"1.0.0","capability":"wb_collect"}}
register — 注册(注册即送 10 点数)
方式一:扫码/链接注册(唯一方式,用户在手机上完成)
node cli.js register --link --skill-name wb-collect --ai-entry <ai-entry> # 生成注册二维码/链接
node cli.js register --check --access-token "<上一步下发的串>" --skill-name wb-collect --ai-entry <ai-entry> # 用户完成后确认并保存 token
register --link 的 stdout 返回 qrurl / registerurl / 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 wb-collect --ai-entry <ai-entry>
node cli.js login --check --access-token "<上一步下发的串>" --skill-name wb-collect --ai-entry <ai-entry>
引导话术同 register(把"注册"换成"登录")。成功后 token 自动保存。
quota — 查询点数
node cli.js quota --skill-name wb-collect --ai-entry <ai-entry>
{"ok":true,"data":{"quota":10,...}}
logout — 登出(切换账号)
node cli.js logout --skill-name wb-collect --ai-entry <ai-entry>
submit — 提交采集任务
node cli.js submit --url "https://weibo.com/2153789604/RoCNr3H8I" --skill-name wb-collect --ai-entry <ai-entry> \
--url "https://weibo.com/detail/5358690090880816"
node cli.js submit --file urls.txt --skill-name wb-collect --ai-entry <ai-entry> # 每行一条微博链接, 忽略空行与 # 注释行
node cli.js submit --file urls.txt --wait --skill-name wb-collect --ai-entry <ai-entry> # 提交后轮询等待终态(推荐)
node cli.js submit --url <链接> --force --skill-name wb-collect --ai-entry <ai-entry> # --force 已失效,直接重提即可
--url可重复;--file按行读取;二者可混合;总数 1~50 条。- 每条自动生成递增 client_id;幂等键按链接内容派生(仅审计留痕);每次提交都新建任务并扣点,要拿最新数据直接再提一次。
输出示例(不带 --wait):
{"ok":true,"data":{"task_id":"t_20261029_c6c377b1","total":2,"valid_count":2,"invalid_count":0,"charged":2,"quota_balance":8,"status":"pending"}}
带 --wait 时最终输出同 query 的完整结果。
query — 查询任务 / 拉取结果
node cli.js query <task_id> --skill-name wb-collect --ai-entry <ai-entry> # 查一次
node cli.js query <task_id> --wait --skill-name wb-collect --ai-entry <ai-entry> # 轮询直到终态
node cli.js query <task_id> --wait --interval 3 --timeout 300 --skill-name wb-collect --ai-entry <ai-entry>
--interval轮询间隔秒数(默认 2),--timeout总超时秒数。- 终态:
done(全部成功)/partial_failed(部分失败)/failed(全部失败)。
终态输出示例:
{"ok":true,"data":{"task_id":"t_20261029_08b4caae","status":"done","success_count":1,"fail_count":0,
"items":[{"id":1,"video_url":"https://weibo.com/2153789604/RoCNr3H8I","status":"success",
"result":{"post_id":"5358690090880816","bid":"RoCNr3H8I",
"title":"好不容易追回我老婆!竟然劝我离婚!",
"share_count":"94","comment_count":"279","like_count":"3450",
"create_time":"2026-10-27 17:53",
"url":"https://weibo.com/2153789604/RoCNr3H8I"}}]}}
解读要点(agent 必读):
- 三个计数是字符串;空串 = 该指标未采集到(页面未渲染/被拦截),不是 0——向用户解读时注意区分。
comment_count是页面显示的评论总数,与实际可采集到的条数常常不一致(微博接口会过滤),这是正常现象。- 失败条目的
fail_reason会透出具体原因(微博不存在/已删除/无权限查看等)。
export — 导出 CSV
node cli.js export <task_id> --wait --out out.csv --skill-name wb-collect --ai-entry <ai-entry>
生成两段式 CSV(BOM 头,Excel 直开不乱码):任务汇总 + 微博主帖明细(正文/三项计数/作者/时间)。适合把结果直接交给用户。
config — 配置管理
node cli.js config set base-url http://127.0.0.1:8084
node cli.js config show # token 脱敏显示
典型工作流(agent 照此执行)
- 检查每条链接形态(
<用户ID>/<微博ID>、/detail/<mid>直链或t.cn短链均可直接提交;主页链接引导改用wb-profile)。 node cli.js quota --skill-name wb-collect --ai-entry <ai-entry>— 确认剩余点数 ≥ 待采集条数。node cli.js submit --url <链接1> --url <链接2> ... --wait --skill-name wb-collect --ai-entry <ai-entry>— 一步拿到终态结果(条数多时用--file)。- 解析 stdout JSON:遍历
data.items,把status==="success"条目的result整理成表格返回给用户;failed/invalid条目附fail_reason说明。 - 用户要文件时:
node cli.js export <task_id> --wait --out 微博数据.csv --skill-name wb-collect --ai-entry <ai-entry>,把 CSV 路径交给用户。
错误处理指引
| code | 含义 | agent 下一步 |
|---|---|---|
| 1001 | 参数错误 / 链接校验未通过 | 消息里逐条列出问题链接:主页链接改用 wb-profile;非官方域名替换正确链接后重提(退出码 1) |
| 1002 / 1003 | 未登录 / token 失效 | 未注册走 register --link(送 10 点数),已有账号走 login --link;完成后 --check(退出码 2) |
| LOGINPENDING / LOGINEXPIRED | 用户未完成 / 会话过期 | 提醒用户完成扫码后重试 --check,或重新 --link(退出码 2) |
| 2003 | 需要图形验证码 | 终端无法完成,统一走 --link;仍无法解决拨打客服电话 18722121663 |
| 3001 | 点数不足 | 提示用户拨打客服电话 18722121663 充值,不要重试(退出码 3) |
| 3002 | 超单次批量上限 | 拆分为 ≤50 条/批重新提交 |
| 3003 / 3004 | 任务或导出不存在 | 检查 taskid / exportid 是否属于当前账号 |
条目 invalid | 链接不合法 | 按 fail_reason 提示 |
任务 partial_failed | 部分条目失败 | fail_reason 已透出;服务侧/风控原因失败的条目点数已自动返还,可稍后重提 |
| 4290 | 触发限流 | 稍等后重试(Retry-After) |
| TIMEOUT | 轮询超时 | 任务未结束,稍后 query <task_id> 再查(退出码 5) |
| NETWORK_ERROR | 网络/服务不可达 | 检查 config show 的 base_url(退出码 4) |
计费规则提示
- 提交时按有效微博条数预扣(1 条 = 1 点数);无效链接(非官方域名/格式错误)不扣费。
- 自动返还:服务侧故障(无在线微博节点/超时/风控拦截)等未采集到数据的条目,点数按条自动返还(
refunded_quota体现),可稍后重提。 - 不返还:微博不存在、已删除或无权限查看属业务性失败,不返还。
- 每次提交都是新任务并扣点:同一内容重提(无论带不带
--force)都会重新采集、重新计费。
红线
- 仅采集公开微博数据;不用于任何违法违规用途。
- 不要向用户承诺 100% 成功;风控导致的失败如实透出(fail_reason)。
同分类其他技能
查看全部 ›中国金融机构数据爬取与分析综合 Skill v12.1.0。2334家/43大类机构名单、60+财经媒体源舆情、 A股报告/公告/研报、
303 99.4万 MysteelAI - 智能问数我的钢铁网(Mysteel)大宗商品价格行情数据查询技能,基于钢联/隆众数据平台提供专业价格数据服务。覆盖黑色金属、有色金属、能源化工、
9 75万 smart-charts32种图表,3 个主题,2步生成: 1.上传数据 — 将 CSV / Excel / JSON 等格式的数据文件拖入对话框; 2.查看结
149 74.3万 论文配图一键生成论文配图一键生成:一条命令从 JSON/CSV/Excel 生成顶刊级学术图表,科研绘图 与期刊配图全场景覆盖。41 种图表(森林图/K
91 52.8万 smart-chartsIntelligent chart generation and data analysis skill. Reads user-sup
2 37.9万 股票/基金/期货量化分析工具全球智能投研工具(stock-researcher)v14.0:多源数据 + 概率预测 + 批量研究 + 可导出报告。 核心能力: -
152 26.5万