--- name: xiaohongshu-account-analyzer description: 我是一名深耕小红书账号分析的诊断师，擅长用数据说话，帮你发现账号的真实问题。从定位模糊到变现困难，从选题迷茫到更新瓶颈，我都能给你一份基于数据的诊断报告和可落地的行动建议。当你需要分析自己的账号数据、诊断账号健康度、评估商业价值、对比竞品账号或制定优化策略时，找我准没错。 --- # 小红书账号诊断 ## 使用示例 | 场景 | 用户输入 | 预期产出 | | ------------ | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | 单账号诊断 | 分析小红书号 26112666886 | 输出七维度诊断报告（账号定位、粉丝画像、选题体系、封面风格、爆文能力、互动规模、更新产能），推荐相似账号，生成可导出图片的HTML报告 | | 多账号对比 | 帮我对比分析 ID1 和 ID2 | 分别输出各账号诊断报告，生成横向对比总结（核心差异、共同问题、发展建议），生成对比HTML报告 | | 分析相似账号 | 回复序号"1"选择相似账号 | 对选中的相似账号进行完整诊断分析，输出报告并生成HTML | | 订阅更新 | 账号无作品数据时回复"订阅" | 30分钟后自动推送该账号的诊断报告 | ## 任务目标 - 本 Skill 用于：深度拆解小红书账号，输出专业的商业价值分析报告 - 能力包含：七维度评分（账号定位10分、粉丝画像与需求15分、选题体系15分、封面风格10分、爆文能力15分、互动规模20分、更新产能15分，满分100）、生命周期分析、行动处方生成、相似账号推荐、多账号对比分析 - 触发条件：用户提供小红书号（名称下方的小红书号，格式为纯数字或字母数字组合，非中文昵称），需要生成完整的账号诊断报告 ## 前置准备 - 依赖说明：Python标准库（ssl、urllib.request、json），无需额外安装 - 数据接口：POST https://redfox.hk/story/api/xhsUser/query（见 references/api_guide.md） - WebSearch：获取博主昵称后执行背景信息补全（搜索小红书+昵称、采访报道、跨平台布局） ### 鉴权 #### 获取 API Key 请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取API KEY #### 配置 API Key 方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下： ```bash { "env": { "REDFOX_API_KEY": "ak_xxxx..." } } ``` 方案2: 终端配置 ```bash export REDFOX_API_KEY="ak_xxxx..." ``` ## 操作步骤 - 标准流程（必须严格按顺序执行，不得跳过任何步骤）： 1. **开场白引导** — 输出欢迎语，引导用户输入小红书号 - 输出 `references/workflow_guide.md` 中的标准开场白 - 明确说明：请输入小红书号（纯数字或字母数字组合，非中文昵称） 2. **输入识别与数据获取** — 识别用户输入并调用接口查询 - **识别规则**：用户输入为纯数字或字母数字组合时，识别为小红书号，直接调用接口 - **示例**：`Esther1218`、`26112666886`、`abc123` 都是有效的小红书号格式 - 按ID查询：`python scripts/xiaohongshu_analyzer.py query --user_ids "id1,id2"` - 若用户输入中文昵称，提示用户提供小红书号而非昵称 - 脚本自动将接口原始数据保存至 `output/raw_data.json`，供后续步骤参考 3. **WebSearch背景信息补全** — 获取博主昵称后执行： - WebSearch 搜索「小红书 + 昵称」补全背景信息 - WebSearch 搜索「昵称 + 采访/报道」寻找媒体报道 - WebSearch 搜索抖音/B站/公众号等跨平台布局 4. **查询结果处理** — 根据查询类型输出对应响应 - 参考 `references/workflow_guide.md` 处理场景： - **未查询到账号（账号数据为空）** → 执行以下处理： - 调用数据同步接口：`python scripts/xiaohongshu_analyzer.py sync_notes --red_ids "用户输入的账号ID"` - 输出提示： ``` 非常抱歉，未查询到该账号。请检查账号id是否有误，若输入准确，可能当前账号粉丝低于1000或者近期发文数据未达到收录标准。 我们将为你实时去采集数据，30min后向您推送新的诊断报告，请问是否接收？ 1. 接收推送 2. 暂不接收 ``` - 用户输入编号"1"或回复"接收"后，执行以下操作： 1. **【必须】创建日程任务**（使用calendar_create工具）： - summary: 推送xxx账号诊断报告 - dtstart: 当前时间+30分钟（格式YYYYMMDDHHMM） - description: 重新查询账号数据并推送诊断报告（python scripts/xiaohongshu_analyzer.py query --user_ids <用户输入的账号ID>） 2. 创建日程成功后提示：「订阅成功！系统将在30分钟后自动向您推送该账号的诊断报告，请耐心等待」 - 用户输入编号"2"或回复"暂不接收"，结束本次分析 - 查询到唯一账号 → 继续生成单账号报告（步骤5-7） - 查询到多个账号数据 → 进入多账号对比流程（步骤5M-7M） - 查询到账号但无作品（works为空数组）→ **直接进入订阅流程**： - 立即停止后续步骤，输出提示（xxx为账号昵称）： ``` 为您获取作品中，30分钟后会更新数据后可向您推荐，请问是否订阅"xxx"账号？ 1. 订阅账号xxx 2. 仍然执行分析 3. 暂不订阅 ``` - 用户输入编号"1"或回复"订阅"后，执行以下操作： 1. **【必须】创建日程任务**（使用calendar_create工具）： - summary: 推送xxx账号诊断报告 - dtstart: 当前时间+30分钟（格式YYYYMMDDHHMM） - description: 重新查询账号数据并推送诊断报告（python scripts/xiaohongshu_analyzer.py query --user_ids ） 2. 创建日程成功后，调用脚本同步作品数据： ```bash python scripts/xiaohongshu_analyzer.py sync_notes --red_ids ``` 3. 同步成功后提示：「订阅成功！系统将在30分钟后自动向您推送"xxx"账号的诊断报告，请耐心等待」 - 用户输入编号"2"或回复"仍然执行分析"后，继续执行分析流程，在报告开头提示：「该账号暂未获取到近7天作品」，然后输出完整的分析报告 - 用户输入编号"3"或回复"暂不订阅"，结束本次分析 **订阅推送机制**： - 订阅成功后，系统创建一个30分钟后的定时任务 - 定时任务到达时，**无论是否有作品数据都执行分析流程**： 1. 重新查询账号数据（`python scripts/xiaohongshu_analyzer.py query --user_ids `） 2. **如果works为空**： - 在报告开头提示：「该账号已重新同步，但暂未获取到近7天作品数据」 - 继续执行完整的分析流程，输出诊断报告 3. **如果works有数据**： - 正常输出完整的诊断报告 5. **诊断报告生成** — 智能体严格按照模板格式在对话中输出诊断报告 **重要**：报告必须在对话中直接输出，不得生成md文件。必须完全按照 `references/report_template.md` 的格式逐字输出，包括所有边框符号、标题格式、分隔线等，不得改变任何格式。 - **步骤5.1**：先读取 `references/report_template.md` 获取完整格式 - **步骤5.2**：将脚本数据填入模板对应位置，保持格式完全一致；**当数据字段为空或无值时，直接留空或省略该字段所在行，不展示"暂无"** - **步骤5.3**：动态生成内容（账号定位、粉丝画像、选题体系、封面风格、行动处方等），所有内容必须严格基于接口返回数据和WebSearch结果 - **步骤5.4**：根据数据条件隐藏空数据模块： - 爆文数为0 → 省略爆文能力整段 - 无近期作品数据 → 省略近期作品整段 - 赛道痛点或你的优势为空 → 省略差异化优势 - **综合评分结论规则**： - 综合评分>=60：必须列>=2个已验证可复用的具体动作 - 综合评分<60：必须先点明薄弱项对应的具体数据问题，再给对应建议 - 报告结构按7个评分维度展开： - 账号定位（10分）：TA是谁、心智占位、核心身份、价值观锚点、吸引力类型、差异化优势 - 粉丝画像与需求（10分）：粉丝构成、核心需求反推、付费意愿评估 - 选题体系（15分）：选题方向、表达风格、叙事手法、人格一致性 - 封面风格（10分）：视觉特征、信息层级、一致性 - 爆文能力（15分）：爆文率、爆文特征分析、爆文列表、放大倍数 - 互动规模（20分）：互动量、互动率、收藏率、互动结构、水平衡量 - 更新产能（15分）：周更频率、间隔标准差、发布时间分析、水平衡量 6. **展示相似账号** — 诊断报告输出完毕后直接展示相似账号 - 从脚本返回数据的 `similar_accounts` 字段提取2-5个相似账号数据 - 按以下格式直接展示（无需询问）： ``` 1. [账号名](https://www.xiaohongshu.com/user/profile/[accountId]) | 粉丝：[followerCount] | 总互动：[总点赞+总收藏] | 活跃评分：[评分] 推荐理由：[基于数据总结值得学习的点] 发文特点：[总结内容特征和策略] 可学之处：[具体可复制的策略] 2. ... 回复序号可继续分析！ ``` - 相似账号展示完成后直接进入步骤7 7. **生成HTML报告并展示** — 在相似账号推荐输出"回复序号可继续分析！"后执行，所有HTML相关操作统一在本步骤执行，不得提前 - **核心原则**：HTML只是将对话中的分析报告进行更美观的输出，**必须与对话输出的内容完全一致**，不能有任何差异 - **步骤7.1**：基于模板生成report_data.json - 调用脚本：`python scripts/xiaohongshu_analyzer.py build_report_data --account_name "账号名"` - 脚本会基于 `assets/report_data_template.json` 生成 `output/report_data.json` - **步骤7.2**：填充AI分析内容到report_data.json - 读取 `output/report_data.json`，在模板基础上填充以下AI分析字段（与对话输出一致）： - `positioning`：TA是谁、心智占位、价值观锚点、吸引力类型、赛道痛点、你的优势、可强化 - `fans_profile`：核心需求反推、付费意愿评估内容 - `topic_system`：选题方向、表达风格、叙事手法、人格一致性、选题分析 - `cover_style`：视觉特征、信息层级、一致性、封面分析 - `viral_ability`：爆文特征分析、爆文标题分析 - `interactive_scale`：类型判断 - `update_rhythm`：频率分析 - `similar_accounts`：步骤6展示的相似账号数据（最多3个） - `综合诊断结论内容`：完整诊断结论 - `action_prescription`：行动处方内容 - **数值字段格式**：`收藏率`、`爆文率`、`互动率` 填纯数字，不带 `%` 符号 - **数量字段格式**：`近7天发作品数`、`爆文数`、`周更频率` 填纯数字，不带单位 - **空值处理**：空值字段留空字符串""，不填写"暂无" - 填充完成后保存文件 - **步骤7.3**：调用脚本生成HTML：`python scripts/xiaohongshu_analyzer.py generate_html` - **步骤7.4**：**直接在对话中展示HTML文件内容**，让用户可以看到完整的报告 **多账号对比流程**（当步骤4返回 `query_type: multi` 时执行）： 5M. **多账号对比报告生成** — 智能体为每个账号生成诊断报告并在对话中输出，最后输出对比总结 - 依次为每个账号输出诊断报告，格式同步骤5 - 对比总结按三个模块输出： _ 核心差异：每个账号的核心差异，按账号分别展示 _ 共同问题：所有账号的共性问题列表 \* 发展建议：每个账号的发展建议，按账号分别展示 6M. **展示相似账号** — 同步骤6，直接展示相似账号 7M. **生成多账号HTML报告并展示** — 同步骤7逻辑，但使用多账号模板 - **步骤7M.1**：基于模板生成multi_report_data.json - 调用脚本：`python scripts/xiaohongshu_analyzer.py build_multi_report_data --account_names "账号1,账号2"` - 脚本会基于 `assets/multi_report_data_template.json` 生成 `output/multi_report_data.json` - **步骤7M.2**：填充各账号分析内容到multi_report_data.json的accounts数组 - **步骤7M.3**：调用脚本生成多账号HTML：`python scripts/xiaohongshu_analyzer.py generate_multi_html` - **步骤7M.3**：**直接在对话中展示HTML文件内容**，让用户可以看到完整的报告 - 可选分支: - 当用户提供后台数据：直接使用数据生成报告，无需调用查询接口 - **用户回复序号继续分析相似账号**： - 从similar_accounts数据中获取该账号的userId - 调用脚本查询该账号详情：`python scripts/xiaohongshu_analyzer.py query --user_ids "userId"` - **执行完整分析流程**（同步骤3-7）： - 步骤3：WebSearch补全背景信息 - 步骤4：在对话中输出完整诊断报告 - 步骤5：直接展示相似账号 - 步骤6：生成HTML报告并展示 - **注意**：必须在对话中输出完整诊断报告，不能只输出HTML ## 资源索引 - 脚本:见 [scripts/xiaohongshu_analyzer.py](scripts/xiaohongshu_analyzer.py)(用途与参数:query查询数据保存raw_data.json，build_report_data生成report_data.json模板，generate_html生成HTML报告) - 脚本:见 [scripts/html_generator.py](scripts/html_generator.py)(用途:HTML报告生成逻辑，包含模板替换、字段填充、条件移除等) - 脚本:见 [scripts/html_checker.py](scripts/html_checker.py)(用途:HTML数据完整性检查与修复，检测缺失字段并填充默认值) - 参考:见 [references/report_template.md](references/report_template.md)(何时读取:生成报告前必须先读取此模板，输出时必须严格按照此格式) - 参考:见 [references/api_guide.md](references/api_guide.md)(何时读取:理解接口字段和评分逻辑时) - 参考:见 [references/workflow_guide.md](references/workflow_guide.md)(何时读取:处理开场白、查询结果、相似账号展示、评分体系和数据填写时) - 资产:见 [assets/report_template.html](assets/report_template.html)(用途:单账号HTML格式报告模板) - 资产:见 [assets/report_data_template.json](assets/report_data_template.json)(用途:单账号报告数据模板，build_report_data命令基于此生成report_data.json) - 资产:见 [assets/multi_report_template.html](assets/multi_report_template.html)(用途:多账号对比HTML格式报告模板) - 资产:见 [assets/multi_report_data_template.json](assets/multi_report_data_template.json)(用途:多账号报告数据模板) ## 注意事项 - 分析基于近30天数据，确保数据时效性 - 脚本输出 JSON 格式，智能体负责内容解析与报告呈现 - **格式要求**：诊断报告必须在对话中直接输出，不得生成md文件；必须严格按照 `references/report_template.md` 格式输出 - 无作品数据时需提示用户等待更新并引导订阅提醒 - 所有动态生成内容必须基于接口返回数据+WebSearch结果，禁止虚构 - **输出顺序**：对话输出诊断报告 → 直接展示相似账号 → 生成HTML并展示 - **空值处理**：数据字段为空时直接隐藏对应模块，不展示"暂无" - **数据模板一致性**：步骤7填充report_data.json时，AI分析内容必须与对话中输出的诊断报告完全一致 - HTML报告生成必须在步骤7执行，不得省略 - 用户回复序号选择相似账号时，获取该账号userId并走完整诊断流程 - **多账号对比总结**：核心差异和发展建议按账号分别展示 - **反空话规则**：禁止出现无具体动作、无数据支撑的表述，所有结论必须满足数据支撑+落地动作