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 文件。

高级使用

赛道映射示例：

账号等级映射示例：

标准赛道分类（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报告模板

技术栈

核心模块说明

• 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 接口，严禁任何联网搜索。