xiaohongshu-top-account

小红书热门账号推荐

1. 简介

小红书账号榜单追踪分析工具 -- 基于红狐数据 API，提供小红书全品类 / 分品类账号每日 / 每周 / 每月的表现榜单查询，支持排名查询、赛道筛选、HTML 可视化报告下载与定时订阅推送。

适用对象：内容创作者、品牌方、MCN 机构、行业分析师。

---

2. 功能特性

核心功能：

• 排名查询 -- 查日榜、周榜、月榜 TOP50
• 赛道筛选 -- 按品类筛选（美妆、美食、旅行、母婴、健身等 25 个赛道）
• 报告下载 -- 生成 HTML 可视化报告，支持导出 PDF / 截图
• 定时订阅 -- 设置自动化定时推送

特色亮点：

• 日榜每日 19:00 更新，周榜每周一 15:00 更新，月榜每月 2 号 9:00 更新
• 自动解析用户自然语言输入（时间、周期、赛道），无需记忆命令格式
• 排名算法：根据总粉丝数、粉丝增量、点赞增量、收藏增量、分享增量、评论增量加权计算，满分 100 分
• 数据回退机制：部分分类返回空数据时自动回退最多 3 天
• HTML 报告账号名均可点击跳转小红书主页

---

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 标准库 urllib 发送请求即可。

---

4. 使用指南

基础使用

排名查询（推荐：自然语言模式）：

直接传入用户原始问题，脚本自动完成全部解析：

python scripts/fetch_rank.py --query "用户原始问题" --limit 20 --html

脚本自动解析逻辑：

• 时间判断与日期计算：

• 周期判断：自动从用户文本中识别日 / 周 / 月（无明确则默认日榜）
• 回溯范围校验：

• 赛道（type）匹配：支持模糊匹配，常用映射：

• 数据回退机制：部分分类（如体育锻炼）在某些日期可能返回空数据时，自动尝试前一个日期，最多回退 3 天。

严格输出顺序（必须按顺序执行）

第一步：内容输出 -- 调用 fetch_rank.py 查询并格式化输出榜单（Markdown 表格，最多 20 条）。

第二步：询问定时订阅 -- 输出完榜单后直接追加：

📬 订阅服务
1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名，订阅后定时推送给您？
2️⃣ 是否需要订阅具体赛道的账号表现？我们支持：综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼

用户回复 "需要订阅" 时，使用 calendar_create 工具创建日程。

第三步：交付 HTML 报告 -- 使用 deliver_attachments 交付脚本输出的 HTML 文件。

用户需要查看全部数据时：重新调用脚本获取完整 50 条数据，同时输出 Markdown 表格和交付 HTML 报告（两者缺一不可）。

输出格式

Markdown 表格模板：

📊 小红书{period_label} · {category_label}
数据日期：{date}
共 {total} 个账号上榜

💡 榜单说明：{period_update_time}更新昨日/上周/上月数据。

📐 排名算法：排名根据达人在小红书的**总粉丝数**、周期内的**粉丝增量**、**点赞增量**、**收藏增量**、**分享增量**以及**评论增量**加权计算所得，满分100分。

| 排名 | 账号名 | 综合评分 | 总粉丝数 | 新增笔记 | 新增粉丝 | 新增点赞 | 新增评论 | 新增收藏 | 新增分享 |
|:---:|--------|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|:-------:|
| 🥇 1 | 账号A · 赛道 | 96 | 254.06w | 7 | 6919 | 24.64w | 6.68w | 2.53w | 13.39w |
| 🥈 2 | 账号B · 赛道 | 89 | 113.55w | 1 | 1.91w | 7.90w | 4787 | 2.18w | 3.12w |
| 🥉 3 | 账号C · 赛道 | 87 | 439.14w | 2 | 5859 | 16.51w | 993 | 7688 | 687 |

统计概览：上榜账号 {total} · 最高互动 {max_interaction} · 总新增笔记 {total_notes}

高级使用

报告下载：查询时加 --html --limit 50 参数，脚本自动生成 HTML 报告。

定时订阅：

• 每日订阅：FREQ=DAILY;BYHOUR=8;BYMINUTE=0
• 每周订阅：FREQ=WEEKLY;BYDAY=MO;BYHOUR=8;BYMINUTE=0
• 每月订阅：FREQ=WEEKLY;BYDAY=MO;BYHOUR=8;BYMINUTE=0;INTERVAL=4

automation prompt：查询小红书最新{period}榜（综合全部）并推送给用户

常用指令速查

API 参数说明

• URL：POST https://redfox.hk/story/api/xhsData/query
• 成功码：code: 2000（非 0）
• 认证方式：X-API-KEY Header（从环境变量 REDFOX_API_KEY 获取）
• 请求参数：dateType（1=日榜, 2=周榜, 3=月榜）、rankDate（YYYY-MM-DD）、type（赛道名称）、source（固定为 "小红书指数榜"）
• 月榜日期参数必须使用每月 2 号（如 "2026-04-02"）

HTML 报告规范

表格列：排名 | 账号名 | 总粉丝数 | 新增笔记 | 新增粉丝 | 新增点赞 | 新增评论 | 新增收藏 | 新增分享

统计卡片：上榜账号、最高互动（点赞+评论+收藏+分享）、总新增笔记

---

5. 使用场景

1. 内容创作者找对标：输入 "小红书美妆日榜"，获取当日美妆赛道 TOP 账号，分析其内容策略和数据表现，找到可参考的对标方向。
2. 品牌方筛选投放达人：查询 "上周母婴周榜"，快速筛选高互动、高增长的母婴赛道达人，节省手动搜集数据的时间。
3. MCN 监控竞品动态：定期查询特定赛道榜单，追踪竞品账号的排名变化和增长趋势，及时调整运营策略。
4. 行业分析师产出报告：生成可视化 HTML 报告，一键导出 PDF，用于行业分析汇报或投资决策参考。

---

6. 项目架构

目录结构

xiaohongshu-top-account/
├── SKILL.md                          # 本文件
├── scripts/
│   ├── fetch_rank.py                 # 查询小红书榜单数据
│   └── generate_report.py            # 被 fetch_rank.py --html 调用生成 HTML
└── references/
    └── api_docs.md                   # API 详细参数说明

技术栈

核心模块说明

• fetch_rank.py：接收用户查询参数（--query 或 --category/--period/--date），自动解析时间、周期和赛道，调用红狐 API 获取榜单数据，支持 --html 参数生成 HTML 报告。
• generate_report.py：读取榜单数据生成 HTML 报告模板，包含排名表格、统计卡片、榜单说明和排名算法。

资源索引

---

7. 常见问答

安装

Q: 需要安装什么依赖？ A: 无需安装第三方依赖，使用 Python 标准库 urllib 即可。

Q: 如何配置 API Key？ A: 请前往 红狐hub 获取 API KEY，通过环境变量 REDFOX_API_KEY 配置。

使用

Q: 日榜什么时候更新？ A: 每日 19:00 更新。

Q: 支持哪些赛道？ A: 支持 25 个赛道，完整列表见 references/api_docs.md。

Q: 赛道关键词匹配不上怎么办？ A: 赛道关键词支持 LLM 语义模糊匹配，实在无法识别时降级为 "综合全部"。

Q: 查询不到数据怎么办？ A: 部分分类（如体育锻炼）可能返回空数据，脚本会自动回退日期最多 3 天。

故障排除

Q: 最高互动数据为 0？ A: 最高互动需要根据点赞 + 评论 + 收藏 + 分享计算，不能直接使用接口返回的 newInteraction 字段。

Q: HTML 报告生成失败？ A: 确保 workspace 有写权限，且数据文件路径正确。