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 获取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：按标准模板输出结果

输出顺序：

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	调用 API 查询对标账号，支持赛道和账号等级映射，自动生成 HTML 报告
references/account_template.html	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 接口，严禁任何联网搜索。