| 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 获取API KEY
配置 API Key
方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
方案2: 终端配置：export REDFOX_API_KEY="ak_xxxx..."
export REDFOX_API_KEY="ak_xxxx..."
依赖安装
无需安装第三方依赖，使用 Python 标准库（json、argparse、os、sys、urllib、ssl）即可。
4. 使用指南
基础使用
输入方式 A：按小红书账号 ID 查询：
用户输入示例："我的ID是27493135897"
python scripts/xiaohongshu_account_recommender.py --red_id "27493135897"
输入方式 B：按赛道 + 粉丝数 + 账号等级查询：
用户输入示例："做饭，3000粉，素人"
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：按标准模板输出结果
输出顺序：
- 开场白（只显示有数据的组）
- 同阶对标表格（有数据才展示）
- 高阶标杆表格（有数据才展示）
- 分析总结（有数据才展示）
- 订阅服务（必须输出，无论有无数据）
- 展示 HTML 文件（读取脚本输出的 html_path 并展示）
有数据时的输出格式：
✨ 为你匹配到【可直接抄的同阶对标（10个）】和【可追赶的高阶标杆（10个）】的2组对标，可按需参考：
| 数据说明：数据获取时间为xxx，和实时数据存在差别。
👉 【可直接抄的同阶对标（10个）】（可直接复制玩法）
| 账号名 | 粉丝数 | 近30天互动数 | 推荐理由 |
| --- | --- | --- | --- |
| [账号名](账号链接) | 粉丝数 | 总互动数 | 推荐理由 |
👉 【可追赶的高阶标杆（10个）】（模式成熟可参考）
| 账号名 | 粉丝数 | 近30天互动数 | 推荐理由 |
| --- | --- | --- | --- |
| [账号名](账号链接) | 粉丝数 | 总互动数 | 推荐理由 |
📬 **订阅服务**
1️⃣ 是否订阅"现查询条件"的对标账号推送，每日下午7点更新最新数据。你可选择推送频率和时间~
2️⃣ 暂不需要
无数据时的输出格式：
✨ 暂未匹配到符合条件的对标账号，请尝试调整筛选条件。
| 数据说明：数据获取时间为入库时刻，和实时数据存在差别。
📬 **订阅服务**
1️⃣ 是否订阅"现查询条件"的对标账号推送，每日下午7点更新最新数据。你可选择推送频率和时间~
2️⃣ 暂不需要
步骤 4：生成并展示 HTML 报告（必须执行）
账号推荐输出结束后，脚本自动：
- 将所有数据存入临时 JSON 文件：
./{账号名/对标账号}_{时间戳}.json
- 读取 JSON 生成 HTML 文件：
./{账号名/对标账号}_{时间戳}.html
- 输出 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. 使用场景
- 新人起号找对标：输入 "做饭，3000 粉，素人"，获取同阶对标注账号作为起号参考，直接复制已验证的玩法模式。
- 创作者进阶找标杆：输入自己的小红书 ID，获取高阶标杆推荐，找到 3-5 倍粉丝量的可追赶目标。
- 品牌方筛选投放 KOL：输入赛道 + 粉丝区间 + 账号等级，快速获取符合条件的达人列表，降低投放决策成本。
- 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 报告。
资源索引
7. 常见问答
安装
Q: 需要安装什么依赖？
A: 无需安装第三方依赖，使用 Python 标准库即可。
Q: 如何配置 API Key？
A: 请前往 红狐hub 获取 API KEY，通过环境变量 REDFOX_API_KEY 配置。
使用
Q: 粉丝数怎么传？
A: 单个数值（如 "3000 粉"）：maxFans=该值, minFans=0；区间（如 "1000-3000 粉"）：按区间传参。
Q: 赛道匹配不上怎么办？
A: 支持智能语义模糊匹配，参考上方的赛道映射表。无法识别时会列出完整赛道列表供选择。
Q: 没有匹配到对标账号怎么办？
A: 系统会提示 "暂未匹配到符合条件的对标账号，请尝试调整筛选条件"，同时仍然会输出订阅服务入口。
故障排除
Q: 所有数据来源于哪里？
A: 所有数据来源于红狐 API 接口，严禁任何联网搜索。
