小红书相似账号推荐

任务目标

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

前置准备

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

鉴权

获取 API Key

1. 访问 RedFox 官网 了解服务详情
2. 前往 注册页面 注册账号
3. 新注册用户将获赠免费积分，可立即开始使用 API 服务
4. 注册登录后，在个人中心获取 API Key，格式为 ak_xxxxxxxx

配置 API Key

• REDFOX_API_KEY 从环境变量获取，格式 ak_xxxxxxxx
• 若未设置，提示用户自行配置：export REDFOX_API_KEY=\x3C你的apikey>；若用户不会配置，Agent应主动帮用户设置：
  • macOS/Linux：将 export REDFOX_API_KEY=\x3C值> 追加到 ~/.zshrc（zsh）或 ~/.bashrc（bash），然后 source 对应文件使其全局生效
  • Windows：使用 [Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "\x3C值>", "User") 设置用户级永久环境变量（需重启终端生效）
  • 配置完成后应验证：echo $REDFOX_API_KEY（macOS/Linux）或 echo %REDFOX_API_KEY%（Windows），确保换一个skill也能读取到

操作步骤

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

输出顺序：

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

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

输出格式示例：

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

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

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

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


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

无数据情况：

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

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

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

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

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

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

1. 将所有数据存入临时JSON文件：./{账号名/对标账号}_{时间戳}.json
2. 读取JSON文件数据生成HTML文件：./{账号名/对标账号}_{时间戳}.html
3. 脚本输出JSON标记：{"status": "success", "html_path": "..."}

AI必须执行：读取脚本输出的html_path路径对应的HTML文件，在对话结尾直接展示该HTML文件供用户预览。

标准赛道分类（25个）

综合全部 | 出行代步 | 休闲爱好 | 影视娱乐 | 数码科技 | 医疗保健 | 综合杂项 | 星座情感 | 时尚穿搭 | 婚庆婚礼 | 拍摄记录 | 学习教育 | 化妆美容 | 居家装修 | 旅行度假 | 亲子育儿 | 个人护理 | 美味佳肴 | 职业发展 | 宠物天地 | 潮流鞋包 | 日常生活 | 科学探索 | 新闻资讯 | 体育锻炼

标准账号等级（7个）

明星 | 品牌 | 企业 | 头部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接口，严禁联网搜索