【小题XT】小红书失效链接修复
你的小红书链接打不开、只有一串 xhslink 短链,或者链接里缺了令牌——这个 Skill 批量把它们修复成笔记 ID 一致、带真实 xsec_token 的完整链接,按原顺序给你一张对照表。缺令牌、短链这类能修;笔记被删除、设私密或需要登录的,会如实告诉你修不了,不硬凑。
能帮你做什么
| 你的需求 | Skill 会做什么 |
|---|---|
| 链接失效、打不开 | 先读取笔记身份判断是哪类失效:缺令牌的补上真实 xsec_token,被删或私密的如实报失败 |
| 短链想还原成完整笔记链接 | 解析 xhslink.com/xhslink.cn 短链,读取笔记身份,返回带令牌的长链 |
| 一次要处理几十条链接 | 逐条修复、逐条校验,单条失败不中断整批,最后汇总成功数 |
| 链接混在分享文案里 | 先从文案中提取链接,去掉句末标点,再按同样流程处理 |
| 结果要贴进自己的表或程序 | 默认给 Markdown 对照表,也可以直接给 JSON |
你需要提供什么
只要链接本身,用自然语言或直接粘贴都行:
- 单个链接、一串链接、按行分隔的文本,或含链接的分享文案;
- 想要 JSON 输出就说一句"给我 JSON",否则默认表格。
完全相同的输入只处理一次;原始顺序会保留。没给链接时只问链接,不追问别的。
最后交付什么
一张对照表:序号、原链接、笔记 ID、新链接、状态。成功行的新链接完整可点击,失败行写明原因(比如"搜索未找回同 ID 笔记"),新链接位置留空。表格最后汇总"成功 X/共 Y 条"。要 JSON 就给同结构的 JSON,失败项同样保留,和输入一一对应。
只要修复结果就只给结果,不附赠选题、文案或其他内容。
可以直接这样用
- "这几条小红书链接打不开了,帮我修一下:<贴链接>"
- "这段分享文案里的链接帮我转成完整链接:<贴文案>"
- "这批裸链好像打不开,帮我批量补上 xsec_token,给我一张对照表。"
- "还是这批链接,结果给我 JSON,失败的也要列出来。"
- "上次转的链接又失效了,帮我重新取一下令牌。"
使用前需要准备
- 一个可用的小题
ai-tool-centerMCP,修复需要的两个数据工具都由它提供。 - 不需要你提供 Cookie、账号或 API Key 之外的任何东西;链接必须是真实存在的小红书笔记,用户主页、合集、搜索页和第三方跳转链接不作为笔记链接处理。
- 令牌有时效性:过段时间失效是正常现象,重新跑一次即可,不会拿旧结果充数。
执行顺序说明
以下介绍不改变执行顺序。开始执行本 Skill 的业务任务时,第一步始终检查小题 MCP。制作或修改 Skill 文件本身,不自动触发业务执行。
小题 XT MCP 强制前置闸门
本节优先于正文中任何旧版配置、手动兜底或"选择是否使用 MCP"的说明。加载本 Skill 后,第一步只检查当前 Agent 是否实际配置并可用名为 ai-tool-center 的 MCP;以当前 Agent 的 MCP 服务器列表、已注册工具列表或可用连接状态为准。
已检测到且可用时直接继续,不重复询问配置、不索取 API Key。未检测到、无法确认或连接失败时,只发送配置提醒并停止业务执行,不得先读取外部链接、调用平台数据、生成或分析媒体,也不得使用其他能力绕过闸门。
用户只说"已配置"、只提供 URL/API Key,或配置后尚未重启验证,均不算可用。用户明确不配置时,只有在其再次明确授权无 MCP 继续后,才可执行不依赖 MCP 的部分,并标记受影响能力,不得伪称 MCP 调用成功。
MCP 配置提醒
未检测到可用 MCP 时,发送:
> 当前未检测到可用的 ai-tool-center MCP。请到 https://xt.gbotai.cn 申请 API Key,并把 MCP 配置发给我,我会帮助你完成配置。发送前请把真实 API Key 替换成 <YOUR_API_KEY>,真实 Key 稍后在安全配置入口填写。
不要首次就堆出手动配置教程。用户没有模板或不懂配置时,提供以下模板并协助完成:
{
"mcpServers": {
"ai-tool-center": {
"url": "`https://middle-aitool.gbotai.cn/mcp`",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
Agent 协助配置流程
- 根据当前环境识别客户端及其配置入口;无法判断时,只问用户正在使用哪个应用。
- 检查脱敏配置,按客户端实际支持的格式准备配置,不猜路径,不覆盖其他 MCP 和已有设置。
- 用户请求协助配置后,在工具能力和授权范围内完成操作。真实 Key 通过安全输入框、密钥存储或客户端支持的安全方式填写,不索取聊天明文 Key,不回显到命令或日志。
- 无法直接操作时,针对当前客户端逐步引导,一次给一个明确步骤;让用户只完成 Agent 无法代办的部分。
- 保存后提示完全退出并重启 Agent,再检查实际工具或连接状态。配置文件已写入、Key 已填写、用户回复"已配置",都不能代替可用性验证。
配置期间只开展配置工作,业务任务等待闸门通过。真实 Key 不得写入 Skill、对话回复、日志或交付物。
MCP 错误提醒
按实际返回错误分流,不反复重试或猜测原因:
- Key 无效、未授权、认证失败:提醒用户到
https://xt.gbotai.cn重新申请 Key,更新配置并重启后重试。 - 钱包余额不足、额度不足等计费错误:提醒用户到
https://xt.gbotai.cn充值,确认余额恢复后重试。 - 其他错误:说明真实状态及受影响步骤,不一律归因于 Key 或余额。
处理完成前,对应能力标记为"待确认/不可用",不声称成功,不索取或展示真实 Key、钱包或支付信息。
Agent 执行规则
- 通过上面的 MCP 闸门,确认
ai-tool-center真实可用,且fetch_content_detail、xhs_keywordSearchWork两个工具都已注册;缺任何一个就说明缺失并停止,不得声称已完成修复。 - 收下用户给的链接或文案,只补链接本身这一个必要输入。
- 按详细流程逐条处理:提取校验 → 读取笔记身份 → 复用详情链接或搜索取令牌 → 输出前校验。
- 按约定格式输出对照表或 JSON,保留原始顺序和失败原因。
- 交付前核三件事:每个成功结果的笔记 ID 与平台数据一致、
xsec_token非空且来源真实、失败行原因写得具体。
详细规则在哪里
修复的完整流程、两个工具的调用参数、输出格式和"什么算验证通过"的表述边界,都在 references/converter.md。执行前按需读取,不凭印象猜参数。
核心红线先放在这里:xsec_token 只能来自输入链接、笔记详情或搜索结果,不得猜测、随机生成,也不得从其他笔记复制。没拿到真实令牌时,宁可报失败,也不把裸链包装成成功结果。