Xhs Scan

xhs-scan · 小红书账号诊断

给一个小红书账号 ID 或主页链接 → 出一份可在线分享的诊断报告。

触发识别

用户消息里出现以下任意一种，即启用本 skill：

• 小红书主页链接：xiaohongshu.com/user/profile/...（带不带 xsec_token 都行）
• 24 位十六进制账号 ID，例如 6446318e000000001f0327f7
• 明确说"分析这个小红书账号""诊断一下这个号""出份报告"

不需要小红书 MCP，不需要扫码登录，纯公开页面抓取。

执行流程（4 步，全程自动）

设工作目录 WORK（建议 工作区/output/xhs_<账号名>_<日期>）。

第 1 步：抓数据

python <skill>/scripts/fetch_xhs.py "<ID或链接>" <WORK>

输出 <WORK>/account.json。脚本会打印账号昵称、粉丝数、笔记数、时间范围——先看一眼确认抓对了。

若输出 0 篇笔记或报错：可能是账号被封禁/隐藏笔记/触发风控。如实告知用户，不要编造数据。

第 2 步：生成报告

python <skill>/scripts/build_report.py <WORK>/account.json -o <WORK>/report.html

脚本会自动完成：量化统计 → 按阈值判定问题 → 生成 4 张自适应 SVG 图表 → 输出完整 HTML。 终端会打印判定出了几个问题，作为人工复核的抓手。

第 3 步：AI 润色（必须做，脚本做不了）

脚本产出的是数据准确的骨架，但有两处必须由你（AI）补全，否则报告质量不合格：

1. 「第二层」标题改写对照表 —— 脚本只列了原标题并标注"（待 AI 按公式改写）"。 你要逐条改写，公式：具体人群/场景 + 真实痛点 + 这篇能给出什么。 改写要点：
   • 删掉 emoji、‼️、。。。。，一条标题最多留 1 个符号
   • 补上用户真会搜的词（品类词 + 人群词 + 问题词）
   • 看完就知道这篇讲什么，不喊口号
2. 「第一层」和「第三层」的具体建议 —— 脚本用的是通用模板， 你要结合账号简介、品类、实际标题，把建议写具体（例如把"资质/检测实拍"替换成该账号真正拥有的背书）。

可选：若脚本判定不适用的问题（如账号本身很健康），删掉对应问题块，不要硬凑。

第 4 步：发布在线版

用户默认要"可在线读取、能分享"的版本，所以生成后主动发布：

1. 建发布目录 <WORK>/publish/，把 report.html 复制成 index.html
2. 清理预览器注入：本地预览后 HTML 会被塞入 data-page-node-id 属性（317 处左右）， 发布前必须清除，否则体积膨胀一倍：

   s = re.sub(r'\s+data-page-node-id="[^"]*"', '', s)
   

3. 校验内容完整性（问题块数、表格行数、SVG 数、关键文案是否都在）
4. 用 workbuddy_sites_deploy 发布，language: "static"， appName 填「<账号名>账号诊断报告」
5. 报告里给出分享链接 + 管理入口提示

发布前必须确认用户当轮有明确要求（"发布/上线/分享/在线"等）。若用户只说"生成报告"， 先本地交付并问一句要不要发布，不要擅自上线。

数据口径与限制（重要，别误读）

• 未登录状态下 noteId 为空、likedCount 多数为空字符串 —— 空字符串代表 0 赞，不是"没数据"
• 能看到部分笔记 likedCount 为 "1" 等非空值，说明是真实渲染值 → 点赞数据可信
• 拿不到：收藏数、评论数、阅读量、笔记正文、话题标签（需登录，见文末"补数据"）
• 只抓第一屏约 30 条。若 30 条全挤在最近几天 → 说明发布极密集，本身就是核心问题

自动判定规则（脚本内置，供人工复核）

硬性纪律

• 报告里涉及"删除/隐藏笔记"只能给建议，必须加粗提示"需你确认后再动手"，绝不代操作
• 报告末尾注明数据来源与统计口径
• 全程大白话：结论先行、数据说话、不用运营黑话，让普通人看得懂
• 不要为了凑数编造问题；数据好的账号要如实说"没大问题"，并给出进阶建议

补数据（可选）

需要收藏/评论/阅读量时，用 CDP 扫码登录方案（参考 references/login-cdp.md）。 需要用户配合扫码，等待上限约 3 分钟，超时就用现有数据出报告并说明口径。