xiaohongshu-similar-account

---
name: xiaohongshu-similar-account
description: 小红书创作者对标账号匹配工具，输入小红书账号ID或赛道+粉丝数+账号等级，推荐可直接复制的同阶对标和可参考的高阶标杆；当用户需要小红书账号推荐、KOL对标、起号参考、账号投放选择时使用。⚠️ 严禁任何联网搜索。
---

# 小红书相似账号推荐

## 1. 简介

小红书创作者对标账号匹配工具 -- 输入小红书账号 ID 或 "赛道 + 粉丝数 + 账号等级"，智能推荐可直接复制的同阶对标（粉丝量接近）和可参考的高阶标杆（粉丝量 3-5 倍），帮助创作者快速找到起号参考与投放目标。

**适用对象**：小红书创作者、KOL 运营、品牌方、MCN 机构。

---

## 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中

```bash
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
```

方案2: 终端配置：export REDFOX_API_KEY="ak_xxxx..."

```bash
export REDFOX_API_KEY="ak_xxxx..."
```

### 依赖安装

无需安装第三方依赖，使用 Python 标准库（json、argparse、os、sys、urllib、ssl）即可。

---

## 4. 使用指南

### 基础使用

**输入方式 A：按小红书账号 ID 查询**：

用户输入示例："我的ID是27493135897"

```bash
python scripts/xiaohongshu_account_recommender.py --red_id "27493135897"
```

**输入方式 B：按赛道 + 粉丝数 + 账号等级查询**：

用户输入示例："做饭，3000粉，素人"

```bash
python scripts/xiaohongshu_account_recommender.py --track "美味佳肴" --min_fans 0 --max_fans 3000 --level "素人"
```

### 操作流程（严格按顺序执行）

**步骤 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 并展示）

**有数据时的输出格式**：

```
✨ 为你匹配到【可直接抄的同阶对标（10个）】和【可追赶的高阶标杆（10个）】的2组对标，可按需参考：
| 数据说明：数据获取时间为xxx，和实时数据存在差别。

👉 【可直接抄的同阶对标（10个）】（可直接复制玩法）
| 账号名 | 粉丝数 | 近30天互动数 | 推荐理由 |
| --- | --- | --- | --- |
| [账号名](账号链接) | 粉丝数 | 总互动数 | 推荐理由 |

👉 【可追赶的高阶标杆（10个）】（模式成熟可参考）
| 账号名 | 粉丝数 | 近30天互动数 | 推荐理由 |
| --- | --- | --- | --- |
| [账号名](账号链接) | 粉丝数 | 总互动数 | 推荐理由 |

📬 **订阅服务**
       1️⃣ 是否订阅"现查询条件"的对标账号推送，每日下午7点更新最新数据。你可选择推送频率和时间~
       2️⃣ 暂不需要
```

**无数据时的输出格式**：

```
✨ 暂未匹配到符合条件的对标账号，请尝试调整筛选条件。
| 数据说明：数据获取时间为入库时刻，和实时数据存在差别。

📬 **订阅服务**
       1️⃣ 是否订阅"现查询条件"的对标账号推送，每日下午7点更新最新数据。你可选择推送频率和时间~
       2️⃣ 暂不需要
```

**步骤 4：生成并展示 HTML 报告（必须执行）**

账号推荐输出结束后，脚本自动：
1. 将所有数据存入临时 JSON 文件：`./{账号名/对标账号}_{时间戳}.json`
2. 读取 JSON 生成 HTML 文件：`./{账号名/对标账号}_{时间戳}.html`
3. 输出 JSON 标记：`{"status": "success", "html_path": "..."}`

AI 必须读取 `html_path` 并在对话结尾展示该 HTML 文件。

### 高级使用

**赛道映射示例**：

| 用户输入 | 匹配结果 |
| -------- | -------- |
| 美妆、化妆 | 化妆美容 |
| 护肤、美容 | 个人护理 |
| 穿搭、时尚 | 时尚穿搭 |
| 美食、做饭、探店 | 美味佳肴 |
| 旅行、旅游 | 旅行度假 |
| 家居、装修、改造 | 居家装修 |
| 健身、运动、减肥 | 体育锻炼 |
| 母婴、育儿 | 亲子育儿 |
| 宠物、猫、狗 | 宠物天地 |
| 数码、手机、科技、互联网、AI | 数码科技 |
| 教育、学习 | 学习教育 |
| 情感、恋爱 | 星座情感 |
| 职场、工作 | 职业发展 |

**账号等级映射示例**：

| 用户输入 | 匹配结果 |
| -------- | -------- |
| 明星、艺人、爱豆、idol | 明星 |
| 品牌、牌子 | 品牌 |
| 企业、公司、商家、官方号 | 企业 |
| 头部kol、头部、头部达人、大v、大号、百万粉 | 头部kol |
| 腰部kol、腰部、腰部达人、中号、十万粉 | 腰部kol |
| 尾部kol、尾部、尾部达人、小号、万粉 | 尾部kol |
| 素人、普通人、小白、新手、新人、个人号 | 素人 |

**标准赛道分类（25 个）**：

综合全部 | 出行代步 | 休闲爱好 | 影视娱乐 | 数码科技 | 医疗保健 | 综合杂项 | 星座情感 | 时尚穿搭 | 婚庆婚礼 | 拍摄记录 | 学习教育 | 化妆美容 | 居家装修 | 旅行度假 | 亲子育儿 | 个人护理 | 美味佳肴 | 职业发展 | 宠物天地 | 潮流鞋包 | 日常生活 | 科学探索 | 新闻资讯 | 体育锻炼

**标准账号等级（7 个）**：

明星 | 品牌 | 企业 | 头部kol | 腰部kol | 尾部kol | 素人

**数值格式化**：< 10000 直接展示原值，>= 10000 格式化为 "X.Xw"

**推荐理由**：口语化描述，综合分析内容方向、更新频率、互动表现、爆文案例

---

## 5. 使用场景

1. **新人起号找对标**：输入 "做饭，3000 粉，素人"，获取同阶对标注账号作为起号参考，直接复制已验证的玩法模式。
2. **创作者进阶找标杆**：输入自己的小红书 ID，获取高阶标杆推荐，找到 3-5 倍粉丝量的可追赶目标。
3. **品牌方筛选投放 KOL**：输入赛道 + 粉丝区间 + 账号等级，快速获取符合条件的达人列表，降低投放决策成本。
4. **MCN 批量挖掘潜力账号**：按不同赛道和粉丝量级批量查询，系统性地挖掘有潜力的签约对象。

---

## 6. 项目架构

### 目录结构

```
xiaohongshu-similar-account/
├── SKILL.md                                    # 本文件
├── scripts/
│   └── xiaohongshu_account_recommender.py      # 调用API查询对标账号，支持赛道和等级映射，自动生成HTML报告
└── references/
    └── account_template.html                   # HTML报告模板
```

### 技术栈

| 技术 | 用途 |
| ---- | ---- |
| Python 标准库 (urllib, json, ssl) | HTTP 请求与数据解析 |
| 红狐 API | 小红书相似账号数据来源 |
| HTML / CSS | 可视化对标报告渲染 |

### 核心模块说明

- **xiaohongshu_account_recommender.py**：支持按账号 ID 或赛道 + 粉丝数 + 等级两种方式调用红狐相似账号 API，自动处理赛道和等级映射，生成包含同阶对标和高阶标杆的 HTML 报告。

### 资源索引

| 文件 | 用途 |
| ---- | ---- |
| [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 接口，严禁任何联网搜索。