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

# 小红书相似账号推荐

## 任务目标
- 本 Skill 用于：帮助小红书创作者找到可对标账号
- 能力包含：同阶对标匹配（粉丝量接近）、高阶标杆推荐（粉丝量3-5倍）、账号数据分析
- 触发条件：用户表达"找对标账号"、"推荐小红书账号"、"KOL投放"、"起号参考"等需求

## 前置准备
- 依赖说明：Python标准库（json、argparse、os、sys、urllib、ssl），无需额外安装
- API说明：调用小红书账号推荐API，使用原生 urllib.request + ssl（verify=False）发起请求

### 鉴权

#### 获取 API Key
1. 访问 [RedFox 官网](https://redfox.hk/) 了解服务详情
2. 前往 [注册页面](https://redfox.hk/login) 注册账号
3. **新注册用户将获赠免费积分**，可立即开始使用 API 服务
4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`

#### 配置 API Key
- `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`
- 若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若用户不会配置，Agent应主动帮用户设置：
  - **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效
  - **Windows**：使用 `[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User")` 设置用户级永久环境变量（需重启终端生效）
  - 配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个skill也能读取到

## 操作步骤

### 步骤1：接收用户输入，解析参数

**输入方式A：小红书账号ID**
- 用户输入示例："我的ID是27493135897"
- 参数：redId

**输入方式B：赛道 + 粉丝数 + 账号等级（可选）**
- 用户输入示例："做饭，3000粉，素人"
- 参数映射：
  - track：赛道类型（自动映射，如"做饭"→"美味佳肴"）
  - maxFans/minFans：粉丝数处理规则见下方
  - level：账号等级（自动映射，如"小白"→"素人"）

**粉丝数处理规则（重要）**：
- 单个粉丝数（如"3000粉"）：maxFans=3000, minFans=**0**（不要传空字符串）
- 粉丝区间（如"1000-3000粉"）：maxFans=3000, minFans=1000
- 未指定粉丝数：maxFans和minFans都传空字符串

### 步骤2：调用脚本查询对标账号

```
# 按账号ID查询
python scripts/xiaohongshu_account_recommender.py --red_id "27493135897"

# 按赛道+粉丝数+等级查询
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. 开场白（只显示有数据的组）
2. 同阶对标表格（有数据才展示）
3. 高阶标杆表格（有数据才展示）
4. 分析总结（有数据才展示）
5. **订阅服务（必须输出，无论有无数据）**
6. 展示HTML文件（读取脚本输出的html_path并展示）

**重要**：订阅服务是固定输出项，无论是否有对标账号数据，都必须输出订阅服务段落。

**输出格式示例**：

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

**AI必须执行**：读取脚本输出的`html_path`路径对应的HTML文件，在对话结尾直接展示该HTML文件供用户预览。

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

## 标准账号等级（7个）
明星 | 品牌 | 企业 | 头部kol | 腰部kol | 尾部kol | 素人

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

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

## 使用示例

**示例1：按账号ID查询**
- 用户输入："我的ID是27493135897"
- 脚本调用：`python scripts/xiaohongshu_account_recommender.py --red_id "27493135897"`
- 输出格式：按标准模版输出

**示例2：按赛道+单个粉丝数+等级查询**
- 用户输入："做饭，3000粉，素人"
- 参数映射：track=美味佳肴, minFans=**0**, maxFans=3000, level=素人
- 脚本调用：`python scripts/xiaohongshu_account_recommender.py --track "美味佳肴" --min_fans 0 --max_fans 3000 --level "素人"`
- 输出格式：按标准模版输出（与示例1完全一致）

**示例3：按赛道+粉丝区间+等级查询**
- 用户输入："做饭，1000-3000粉，素人"
- 参数映射：track=美味佳肴, minFans=1000, maxFans=3000, level=素人
- 脚本调用：`python scripts/xiaohongshu_account_recommender.py --track "美味佳肴" --min_fans 1000 --max_fans 3000 --level "素人"`
- 输出格式：按标准模版输出（与示例1完全一致）

## 资源索引
- 脚本：见 [scripts/xiaohongshu_account_recommender.py](scripts/xiaohongshu_account_recommender.py)（调用API查询对标账号，支持赛道和账号等级映射，自动生成HTML报告）
- 资产：见 [references/account_template.html](references/account_template.html)（HTML报告模版）

## 注意事项
- 粉丝数处理：单个数值→maxFans=该值, minFans=0；区间→按区间传参
- 所有数据来源于API接口，严禁联网搜索