小红书相似账号推荐

任务目标

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

前置准备

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

鉴权

获取 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..."

操作步骤

步骤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：按标准模版输出结果

输出顺序：

开场白（只显示有数据的组）
同阶对标表格（有数据才展示）
高阶标杆表格（有数据才展示）
分析总结（有数据才展示）
订阅服务（必须输出，无论有无数据）
展示HTML文件（读取脚本输出的html_path并展示）

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

输出格式示例：

✨ 为你匹配到【可直接抄的同阶对标（10个）】和【可追赶的高阶标杆（10个）】的2组对标，可按需参考：
| 数据说明：数据获取时间为xxx，和实时数据存在差别。
👉 【可直接抄的同阶对标（10个）】（可直接复制玩法）

| 账号名 | 粉丝数 | 近30天互动数 | 推荐理由 |
| --- | --- | --- | --- |
| [账号名](账号链接) | 粉丝数 | 总互动数 | 推荐理由 |

👉 【可追赶的高阶标杆（10个）】（模式成熟可参考）

| 账号名 | 粉丝数 | 近30天互动数 | 推荐理由 |
| --- | --- | --- | --- |
| [账号名](账号链接) | 粉丝数 | 总互动数 | 推荐理由 |


📬 **订阅服务**
       1️⃣ 是否订阅"现查询条件"的对标账号推送，每日下午7点更新最新数据。你可选择推送频率和时间~
       2️⃣ 暂不需要

无数据情况：

✨ 暂未匹配到符合条件的对标账号，请尝试调整筛选条件。
| 数据说明：数据获取时间为入库时刻，和实时数据存在差别。

📬 **订阅服务**
       1️⃣ 是否订阅"现查询条件"的对标账号推送，每日下午7点更新最新数据。你可选择推送频率和时间~
       2️⃣ 暂不需要

数值格式化：< 10000 直接展示原值，>= 10000 格式化为 "X.Xw"

推荐理由：口语化描述，综合分析内容方向、更新频率、互动表现、爆文案例

步骤4：生成并展示HTML报告（必须执行）

账号推荐输出结束后，脚本会自动执行以下流程：

将所有数据存入临时JSON文件：./{账号名/对标账号}_{时间戳}.json
读取JSON文件数据生成HTML文件：./{账号名/对标账号}_{时间戳}.html
脚本输出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（调用API查询对标账号，支持赛道和账号等级映射，自动生成HTML报告）
资产：见 references/account_template.html（HTML报告模版）

注意事项

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

xiaohongshu-similar-account