小红书账号诊断

小红书账号深度诊断

任务目标

• 本 Skill 用于：深度拆解小红书账号，输出专业的商业价值分析报告
• 能力包含：七维度评分（账号定位10分、粉丝画像与需求15分、选题体系10分、封面风格10分、爆文能力20分、互动规模20分、更新产能15分，满分100）、行动处方生成、相似账号推荐、多账号对比分析
• 触发条件：用户提供小红书号（名称下方的小红书号，格式为纯数字或字母数字组合，非中文昵称），需要生成完整的账号诊断报告

使用示例

🔑 鉴权

获取 API Key

请前往 红狐hub 获取 API KEY。

配置 API Key

将 REDFOX_API_KEY 配置为环境变量：

export REDFOX_API_KEY="ak_xxxx..."

脚本通过 os.getenv('REDFOX_API_KEY') 读取密钥，缺失时报错退出并提供配置指引。请求头自动携带 X-API-KEY。

---

前置准备

• 数据接口：POST https://redfox.hk/story/api/xhsUser/query（详见 references/api_guide.md）
• WebSearch：获取博主昵称后执行背景信息补全
• 评分规则与数据填写规范：详见 references/workflow_guide.md

操作步骤

标准流程（单账号诊断）

步骤1：开场白引导

• 输出 references/workflow_guide.md 中的标准开场白
• 引导用户输入小红书号（纯数字或字母数字组合，非中文昵称）

步骤2：数据查询

• 识别用户输入：纯数字或字母数字组合识别为小红书号
• 调用脚本：python scripts/xiaohongshu_analyzer.py query --user_ids "小红书号"
• 脚本将原始数据保存至 output/raw_data.json
• 若用户输入中文昵称，提示用户提供小红书号

步骤3：WebSearch背景补全

• 搜索「小红书 + 昵称」补全背景信息
• 搜索「昵称 + 采访/报道」寻找媒体报道
• 搜索抖音/B站/公众号等跨平台布局

步骤4：查询结果处理

• 失败阈值（返回 query_type: "threshold_exceeded"）：

  当前小红书号已超过失败阈值，请联系客服邮箱redfoxdata@proton.me 或访问 https://redfox.hk/?source=clawhub处理-ClawHub
  

• 未查询到账号（账号数据为空）：

  未查询到相关账号：当前 Skill 仅收录热门账号。如需定制数据，可邮件联系[红狐数据](https://redfox.hk/?source=clawhub)咨询：redfoxdata@proton.me
  

• 查询成功 → 继续步骤5-7
• 多账号数据 → 转多账号对比流程

步骤5：诊断报告生成

• 读取 references/report_template.md 获取报告格式
• 读取 references/workflow_guide.md 获取评分规则和数据填写规范
• 将脚本数据填入模板，在对话中直接输出诊断报告（不生成md文件）
• 账号作品模块提示（必须输出）：在展示任何小红书作品链接之前，必须先输出：

  ！！！受小红书风控规则限制，部分作品链接可能无法正常跳转，您可复制对应作品标题前往小红书搜索查看，感谢理解🙇‍♀️🙇‍♀️
  

• 数据字段说明：gmtCreate 是红狐数据系统首次收录该账号的时间，不是小红书账号注册时间，严禁用于判断账号运营时长
• 综合评分结论规则：

  • =60分：列>=2个已验证可复用的具体动作

  • <60分：先点明薄弱项对应的数据问题，再给建议
• 空值处理：数据字段为空时直接隐藏对应模块，不展示"暂无"

步骤6：展示相似账号

• 从脚本返回数据的 similar_accounts 字段提取2-5个相似账号
• 按格式直接展示（无需询问），展示完成后进入步骤7

步骤7：生成HTML报告

• 步骤7.1：生成数据模板
  • python scripts/xiaohongshu_analyzer.py build_report_data --account_name "账号名"
• 步骤7.2：填充AI分析内容到 output/report_data.json（与对话输出完全一致）
  • 评分字段（各维度得分、综合评分）保留脚本计算的值，禁止覆盖
  • 数值字段填纯数字（不带%或单位）
  • 空值字段留空字符串""
• 步骤7.3：生成HTML
  • python scripts/xiaohongshu_analyzer.py generate_html
• 步骤7.4：在对话中展示HTML文件内容

多账号对比流程

• 步骤5M：为每个账号生成诊断报告（同步骤5），输出对比总结（核心差异、共同问题、发展建议）
• 步骤6M：展示相似账号（同步骤6）
• 步骤7M：生成多账号HTML报告
  • python scripts/xiaohongshu_analyzer.py build_multi_report_data --account_names "账号1,账号2"
  • 填充 output/multi_report_data.json
  • python scripts/xiaohongshu_analyzer.py generate_multi_html
  • 在对话中展示HTML文件内容

可选分支

• 用户提供后台数据：直接使用数据生成报告，跳过步骤2-3
• 用户回复序号继续分析相似账号：获取该账号小红书号，执行完整流程（步骤2-7）

资源索引

• 脚本: scripts/xiaohongshu_analyzer.py — query查询数据保存raw_data.json，build_report_data生成report_data.json模板，generate_html生成HTML报告
• 脚本: scripts/html_generator.py — HTML报告生成逻辑（模板替换、字段填充、条件移除）
• 脚本: scripts/html_checker.py — HTML数据完整性检查与修复
• 参考: references/report_template.md — 生成报告前必须先读取，输出时严格按照此格式
• 参考: references/api_guide.md — 理解接口字段时读取
• 参考: references/workflow_guide.md — 处理开场白、查询结果、相似账号展示、评分规则和数据填写规范时读取
• 参考: references/benchmark_data.md — 理解各账号层级基准数据和优秀值参考时读取
• 资产: assets/report_template.html — 单账号HTML格式报告模板
• 资产: assets/report_data_template.json — 单账号报告数据模板
• 资产: assets/multi_report_template.html — 多账号对比HTML格式报告模板
• 资产: assets/multi_report_data_template.json — 多账号报告数据模板

注意事项

• 诊断报告必须在对话中直接输出，不得生成md文件
• 所有动态生成内容必须基于接口返回数据+WebSearch结果，禁止虚构
• 输出顺序：对话输出诊断报告 → 展示相似账号 → 生成HTML并展示
• HTML报告内容必须与对话输出完全一致
• HTML报告生成必须在步骤7执行，不得省略
• 互动规模和更新产能基于获取到的作品日期差计算，非固定30天
• 爆文判断基于互动数（点赞+收藏），非仅点赞数
• gmtCreate 是红狐数据系统首次收录时间，不是账号注册时间