小红书账号诊断师

简介

面向小红书账号运营与内容创作的数据洞察 Skill：通过 API 获取账号全量数据，从账号定位、粉丝画像、选题体系、封面风格、爆文能力、互动规模、更新产能七维度输出诊断报告，并给出可落地的行动处方。

能做什么？

🔍 单账号诊断：输入小红书号，输出七维度评分报告 + 相似账号推荐 + HTML 可视化报告
📊 多账号对比：同时分析多个账号，输出横向对比总结 + 对比 HTML 报告
🔔 订阅推送：账号无数据时自动订阅，30 分钟后推送新报告
📈 商业价值评估：数据化呈现账号生命周期与变现潜力

适合谁用？

小红书创作者 —— 诊断账号健康度、找优化方向
品牌 / MCN —— 评估 KOL 投放价值、对标竞品账号
内容运营 —— 批量观察某一垂类的爆款账号特征

使用场景

| 用户可能会问 | Agent 行为概要 | | -------------------------------------------- | ----------------------------------------------------------------- | | 「分析小红书号 xxx」「帮我诊断一下这个账号」 | 识别小红书号 → 查询数据 → 输出诊断报告 → 展示相似账号 → 生成 HTML | | 「对比分析 ID1 和 ID2」 | 多账号查询 → 依次输出诊断报告 → 输出对比总结 → 生成对比 HTML | | 「回复序号 1」 | 获取该相似账号的 userId → 走完整诊断流程 | | 账号无数据回复「订阅」 | 创建日程任务 + 调用同步接口 → 30 分钟后自动推送 |

重要数据说明

数据时效性

分析基于近 30 天数据，确保数据时效性
脚本输出 JSON 格式，智能体负责内容解析与报告呈现

空值处理

数据字段为空时直接隐藏对应模块，不展示「暂无」
报告模板格式严格要求，见 report_template.md

边界情况

未查到账号：提示检查 ID，引导订阅数据采集
账号存在但无作品：引导订阅，30 分钟后推送
定时任务触发后：无论是否有作品都执行分析，works 为空时在报告开头说明

核心执行规则

输入识别：纯数字或字母数字组合 → 直接识别为小红书号调用接口；中文昵称 → 提示提供小红书号
格式一致性：诊断报告在对话中直接输出，严格按 report_template.md 格式，不得生成 md 文件
数据一致性：对话输出 = HTML 输出，两者必须使用完全相同的数据和文字
禁止虚构：所有分析内容必须基于接口返回数据 + WebSearch 结果，禁止编造
反空话规则：禁止出现「要做好定位」「要提升内容质量」等无具体动作、无数据支撑的表述

操作流程

详细执行逻辑见 workflow_guide.md。

标准流程（概览）

用户输入小红书号
    ↓
① 开场白引导 → ② 识别小红书号 → ③ 数据查询（query）
    ↓
④ 查询结果处理
    ├── 未查到账号 → 订阅流程 → 结束
    ├── 查到但无作品 → 订阅流程 / 仍然分析
    ├── 唯一账号 → 继续
    └── 多账号 → 对比流程
    ↓
⑤ 背景信息补全（WebSearch × 3）
    ↓
⑥ 对话中输出诊断报告（严格按 report_template.md 格式）
    ↓
⑦ 展示相似账号（直接展示，无需询问）
    ↓
⑧ 生成 HTML 报告并展示

执行命令索引

| 步骤 | 命令 | | ----------- | ------------------------------------------------------------------ | | 数据查询 | python scripts/xiaohongshu_analyzer.py query --user_ids "id" | | 同步作品 | python scripts/xiaohongshu_analyzer.py sync_notes --red_ids "id" | | 生成 HTML | python scripts/xiaohongshu_analyzer.py generate_html | | 多账号 HTML | python scripts/xiaohongshu_analyzer.py generate_multi_html |

项目架构

xiaohongshu-account-analyzer/
├── SKILL.md                              # 本技能文档
├── scripts/
│   └── xiaohongshu_analyzer.py           # 数据查询 / HTML 生成入口
├── references/
│   ├── workflow_guide.md                 # 执行逻辑与分支处理（必读）
│   ├── report_template.md                # 报告输出格式（生成报告前必读）
│   ├── scoring_rules.md                  # 七维度评分规则（必读）
│   ├── api_guide.md                      # 接口字段与基准参考数据
│   └── benchmark_data.md                # 基准值参考（可编辑）
└── assets/
    ├── report_template.html              # 单账号 HTML 模板
    ├── report_data_template.json         # 单账号数据模板
    ├── multi_report_template.html        # 多账号 HTML 模板
    └── multi_report_data_template.json   # 多账号数据模板

资源索引

| 类型 | 文件 | 何时读取 | | --------- | ------------------------------------------------------------------ | ---------------------- | | 脚本 | scripts/xiaohongshu_analyzer.py | 执行查询 / 生成报告时 | | 执行逻辑 | references/workflow_guide.md | 处理分支流程时（必读） | | 报告格式 | references/report_template.md | 生成报告前（必读） | | 评分规则 | references/scoring_rules.md | 理解评分体系时（必读） | | 接口字段 | references/api_guide.md | 理解接口返回数据时 | | 基准参考 | references/benchmark_data.md | 水平衡量对比参考时 | | HTML 模板 | assets/report_template.html | 生成 HTML 报告时 |

常见问答

Q1：用户只给了中文昵称，能分析吗？ A：不能。小红书号（纯数字或字母数字组合）和昵称是两回事，须提示用户提供小红书号。

Q2：账号没有作品数据怎么办？ A：引导用户选择订阅，30 分钟后系统自动重新查询并推送报告。

Q3：多账号对比有什么特殊要求？ A：核心差异、共同问题、发展建议均按账号分别展示，不要按维度横向列举。