xiaohongshu-similar-account

小红书相似账号推荐

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️⃣ 暂不需要