小红薯失效链接转有效
小红薯笔记链接批量转链工具。当用户提到小红书、转链、链接转换、xhslink,或要求把小红薯笔记链接(含短链)转换为携带xsec_token的且浏览器可以直接打开观看的新链接时使用本 skill。转链结果可直接用于「小红薯互动数采集」skill(xhs-dpt)。收费服务(1 条 = 1 点数,注册送 10 点)。
skillhub install @aidata/xiaohs-convert-pro
README 文档
9,048 字小红书转链 Skill(xhs-convert-url-pro)
AI 调用来源参数(必填)
所有会访问后端 API 的命令必须携带 --skill-name xhs-convert-url-pro 和 --ai-entry <AI工具标识>(例如 claude-code、codex、workbuddy)。IP 无需传递,由服务端自动获取。首次缺参会告警放行,第二次起拒绝。
示例:node cli.js quota --skill-name xhs-convert-url-pro --ai-entry claude-code。
封装「小红书转链服务」(FastAPI,/api/v1)的 CLI,供 AI agent 调用:提交小红书链接 → 轮询任务 → 拿到转链后的 newurl(携带 xsectoken,浏览器可直接打开)。
与「小红书互动数采集」skill(xhs-dpt)同框架、同凭证、同输出规约:两个 skill 共用 ~/.xhs-platform/config.json,登录一次两边通用,logout 会同时使两个 skill 失效。
点数不足怎么办(自动扫码充值)
跑命令时如果点数不够,CLI 不会直接报错退出,而是自己建一张充值单、把二维码打在终端里:
点数不足,已自动创建充值单 RO2611051712281481f36de19
金额 10.00 元 → 100 点(支付宝)
<二维码色块>
[pay] 已支付
已到账:+100 点,继续执行原命令
- 在终端里跑:手机支付宝/微信对着终端扫码 → 付完点数自动到账 → 原命令自动重跑,不用手动再来一遍。
- AI agent / 非交互环境(管道、重定向):CLI 不阻塞等待,而是返回订单号和充值页地址
{服务地址}/recharge.html。把链接交给用户,他在网页扫码付款,付完重跑原命令即可(点数会自动到账)。 - 主动充值:
node cli.js pay --yuan 50 --skill-name xhs-convert-url-pro --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.2 元(每 2 点数抵扣 1 条 URL 的转换;无效链接不扣费)。
- 注册即送 10 免费点数;点数不足时提示用户充值。
- 充值或大量购买可享优惠,请联系客服 18722121663 洽谈。
前置条件
- Node.js ≥ 18(使用内置 fetch,零 npm 依赖,无需
npm install)。 - 不注册不登录没有任何点数:所有接口都需要 token,10 免费点数在注册成功后发放到账号。
- 首次使用需先
register --link(注册即送 10 点数;用户手机微信扫码/点链接在网页完成,页面自带图形+短信验证码)或login --link(已有账号)。成功后 token 自动保存到配置文件,后续调用免输。 - 配置文件(含 token)存放于用户级目录
~/.xhs-platform/config.json(与采集 skillxhs-dpt共用)。可用环境变量XHSCONFIGPATH覆盖(测试隔离用)。没有 token 或 token 失效时执行login --link重新登录即可。 - 安全策略:登录和注册(发短信)每次都强制图形验证码,终端无法展示图形验证码,所以一律走
--link微信扫码/链接方式。 - 后端服务地址默认
http://st.aidata366.com,可用node cli.js config set base-url <url>修改,或单次调用加--base-url <url>覆盖。 - 环境变量:
XHSCONFIGPATH(配置路径)、XHSPLATFORMBASEURL(服务地址)、XHSPLATFORM_INSECURE=1(忽略 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
输出 skill 名、版本号、node 版本、配置文件路径。升级 skill 后建议先跑一次,确认版本号与预期一致。输出示例:
{"ok":true,"data":{"name":"xhs-convert-url-pro","version":"2.0.1","node_version":"v22.22.2","config_path":"C:\\Users\\<user>\\.xhs-platform\\config.json"}}
register — 注册(注册即送 10 点数)
node cli.js register --link --skill-name xhs-convert-url-pro --ai-entry <ai-entry> # 生成注册二维码/链接
node cli.js register --check --access-token "<上一步下发的串>" --skill-name xhs-convert-url-pro --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 自动保存(与采集 skill 通用),返回
quota_balance,继续之前被中断的操作。 LOGIN_PENDING:用户还没完成注册,提醒后再试。LOGIN_EXPIRED:会话过期(10 分钟)或已使用,重新执行register --link。
register --check 成功输出示例:
{"ok":true,"data":{"phone":"13800000000","quota_balance":10}}
login — 登录
node cli.js login --link --skill-name xhs-convert-url-pro --ai-entry <ai-entry> # 生成登录二维码/链接
node cli.js login --check --access-token "<上一步下发的串>" --skill-name xhs-convert-url-pro --ai-entry <ai-entry> # 用户完成后确认并保存 token
login --link 的 stdout 返回 qrurl / loginurl / access_token。agent 必须把登录引导原样发给用户(stderr 里也给出了同样的话术,可直接复制):
需要先登录。请用手机微信扫码或打开链接登录账号:
登录方式(二选一)
二维码图片:<qr_url>
登录链接:<login_url>
access_token(登录后校验用):<access_token>
微信扫码/登录完成后告诉我一声,我会执行校验并保存凭证,然后继续之前的操作:
(注册/使用中如遇问题,请拨打客服电话 18722121663)
用户说「登录完成」后,执行 login --check --access-token "<access_token>":
- 成功:token 自动保存(与采集 skill 通用),继续之前被中断的操作(如重新提交任务)。
LOGIN_PENDING:用户还没完成授权,提醒用户完成后再试。LOGIN_EXPIRED:会话过期(10 分钟)或已使用,重新执行login --link。
quota — 查询点数
node cli.js quota --skill-name xhs-convert-url-pro --ai-entry <ai-entry>
输出示例:
{"ok":true,"data":{"id":1,"phone":"13800000000","nickname":"","quota":10,"role":"user","last_login_at":"","created_at":"2026-01-01T00:00:00"}}
logout — 登出(切换账号)
node cli.js logout --skill-name xhs-convert-url-pro --ai-entry <ai-entry>
服务端吊销当前 token 并清除本地保存的 token(采集 skill 同步失效)。之后可执行 login --link 登录其他账号。输出示例:
{"ok":true,"data":{"logged_out":true}}
submit — 提交转链任务
node cli.js submit --url "https://www.xiaohongshu.com/explore/6970ac3c000000000a03d7d5" --skill-name xhs-convert-url-pro --ai-entry <ai-entry> \
--url "http://xhslink.com/o/pl4tP4IXRa"
node cli.js submit --file urls.txt --skill-name xhs-convert-url-pro --ai-entry <ai-entry> # 每行一条 URL,忽略空行与 # 注释行
node cli.js submit --file urls.txt --wait --skill-name xhs-convert-url-pro --ai-entry <ai-entry> # 提交后轮询等待终态(推荐)
--url可重复;--file按行读取;二者可混合;总数 1~50 条。- 链接支持:
xiaohongshu.com/explore/<id>、/discovery/item/<id>、xhslink.com短链(服务端自动还原)。 - 每条自动生成递增 client_id(1, 2, 3...);幂等键按 URL 内容派生(sha256 截断),同一批 URL 重试/重复提交由服务端幂等返回原任务、不重复扣费,内容变化自动换键。唯一例外:因服务端登录态失效整单失败且已全额返还的任务,重提同批链接会被服务端清理旧任务并重新受理,不会被幂等键挡住。
输出示例(不带 --wait):
{"ok":true,"data":{"task_id":"t_20260917_a1b2c3","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 xhs-convert-url-pro --ai-entry <ai-entry> # 查一次
node cli.js query <task_id> --wait --skill-name xhs-convert-url-pro --ai-entry <ai-entry> # 轮询直到终态
node cli.js query <task_id> --wait --interval 3 --timeout 300 --skill-name xhs-convert-url-pro --ai-entry <ai-entry>
--interval轮询间隔秒数(默认 2),--timeout轮询总超时秒数(默认 120)。- 终态:
done(全部成功)/partial_failed(部分失败)/failed(全部失败)。轮询进度走 stderr,终态完整结果输出到 stdout。
终态输出示例:
{"ok":true,"data":{"task_id":"t_20260917_a1b2c3","status":"done","total":2,"valid_count":2,"invalid_count":0,"success_count":2,"fail_count":0,"charged_quota":2,"refunded_quota":0,"items":[{"id":1,"url":"https://www.xiaohongshu.com/explore/6970ac3c000000000a03d7d5","note_id":"6970ac3c000000000a03d7d5","new_url":"https://www.xiaohongshu.com/explore/6970ac3c000000000a03d7d5?xsec_token=AB...","status":"success","fail_reason":""}]}}
解读要点(agent 必读):
newurl是转换后的最终链接,已携带xsectoken参数,浏览器可直接打开。- 条目
status:"invalid"表示链接不合法(非笔记链接),不扣费,附fail_reason。 - 条目
status:"failed"表示转链失败,绝大多数情况是原笔记已被作者删除(或设为仅自己可见)。告知用户时统一说明:「该笔记已被删除,无法转链」,不要把技术性的failreason原样抛给用户。唯一例外:failreason含cookie_expired/ 登录态失效时是服务端临时故障(点数已自动返还),按错误处理指引告知用户稍后重试,不要说成笔记被删除。
config — 配置管理
node cli.js config set base-url http://127.0.0.1:8084
node cli.js config show # token 脱敏显示
与采集 skill 的协同(推荐工作流)
用户要"转链 + 采集"时,两个 skill 配合使用:
- 用本 skill
submit --url <链接> ... --wait拿到带xsectoken的newurl列表。 - 把
newurl作为笔记链接传给采集 skillxhs-dpt:node cli.js submit --url <newurl> --wait --skill-name xhs-convert-url-pro --ai-entry <ai-entry>(采集 skill 要求链接必须带xsec_token,转链结果天然满足)。 - 两个 skill 凭证通用:任一 skill
register --link/login --link后,另一个无需再登录。
典型工作流(agent 照此执行)
node cli.js quota --skill-name xhs-convert-url-pro --ai-entry <ai-entry>— 确认剩余点数 ≥ 待提交有效 URL 数。node cli.js submit --url <url1> --url <url2> ... --wait --skill-name xhs-convert-url-pro --ai-entry <ai-entry>— 一步拿到终态结果(URL 较多时用--file)。- 解析 stdout JSON:遍历
data.items,把status==="success"的newurl按原顺序整理返回给用户;对failed的条目告知用户「该笔记已被删除,无法转链」(cookieexpired/登录态失效除外,按错误表处理);对invalid的条目附fail_reason说明链接不合法。
错误处理指引
| code | 含义 | agent 下一步 |
|---|---|---|
| 1001 | 参数错误 | 检查命令参数(退出码 1) |
| 1002 / 1003 | 未登录 / token 失效 | 未注册过走 register --link(送 10 点数),已有账号走 login --link;把引导话术发给用户,完成后 --check(退出码 2) |
| LOGIN_PENDING | 用户尚未完成注册/登录 | 提醒用户完成微信扫码/链接操作后重试 --check(退出码 2) |
| LOGIN_EXPIRED | 会话过期/已使用 | 重新执行 register --link 或 login --link(退出码 2) |
| 2001 | 短信验证码错误或过期 | 引导用户在扫码打开的网页里重新获取并填写验证码 |
| 2003 | 需要图形验证码 | 登录/发短信每次都强制图形验证码(网页端操作)——终端无法完成,统一走 register --link / login --link;仍无法解决拨打客服电话 18722121663 |
| 3001 | 点数不足 | 提示用户拨打客服电话 18722121663 充值,不要重试(退出码 3) |
| 3002 | 超单次批量上限 | 拆分为 ≤50 条/批重新提交 |
| 3003 | 任务不存在 | 检查 task_id 是否属于当前账号 |
条目 failreason 含 cookieexpired / 登录态失效 | 服务端蒲公英登录态临时失效 | 点数已按条自动返还(refunded_quota 体现);告知用户属服务端临时故障、稍后重新提交同一批链接即可自动重新受理,无需改动 URL |
| 4290 | 触发限流 | 稍等后重试(Retry-After) |
| TIMEOUT | 轮询超时 | 任务未结束,稍后 query <task_id> 再查(退出码 5) |
| NETWORK_ERROR | 网络/服务不可达 | 检查后端服务与 config show 的 base_url(退出码 4) |
计费规则提示
- 每条有效 URL 扣 2 点数(提交时预扣);无效链接(非笔记链接/格式错误)不扣费。
- 短链(xhslink)还原失败自动返还该条点数(
refunded_quota体现)。 - 转链服务登录态失效(服务侧临时故障)同样按条自动返还;由此整单失败且全额返还的任务,重提同一批链接会自动重新受理。
- 已进入转链服务后失败的条目(如笔记已删)不返还点数。
红线
- 仅处理公开小红书笔记链接的转换;不用于任何违法违规用途。
- 不要向用户承诺 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万