Agent Skill

视频号作品列表采集工具

视频号作品列表采集工具。当用户给出视频号 ID(`v2_...@finder`)或视频号昵称(首次会给昵称做一次 ID 解析),需要采集作品 ID(object_id) / export_id / 非ce_id / 类型(直播/视频/图片) / 标题 / 点赞(大拇指)/喜欢(小心心)/转发/评论数 / 发布时间 / 封面 / 时长 / 文件大小 / 电脑微信打开链接 / ,或提到"视频号作品/视频号数据/视频号列表"时使用本 skill。数据由服务端代理到上游取回,不需要浏览器、不需要登录微信。**3 点数/页**

数据分析·海港信息·来自 skill_hub·skillhub.cn ↗
skillhub install @aidata/wx-audio-list
8.6万 综合热度·4,708 字文档·源站更新 2026-11-22

README 文档

4,708 字

视频号作品列表 Skill(wx-video-list)

AI 调用来源参数(必填)

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

示例:node cli.js quota --skill-name wx-video-list --ai-entry claude-code。

封装「社媒采集平台」(FastAPI,/api/v1)的 CLI:提交视频号 ID 或昵称 → 服务端经上游代理分页取作品列表(每页 15 个)。

  • 能采什么:作品 ID(objectid)、exportid、非ce_id、类型(直播/视频/图片)、标题、点赞(大拇指)/喜欢(小心心)/转发/评论数、发布时间、封面、时长、文件大小、电脑微信打开链接、加密下载链接(有效期 1 天)。
  • 省心机制:服务端代理上游(不用开浏览器/插件),任务式提交 + 退差结算 + Agent 友好(stdout 纯 JSON + 统一退出码)。
  • 不支持:视频号主页分享链接(上游只认 v2_name 或昵称)

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

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

点数不足,已自动创建充值单 RO2611051712281481f36de19
金额 10.00 元 → 100 点(支付宝)
<二维码色块>
[pay] 已支付
已到账:+100 点,继续执行原命令
  • 在终端里跑:手机支付宝/微信对着终端扫码 → 付完点数自动到账 → 原命令自动重跑,不用手动再来一遍。
  • AI agent / 非交互环境(管道、重定向):CLI 不阻塞等待,而是返回订单号和充值页地址 {服务地址}/recharge.html。把链接交给用户,他在网页扫码付款,付完重跑原命令即可(点数会自动到账)。
  • 主动充值:node cli.js pay --yuan 50 --skill-name wx-video-list --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

收费价格

  • 3 点数/页
  • 注册即送 10 免费点数。
  • 充值或大量购买可享优惠,请联系客服 18722121663 洽谈。
  • 点数与人民币的兑换比例以平台充值页显示为准(默认 1 元 = 10 点);capability_prices 调价只影响新任务。

参数(提交前必读)

参数取值默认
--ref视频号 ID(v2_...@finder)或视频号昵称(首次会给昵称做一次 ID 解析)—
--file名单文件路径,每行一个(# 开头视为注释),可与 --ref 混用—
--pages采集页数 1~10(每条都按这个页数跑)1
--wait等待任务跑完再返回(默认超时 300s)关
--timeout等待秒数300
--force已失效(后端无去重,重提即新任务)关
  • 单次上限 3 条,超了直接报错(不扣费),请拆批。
  • 同一条内容重复出现在名单里会自动合并,只扣一次。

前置条件

  • Node.js ≥ 18(使用内置 fetch,零 npm 依赖)。
  • 首次使用先 register --link 或 login --link,成功后 token 自动保存。
  • 配置文件在 ~/.xhs-platform/config.json(与其它平台 skill 共用账号体系),可用 XHSCONFIGPATH 覆盖。
  • 后端地址默认 http://st.aidata366.com,可用 config set base-url <url> 或单次 --base-url 覆盖。
  • ⚠️ 安全提示:默认地址是明文 http,token 会明文传输;config.json 含 token,不要泄露、不要提交 git。

输出规约(重要)

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

命令清单

node cli.js version
node cli.js register --link --skill-name wx-video-list --ai-entry <ai-entry>
node cli.js register --check --access-token "<串>" --skill-name wx-video-list --ai-entry <ai-entry>
node cli.js login --link --skill-name wx-video-list --ai-entry <ai-entry>
node cli.js login --check --access-token "<串>" --skill-name wx-video-list --ai-entry <ai-entry>
node cli.js submit --ref <输入> --pages 2 --wait --skill-name wx-video-list --ai-entry <ai-entry>
node cli.js query <task_id> [--wait] --skill-name wx-video-list --ai-entry <ai-entry>
node cli.js export <task_id> --wait --out 结果.csv --skill-name wx-video-list --ai-entry <ai-entry>
node cli.js quota --skill-name wx-video-list --ai-entry <ai-entry>
node cli.js logout --skill-name wx-video-list --ai-entry <ai-entry>
node cli.js config show

支持的输入: v2_0600002310...@finder (视频号 ID,最准、最省钱) 美孚机油 (昵称;重名会给默认匹配,且首次多花一次解析额度) ✗ 视频号主页链接:上游不认分享链接,请换成 ID 或昵称。

submit

node cli.js submit --ref <输入> --pages 2 --wait --skill-name wx-video-list --ai-entry <ai-entry>

result 里字段含义:

字段含义
ref提交的原始标识
v2_name解析出的视频号 ID
nickname视频号昵称(上游回传时才有)
feeds_count作品总数
original_count原创作品数
requested_pages请求页数
collected_count实采作品数
collected_pages实采页数(= 结算页数)
settle_charged实收点数
refunded_diff差值返还点数
notes全部作品明细

export

node cli.js export <task_id> --wait --out 结果.csv --skill-name wx-video-list --ai-entry <ai-entry>

CSV 结构:前段是任务汇总(每条的状态/实采/实收/退差/失败原因),空一行后是明细宽表(v2name,pageno,objectid,exportid,objectnonceid,mediatype,title,favcount,likecount,forwardcount,commentcount,publishtime,coverurl,downloadurl,videoplaylen,filesize,openurl,rawjson,fetched_at)。BOM 头,Excel 直开不乱码。

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

  1. 判断用户给的是不是视频号 ID(v2_...@finder)或视频号昵称(首次会给昵称做一次 ID 解析);不是就说明不支持,别提交。
  2. node cli.js submit --ref <输入> --wait --skill-name wx-video-list --ai-entry <ai-entry>(多条就重复 --ref 或写 --file)。
  3. 读 result:collectedcount / settlecharged / refunded_diff 如实报给用户。
  4. 要文件时 node cli.js export <task_id> --wait --out <文件名>.csv --skill-name wx-video-list --ai-entry <ai-entry>。

错误处理指引

code / 现象含义agent 下一步
1001参数错误 / 输入不合法按提示修输入(退出码 1,未扣费)
1002 / 1003未登录 / token 失效走 register --link 或 login --link(退出码 2)
2003需要图形验证码统一走 --link
3001点数不足提示充值(退出码 3)
3005能力未启用联系客服
fail_kind=unavailable业务失败:内容删除 / 链接有误 / 查不到账号 / 零结果(无评论、无作品、搜不到)不返还(上游已按次收费),如实告知并建议换目标重试
fail_kind=service 或执行异常服务侧失败(上游 key 失效 / 上游余额不足 / 网络)全额返还,建议稍后重试
NETWORK_ERROR网络/服务不可达检查 base_url(退出码 4)

计费规则提示

  • 1 页 = 3 点数(≈0.30 元/页,按 1 元 = 10 点)。含首次昵称解析成本:用户只给昵称时,服务端先花一次上游调用换视频号 ID(同昵称之后走缓存、零成本)
  • 按实采页数退差
  • 零作品不返还(上游已按次收费)。

补充说明

  • 每页 15 个;正在直播时第一条是直播(media_type=直播)。
  • downloadurl 是加密链接、有效期 1 天,拿到就尽快用;decodekey 解密,不是给人看的直链。
  • 昵称解析结果会缓存到服务端,同一个昵称第二次跑不再多花成本。

红线

  • 只采公开作品;不要承诺能批量下载视频(加密链 1 天失效,且需解密)。
  • 不要向用户承诺 100% 成功;上游失败如实透出,不要编造数据。
  • 不要泄露服务端 token、上游 key 或平台内部配置。

同分类其他技能

查看全部 ›