xiaohongshu-similar-account · diff
git:20260527.20d0351 to git:20260602.08c4de8
160 added, 97 removed. Audit A to A.
---
name: xiaohongshu-similar-account
description: 小红书创作者对标账号匹配工具，输入小红书账号ID或赛道+粉丝数+账号等级，推荐可直接复制的同阶对标和可参考的高阶标杆；当用户需要小红书账号推荐、KOL对标、起号参考、账号投放选择时使用。⚠️ 严禁任何联网搜索。
---
# 小红书相似账号推荐
- ## 任务目标
+ ## 1. 简介
- - 本 Skill 用于：帮助小红书创作者找到可对标账号
- - 能力包含：同阶对标匹配（粉丝量接近）、高阶标杆推荐（粉丝量3-5倍）、账号数据分析
- - 触发条件：用户表达"找对标账号"、"推荐小红书账号"、"KOL投放"、"起号参考"等需求
+ 小红书创作者对标账号匹配工具 -- 输入小红书账号 ID 或 "赛道 + 粉丝数 + 账号等级"，智能推荐可直接复制的同阶对标（粉丝量接近）和可参考的高阶标杆（粉丝量 3-5 倍），帮助创作者快速找到起号参考与投放目标。
- ## 前置准备
+ **适用对象**：小红书创作者、KOL 运营、品牌方、MCN 机构。
- - 依赖说明：Python标准库（json、argparse、os、sys、urllib、ssl），无需额外安装
- - API说明：调用小红书账号推荐API，使用原生 urllib.request + ssl（verify=False）发起请求
+ ---
+ ## 2. 功能特性
+
+ **核心功能**：
+
+ - 同阶对标匹配 -- 按粉丝量级匹配相似账号，可直接复制玩法
+ - 高阶标杆推荐 -- 推荐粉丝量 3-5 倍的高阶账号，提供追赶方向
+ - 账号数据分析 -- 展示粉丝数、近 30 天互动数等关键指标
+ - HTML 报告生成 -- 自动生成可视化对标报告
+
+ **特色亮点**：
+
+ - 双模式输入：支持按账号 ID 精准查询，也支持按赛道 + 粉丝数 + 等级灵活筛选
+ - 智能赛道映射：支持口语化输入（如 "做饭" 自动映射为 "美味佳肴"）
+ - 25 个标准赛道 + 7 个标准账号等级，覆盖小红书全品类
+ - 粉丝数智能处理：单数值自动设 maxFans=该值 / minFans=0，区间按实际传参
+ - 订阅服务：支持按查询条件订阅每日对标账号推送
+
+ ---
+
+ ## 3. 一键安装
+
### 鉴权
#### 获取 API Key
请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取API KEY
#### 配置 API Key
- 方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：
+ 方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中
```bash
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
```
- 方案2: 终端配置
+ 方案2: 终端配置：export REDFOX_API_KEY="ak_xxxx..."
```bash
export REDFOX_API_KEY="ak_xxxx..."
```
- ## 操作步骤
+ ### 依赖安装
- ### 步骤1：接收用户输入，解析参数
+ 无需安装第三方依赖，使用 Python 标准库（json、argparse、os、sys、urllib、ssl）即可。
- **输入方式A：小红书账号ID**
+ ---
- - 用户输入示例："我的ID是27493135897"
- - 参数：redId
+ ## 4. 使用指南
- **输入方式B：赛道 + 粉丝数 + 账号等级（可选）**
+ ### 基础使用
- - 用户输入示例："做饭，3000粉，素人"
- - 参数映射：
- - track：赛道类型（自动映射，如"做饭"→"美味佳肴"）
- - maxFans/minFans：粉丝数处理规则见下方
- - level：账号等级（自动映射，如"小白"→"素人"）
+ **输入方式 A：按小红书账号 ID 查询**：
- **粉丝数处理规则（重要）**：
+ 用户输入示例："我的ID是27493135897"
- - 单个粉丝数（如"3000粉"）：maxFans=3000, minFans=**0**（不要传空字符串）
- - 粉丝区间（如"1000-3000粉"）：maxFans=3000, minFans=1000
- - 未指定粉丝数：maxFans和minFans都传空字符串
+ ```bash
+ python scripts/xiaohongshu_account_recommender.py --red_id "27493135897"
+ ```
- ### 步骤2：调用脚本查询对标账号
+ **输入方式 B：按赛道 + 粉丝数 + 账号等级查询**：
- ```
- # 按账号ID查询
- python scripts/xiaohongshu_account_recommender.py --red_id "27493135897"
+ 用户输入示例："做饭，3000粉，素人"
- # 按赛道+粉丝数+等级查询
+ ```bash
python scripts/xiaohongshu_account_recommender.py --track "美味佳肴" --min_fans 0 --max_fans 3000 --level "素人"
```
- API接口：POST https://redfox.hk/story/api/xhsUser/querySimilarAccounts
+ ### 操作流程（严格按顺序执行）
- ### 步骤3：按标准模版输出结果
+ **步骤 1：接收用户输入，解析参数**
- **输出顺序**：
+ - **输入方式 A**：小红书账号 ID，参数为 `redId`
+ - **输入方式 B**：赛道 + 粉丝数 + 账号等级（可选），参数映射：
+ - `track`：赛道类型（自动映射，如 "做饭" -> "美味佳肴"）
+ - `maxFans` / `minFans`：粉丝数处理规则见下方
+ - `level`：账号等级（自动映射，如 "小白" -> "素人"）
+ **粉丝数处理规则（重要）**：
+ - 单个粉丝数（如 "3000 粉"）：maxFans=3000, minFans=**0**（不要传空字符串）
+ - 粉丝区间（如 "1000-3000 粉"）：maxFans=3000, minFans=1000
+ - 未指定粉丝数：maxFans 和 minFans 都传空字符串
+
+ **步骤 2：调用脚本查询对标账号**
+
+ API 接口：`POST https://redfox.hk/story/api/xhsUser/querySimilarAccounts`
+
+ **步骤 3：按标准模板输出结果**
+
+ 输出顺序：
1. 开场白（只显示有数据的组）
2. 同阶对标表格（有数据才展示）
3. 高阶标杆表格（有数据才展示）
4. 分析总结（有数据才展示）
5. **订阅服务（必须输出，无论有无数据）**
- 6. 展示HTML文件（读取脚本输出的html_path并展示）
-
- **重要**：订阅服务是固定输出项，无论是否有对标账号数据，都必须输出订阅服务段落。
+ 6. 展示 HTML 文件（读取脚本输出的 html_path 并展示）
- **输出格式示例**：
+ **有数据时的输出格式**：
```
✨ 为你匹配到【可直接抄的同阶对标（10个）】和【可追赶的高阶标杆（10个）】的2组对标，可按需参考：
| 数据说明：数据获取时间为xxx，和实时数据存在差别。
- 👉 【可直接抄的同阶对标（10个）】（可直接复制玩法）
+ 👉 【可直接抄的同阶对标（10个）】（可直接复制玩法）
| 账号名 | 粉丝数 | 近30天互动数 | 推荐理由 |
| --- | --- | --- | --- |
| [账号名](账号链接) | 粉丝数 | 总互动数 | 推荐理由 |
👉 【可追赶的高阶标杆（10个）】（模式成熟可参考）
-
| 账号名 | 粉丝数 | 近30天互动数 | 推荐理由 |
| --- | --- | --- | --- |
| [账号名](账号链接) | 粉丝数 | 总互动数 | 推荐理由 |
-
📬 **订阅服务**
1️⃣ 是否订阅"现查询条件"的对标账号推送，每日下午7点更新最新数据。你可选择推送频率和时间~
2️⃣ 暂不需要
```
- **无数据情况**：
+ **无数据时的输出格式**：
```
✨ 暂未匹配到符合条件的对标账号，请尝试调整筛选条件。
| 数据说明：数据获取时间为入库时刻，和实时数据存在差别。
📬 **订阅服务**
1️⃣ 是否订阅"现查询条件"的对标账号推送，每日下午7点更新最新数据。你可选择推送频率和时间~
2️⃣ 暂不需要
```
- **数值格式化**：< 10000 直接展示原值，>= 10000 格式化为 "X.Xw"
+ **步骤 4：生成并展示 HTML 报告（必须执行）**
- **推荐理由**：口语化描述，综合分析内容方向、更新频率、互动表现、爆文案例
+ 账号推荐输出结束后，脚本自动：
+ 1. 将所有数据存入临时 JSON 文件：`./{账号名/对标账号}_{时间戳}.json`
+ 2. 读取 JSON 生成 HTML 文件：`./{账号名/对标账号}_{时间戳}.html`
+ 3. 输出 JSON 标记：`{"status": "success", "html_path": "..."}`
- ### 步骤4：生成并展示HTML报告（必须执行）
+ AI 必须读取 `html_path` 并在对话结尾展示该 HTML 文件。
- 账号推荐输出结束后，脚本会自动执行以下流程：
+ ### 高级使用
- 1. **将所有数据存入临时JSON文件**：`./{账号名/对标账号}_{时间戳}.json`
- 2. **读取JSON文件数据生成HTML文件**：`./{账号名/对标账号}_{时间戳}.html`
- 3. **脚本输出JSON标记**：`{"status": "success", "html_path": "..."}`
+ **赛道映射示例**：
- **AI必须执行**：读取脚本输出的`html_path`路径对应的HTML文件，在对话结尾直接展示该HTML文件供用户预览。
+ | 用户输入 | 匹配结果 |
+ | -------- | -------- |
+ | 美妆、化妆 | 化妆美容 |
+ | 护肤、美容 | 个人护理 |
+ | 穿搭、时尚 | 时尚穿搭 |
+ | 美食、做饭、探店 | 美味佳肴 |
+ | 旅行、旅游 | 旅行度假 |
+ | 家居、装修、改造 | 居家装修 |
+ | 健身、运动、减肥 | 体育锻炼 |
+ | 母婴、育儿 | 亲子育儿 |
+ | 宠物、猫、狗 | 宠物天地 |
+ | 数码、手机、科技、互联网、AI | 数码科技 |
+ | 教育、学习 | 学习教育 |
+ | 情感、恋爱 | 星座情感 |
+ | 职场、工作 | 职业发展 |
- ## 标准赛道分类（25个）
+ **账号等级映射示例**：
+ | 用户输入 | 匹配结果 |
+ | -------- | -------- |
+ | 明星、艺人、爱豆、idol | 明星 |
+ | 品牌、牌子 | 品牌 |
+ | 企业、公司、商家、官方号 | 企业 |
+ | 头部kol、头部、头部达人、大v、大号、百万粉 | 头部kol |
+ | 腰部kol、腰部、腰部达人、中号、十万粉 | 腰部kol |
+ | 尾部kol、尾部、尾部达人、小号、万粉 | 尾部kol |
+ | 素人、普通人、小白、新手、新人、个人号 | 素人 |
+
+ **标准赛道分类（25 个）**：
+
综合全部 | 出行代步 | 休闲爱好 | 影视娱乐 | 数码科技 | 医疗保健 | 综合杂项 | 星座情感 | 时尚穿搭 | 婚庆婚礼 | 拍摄记录 | 学习教育 | 化妆美容 | 居家装修 | 旅行度假 | 亲子育儿 | 个人护理 | 美味佳肴 | 职业发展 | 宠物天地 | 潮流鞋包 | 日常生活 | 科学探索 | 新闻资讯 | 体育锻炼
- ## 标准账号等级（7个）
+ **标准账号等级（7 个）**：
明星 | 品牌 | 企业 | 头部kol | 腰部kol | 尾部kol | 素人
- ## 赛道映射示例
+ **数值格式化**：< 10000 直接展示原值，>= 10000 格式化为 "X.Xw"
- | 用户输入 | 匹配结果 |
- | -------------------------------------------- | -------- |
- | 美妆、化妆 | 化妆美容 |
- | 护肤、美容 | 个人护理 |
- | 穿搭、时尚 | 时尚穿搭 |
- | 美食、做饭、探店 | 美味佳肴 |
- | 旅行、旅游 | 旅行度假 |
- | 家居、装修、改造 | 居家装修 |
- | 健身、运动、减肥 | 体育锻炼 |
- | 母婴、育儿 | 亲子育儿 |
- | 宠物、猫、狗 | 宠物天地 |
- | 数码、手机、科技、互联网、AI、人工智能、编程 | 数码科技 |
- | 教育、学习 | 学习教育 |
- | 情感、恋爱 | 星座情感 |
- | 职场、工作 | 职业发展 |
+ **推荐理由**：口语化描述，综合分析内容方向、更新频率、互动表现、爆文案例
- ## 账号等级映射示例
+ ---
- | 用户输入 | 匹配结果 |
- | ------------------------------------------------ | -------- |
- | 明星、艺人、爱豆、idol | 明星 |
- | 品牌、牌子 | 品牌 |
- | 企业、公司、商家、官方号 | 企业 |
- | 头部kol、头部、头部达人、大v、大号、百万粉 | 头部kol |
- | 腰部kol、腰部、腰部达人、中号、十万粉 | 腰部kol |
- | 尾部kol、尾部、尾部达人、小号、万粉 | 尾部kol |
- | 素人、普通人、小白、新手、新人、新手博主、个人号 | 素人 |
+ ## 5. 使用场景
- ## 使用示例
+ 1. **新人起号找对标**：输入 "做饭，3000 粉，素人"，获取同阶对标注账号作为起号参考，直接复制已验证的玩法模式。
+ 2. **创作者进阶找标杆**：输入自己的小红书 ID，获取高阶标杆推荐，找到 3-5 倍粉丝量的可追赶目标。
+ 3. **品牌方筛选投放 KOL**：输入赛道 + 粉丝区间 + 账号等级，快速获取符合条件的达人列表，降低投放决策成本。
+ 4. **MCN 批量挖掘潜力账号**：按不同赛道和粉丝量级批量查询，系统性地挖掘有潜力的签约对象。
- **示例1：按账号ID查询**
+ ---
- - 用户输入："我的ID是27493135897"
- - 脚本调用：`python scripts/xiaohongshu_account_recommender.py --red_id "27493135897"`
- - 输出格式：按标准模版输出
+ ## 6. 项目架构
- **示例2：按赛道+单个粉丝数+等级查询**
+ ### 目录结构
- - 用户输入："做饭，3000粉，素人"
- - 参数映射：track=美味佳肴, minFans=**0**, maxFans=3000, level=素人
- - 脚本调用：`python scripts/xiaohongshu_account_recommender.py --track "美味佳肴" --min_fans 0 --max_fans 3000 --level "素人"`
- - 输出格式：按标准模版输出（与示例1完全一致）
+ ```
+ xiaohongshu-similar-account/
+ ├── SKILL.md # 本文件
+ ├── scripts/
+ │ └── xiaohongshu_account_recommender.py # 调用API查询对标账号，支持赛道和等级映射，自动生成HTML报告
+ └── references/
+ └── account_template.html # HTML报告模板
+ ```
- **示例3：按赛道+粉丝区间+等级查询**
+ ### 技术栈
- - 用户输入："做饭，1000-3000粉，素人"
- - 参数映射：track=美味佳肴, minFans=1000, maxFans=3000, level=素人
- - 脚本调用：`python scripts/xiaohongshu_account_recommender.py --track "美味佳肴" --min_fans 1000 --max_fans 3000 --level "素人"`
- - 输出格式：按标准模版输出（与示例1完全一致）
+ | 技术 | 用途 |
+ | ---- | ---- |
+ | Python 标准库 (urllib, json, ssl) | HTTP 请求与数据解析 |
+ | 红狐 API | 小红书相似账号数据来源 |
+ | HTML / CSS | 可视化对标报告渲染 |
- ## 资源索引
+ ### 核心模块说明
- - 脚本：见 [scripts/xiaohongshu_account_recommender.py](scripts/xiaohongshu_account_recommender.py)（调用API查询对标账号，支持赛道和账号等级映射，自动生成HTML报告）
- - 资产：见 [references/account_template.html](references/account_template.html)（HTML报告模版）
+ - **xiaohongshu_account_recommender.py**：支持按账号 ID 或赛道 + 粉丝数 + 等级两种方式调用红狐相似账号 API，自动处理赛道和等级映射，生成包含同阶对标和高阶标杆的 HTML 报告。
- ## 注意事项
+ ### 资源索引
- - 粉丝数处理：单个数值→maxFans=该值, minFans=0；区间→按区间传参
- - 所有数据来源于API接口，严禁联网搜索
+ | 文件 | 用途 |
+ | ---- | ---- |
+ | [scripts/xiaohongshu_account_recommender.py](scripts/xiaohongshu_account_recommender.py) | 调用 API 查询对标账号，支持赛道和账号等级映射，自动生成 HTML 报告 |
+ | [references/account_template.html](references/account_template.html) | HTML 报告模板 |
+
+ ---
+
+ ## 7. 常见问答
+
+ ### 安装
+
+ **Q: 需要安装什么依赖？**
+ A: 无需安装第三方依赖，使用 Python 标准库即可。
+
+ **Q: 如何配置 API Key？**
+ A: 请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API KEY，通过环境变量 `REDFOX_API_KEY` 配置。
+
+ ### 使用
+
+ **Q: 粉丝数怎么传？**
+ A: 单个数值（如 "3000 粉"）：maxFans=该值, minFans=0；区间（如 "1000-3000 粉"）：按区间传参。
+
+ **Q: 赛道匹配不上怎么办？**
+ A: 支持智能语义模糊匹配，参考上方的赛道映射表。无法识别时会列出完整赛道列表供选择。
+
+ **Q: 没有匹配到对标账号怎么办？**
+ A: 系统会提示 "暂未匹配到符合条件的对标账号，请尝试调整筛选条件"，同时仍然会输出订阅服务入口。
+
+ ### 故障排除
+
+ **Q: 所有数据来源于哪里？**
+ A: 所有数据来源于红狐 API 接口，严禁任何联网搜索。