xiaohongshu-top-account

小红书热门账号推荐

概述

本 Skill 基于 https://redfox.hk/story/api/xhsData/query 数据接口， 提供小红书全品类/分品类账号每日/每周/每月的表现榜单查询。支持三大核心能力：

1. 排名查询 — 查日榜、周榜、月榜 TOP50
2. 领域查询 — 按品类筛选（美妆、美食、旅行、母婴、健身/体育锻炼等）
3. 报告下载 — 生成 HTML 可视化报告，支持导出 PDF/截图
4. 定时订阅 — 设置自动化定时推送

---

鉴权

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

---

触发词与意图识别

用户意图	典型触发词	对应操作
排名查询	小红书日榜、周榜、月榜、TOP50、最夯账号、排行榜、最新推荐	调用 API 并格式化输出
领域查询	美妆类/美食类/旅行类/母婴类/健身类...小红书排名	调用 API 并按 category 筛选
报告下载	下载报告、导出榜单、生成报告	使用 --html 参数自动生成 HTML
定时订阅	订阅日榜/周榜/月榜、定时推送、每天发给我	创建 WorkBuddy Automation

---

执行流程

严格输出顺序（必须按顺序执行，不得跳过）

第一步：内容输出

1. 调用脚本查询榜单数据（默认只查20条）：

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

2. 按标准模板格式化输出榜单数据（Markdown 表格形式，最多20条）

第二步：询问定时订阅

• 输出完榜单数据后，直接追加以下询问（不等待用户回复）：

  📬 订阅服务
  1️⃣ 是否需要订阅每日/周/月的小红书账号最新排名，订阅后定时推送给您？
  

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

第三步：交付 HTML 报告

• 脚本已自动生成HTML文件，使用 deliver_attachments 工具交付脚本输出的 HTML 文件路径
• 追加以下内容：

  ⚡ 更多操作
  • 点击下方下载HTML报告文件，可在浏览器中打开查看，支持一键导出PDF/高清图片
  • 本次榜单完整共50条数据，是否需要查看全部？
  

用户表示需要查看全部数据时：

⚠️ 强制要求：必须同时输出 Markdown 表格和交付 HTML 报告，两者缺一不可。

1. 重新调用脚本获取完整50条数据：

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

2. 在对话中输出完整50条数据的 Markdown 表格（按标准模板格式）
3. 必须使用 deliver_attachments 交付 HTML 文件（关键步骤，不可遗漏），告知用户"以下是完整50条数据的 HTML 报告，可直接点击下载查看"

---

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

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

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

自动解析逻辑：

① 时间判断与日期计算

根据当前时间判断最新数据是否已更新：

榜单类型	更新时间	当前时间 < 更新时间	当前时间 >= 更新时间
日榜	每日 19:00	取前2天 (offset=2)	取前一天 (offset=1)
周榜	每周一 15:00	取前2周 (offset=2)	取前1周 (offset=1)
月榜	每月1日 上午9:00	取前2月 (offset=2)	取前1月 (offset=1)

日期计算公式：

• 日榜：date.today() - timedelta(days=offset)
• 周榜：date.today() - timedelta(weeks=offset) 后的最近周一
• 月榜：date.today() - timedelta(days=30*offset) 后的每月1日

更新规则（输出时告知用户）：

• 日榜：每日 19:00 更新
• 周榜：每周一 15:00 更新
• 月榜：每月 1日 9:00 更新

② 周期判断

自动从用户文本中识别日/周/月（无明确则默认日榜）：

• 含"周"/"周榜"→ week
• 含"月"/"月榜"→ month
• 其余默认 → day

③ 回溯范围校验

榜单类型	最大回溯	超范围处理
日榜	近7天	自动切换至最近可用日期
周榜	近3周	自动切换至最近可用日期
月榜	近3个月	自动切换至最近可用日期

超出范围时：-若用户查询当日及未来日期的榜单，在榜单说明输出中增加：「非常抱歉🙏，我们最新的是昨日/上周/上月的数据，将为您提供最接近您需求的昨日/上周/上月热榜。」 -若用户查询时间早于回溯日期，在榜单说明输出中增加回复：「非常抱歉🙏，目前榜单最多支持回溯「过去7天/过去3周/过去3月」，我将为您查询最接近您需求的时间范围~」

④ 赛道（type）匹配

支持模糊匹配，映射表见 references/api_docs.md。

常用映射：

用户说	映射到
健身、运动、瑜伽	体育锻炼
美妆、彩妆、护肤	化妆美容/个人护理
美食、探店、烹饪	美味佳肴
旅行、旅游	旅行度假
母婴、育儿	亲子育儿
穿搭、时尚	时尚穿搭

若无法匹配，输出综合全部，并告知用户无法识别的赛道类别。

⑤ 数据回退机制

重要：部分分类（如体育锻炼）在某些日期可能返回空数据。此时应：

1. 自动尝试前一个日期
2. 最多回退3天
3. 若仍无数据，告知用户该分类在该时间段暂无数据

---

流程二：报告下载

1. 查询时加 --html --limit 50 参数，脚本会自动生成HTML报告
2. 调用 deliver_attachments 交付 HTML 文件（账号名均可点击跳转小红书主页）

---

流程三：定时订阅

1. 询问订阅周期（每日 / 每周 / 每月）。
2. 使用 automation_update 创建自动化任务：
   • 每日订阅：FREQ=DAILY;BYHOUR=8;BYMINUTE=0
   • 每周订阅：FREQ=WEEKLY;BYDAY=MO;BYHOUR=8;BYMINUTE=0
   • 每月订阅：FREQ=WEEKLY;BYDAY=MO;BYHOUR=8;BYMINUTE=0;INTERVAL=4
3. automation prompt：查询小红书最新{period}榜（综合全部）并推送给用户

---

标准输出模板

必须按以下顺序输出，不得跳过任何步骤：

第一步：内容输出

📊 小红书{period_label} · {category_label}