back
loading skill details...
小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。
---
name: xiaohongshu-dailytop
description: 小红书每日爆款笔记是追踪小红书各领域每日趋势，监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。最终基于当日爆款内容，提炼可复用的选题、话术与呈现形式，生成创作灵感。支持分类查询当日热门笔记，按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。
---
# 小红书每日爆款笔记
## 简介
**一句话定位**：按关键词或赛道查询小红书当日互动暴涨 TOP50 爆款笔记，自动拆解标题、内容与趋势规律，帮创作者和运营快速抓住流量风口、落地下一篇选题。
通过简单的关键词查询，你可以：
- **分类查询当日热门笔记** ：按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。
- **单日爆款笔记分析**：查看单日互动增长最快、曝光飙升的笔记详情，分析其标题、封面、内容结构等爆款特征。
- **各领域当日趋势追踪**：监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。
- **创作灵感生成**：基于当日爆款内容，提炼可复用的选题、话术与呈现形式，直接用于你的下一篇笔记策划。
适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。
---
## 功能特性
### 🎯 核心功能
- **🔥 单日爆发榜查询**：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配
- **📊 智能规律分析**：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告
- **📈 多维度数据展示**：完整呈现互动数、点赞、评论、收藏、分享及新增数据
- **🔔 自动订阅推送**：支持每日19:30固定时间推送最新榜单到消息栏
### ✨ 特色亮点
- **🏷️ 全分类覆盖**：综合全部、化妆美容、时尚穿搭、美味佳肴等 25 个主流分类
- **🔍 智能分类匹配**：输入「睫毛膏」→ 化妆美容，无需手动选类（对用户不展示匹配结果）
- **⏰ 灵活日期适配**：支持指定日期；未指定时按 19:00 更新规则自动判断查询日
- **📄 双格式输出**：Markdown 表格 + 按需生成 HTML 页面，自用与汇报均可
---
## 一键安装
### 前置条件
- Python 3.8 及以上
- `requests`：`pip install requests`
- [红狐Hub](https://redfox.hk/) 账号与 API Key（格式 `ak_xxxxxxxx`，新用户注册赠免费积分）
### 安装方式
#### SkillHub / ClawHub（推荐）
1. 前往 [SkillHub](https://skillhub.cn) 或 [ClawHub](https://clawhub.ai)
2. 搜索 **xiaohongshu-dailytop** 或 **小红书每日爆款笔记**
3. 按平台指引安装技能包
4. 在对话环境或本机配置 `REDFOX_API_KEY`（见下方）
#### WorkBuddy / 龙虾（本地技能）
1. 将本技能目录放入 WorkBuddy 的 `skills` 路径（如 `~/.workbuddy/skills/xiaohongshu-dailytop`）
2. 在对话中通过技能名或描述触发（如「查小红书每日爆款笔记」「睫毛膏爆款」）
3. 配置 `REDFOX_API_KEY` 后重启终端，确保 Agent 与脚本均可读取
#### 命令行独立使用
```bash
pip install requests
cd xiaohongshu-dailytop
# 步骤一：获取数据并写入缓存
python scripts/xhs_daily_fetcher.py --keyword "睫毛膏" --top_n 50 --output_json /tmp/xhs_daily_cache.json
# 步骤二：从缓存生成 HTML（跳过 API 调用）
python scripts/gen_xhs_html.py --keyword "睫毛膏" --top 20 --input_json /tmp/xhs_daily_cache.json
```
### 环境变量配置
| 变量名 | 必填 | 说明 |
| --- | --- | --- |
| `REDFOX_API_KEY` | 是 | 红狐 API 密钥，格式 `ak_xxxxxxxx` |
**获取 API Key**：访问 [红狐Hub官网](https://redfox.hk/) → [注册/登录](https://redfox.hk/login) → 个人中心复制 Key。
**macOS / Linux**：
```bash
echo 'export REDFOX_API_KEY=<你的apikey>' >> ~/.zshrc
source ~/.zshrc
```
**Windows**（PowerShell）：
```powershell
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<你的apikey>", "User")
```
验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows）。未生效请重启终端。
**Windows Git Bash 注意事项**：PowerShell 设置的用户级环境变量 Git Bash 可能无法读取，需在命令中显式注入：
```bash
export REDFOX_API_KEY="ak_xxx" && python scripts/xhs_daily_fetcher.py ...
```
---
## 使用指南
### 基础使用
#### 1. 发起查询
告诉助手关键词或领域（未指定分类则自动匹配，未指定日期则按 19:00 规则判断）：
> 用户：帮我查一下睫毛膏相关的爆款笔记
>
> 助手：依次输出每日爆款笔记 TOP20、每日爆款笔记分析、功能服务询问
#### 2. 查看更多
默认 TOP20；数据超过 20 条时可回复「查看更多」：
> 用户：查看更多
>
> 助手：展示 TOP21 至榜单末尾
#### 3. 生成 HTML 文件包
在功能服务询问后，回复"2"或"生成"：
> 用户：2
>
> 助手：生成小红书风格的 HTML 文件包，支持导出 PDF
#### 4. 订阅推送
在功能服务询问后，回复"1"或"订阅"：
> 用户：1
>
> 助手：已开通每日 19:30 推送小红书每日爆款笔记 TOP50
### 高级使用
#### 1. 指定日期查询
> 用户：查 2026-04-20 美妆类每日爆款笔记
#### 2. 泛查询热门内容
> 用户：最近小红书有什么热门内容
（未指定关键词时使用「综合全部」分类。）
#### 3. 指定分类查询
> 用户：查时尚穿搭分类昨天的爆发榜
#### 4. 取消订阅
> 用户：取消订阅
### 常用命令速查
| 命令 / 用户说法 | 功能 |
| --- | --- |
| `查[关键词]爆款` / `每日爆款笔记` | 按关键词查询当日爆发榜（默认 TOP20） |
| `查[日期] [分类/关键词]爆款` | 指定日期或分类查询 |
| `查看更多` | 展示 TOP21–末尾 |
| `1` / `订阅` | 开通每日 19:30 TOP50 推送 |
| `2` / `生成` | 生成小红书风格 HTML 文件包 |
| `python scripts/xhs_daily_fetcher.py --keyword "睫毛膏" --top_n 50 --output_json /tmp/cache.json` | 命令行拉取榜单数据并写入缓存 |
| `python scripts/gen_xhs_html.py --keyword "睫毛膏" --top 20 --input_json /tmp/cache.json` | 命令行从缓存生成 HTML（跳过 API） |
**Agent 执行说明**：完整输出顺序、表格格式、功能服务询问文案等硬性约束见 [references/core_workflow.md](references/core_workflow.md)。
---
## 使用场景
### 场景一：内容创作者找每日爆款灵感
**角色**：美妆 / 穿搭博主
**需求**：快速找到当日互动暴涨的对标笔记与标题套路
**使用方式**：
1. 输入赛道关键词（如「化妆美容」「穿搭」）查询每日爆款笔记
2. 阅读「爆款标题分析」「最高数据作品分析」提炼可复制结构
3. 导出 HTML 为 PDF 留存参考
**预期收益**：缩短选题时间，提高笔记点击率与互动率
---
### 场景二：品牌运营追踪当日热点
**角色**：快消品牌小红书运营
**需求**：掌握当日各分类爆发内容，指导投放与种草方向
**使用方式**：
1. 按品类关键词每日查询爆发榜 TOP20
2. 对比互动、收藏、分享新增数据筛选高转化笔记
3. 订阅每日 19:30 推送，持续跟踪赛道变化
**预期收益**：热点响应更及时，内容策略与平台节奏对齐
---
### 场景三：MCN 挖掘潜力笔记与账号
**角色**：MCN 内容星探
**需求**：发现低粉高互动的爆发笔记，评估签约价值
**使用方式**：
1. 查看榜单中作者粉丝数与互动新增对比
2. 结合「最高互动作品分析」判断账号成长潜力
3. 使用 HTML 内链接跳转原文与作者主页二次核实
**预期收益**：降低漏检成本，提高达人挖掘效率
---
### 场景四：竞品与赛道日报复盘
**角色**：增长 / 数据分析
**需求**：为团队提供可存档的每日爆款数据包
**使用方式**：
1. 指定日期拉取目标分类 TOP50（先 TOP20，再「查看更多」）
2. 将 HTML 导出 PDF 纳入日报
3. 基于「热门内容分析」归纳封面、选题、热点结合等共性
**预期收益**：数据口径统一，复盘与汇报材料一键生成
---
## 项目架构
### 目录结构
```
xiaohongshu-dailytop/
├── SKILL.md # 产品说明（本文档）
├── references/
│ └── core_workflow.md # Agent 执行流程、输出规范、分类与日期规则
└── scripts/
├── xhs_daily_fetcher.py # 调用 API 获取榜单数据
├── gen_xhs_html.py # 生成可视化 HTML 页面
└── xhs_weekly.html # HTML 模板资源
```
### 技术栈
| 项目 | 说明 |
| --- | --- |
| 运行环境 | Python 3.8+ |
| 核心依赖 | `requests` |
| 数据来源 | 红狐 API `getXhsCozeSkillDataOne` |
| 鉴权 | 请求头 `X-API-KEY` ← 环境变量 `REDFOX_API_KEY` |
| 部署方式 | SkillHub / ClawHub / WorkBuddy 本地技能 / 命令行 |
### 核心模块
| 模块 | 职责 |
| --- | --- |
| `xhs_daily_fetcher.py` | 关键词匹配分类、日期判断、调用 API、输出榜单数据；支持 `--output_json` 写入 JSON 缓存供 gen_html 复用 |
| `gen_xhs_html.py` | 优先从 `--input_json` 缓存读取数据生成 HTML（跳过 API 调用），缓存无效时回退到独立 API；支持 `--top 20/50` |
| `core_workflow.md` | 四段强制输出、表格/HTML 格式、订阅文案、分类列表、接口调用上限与数据复用规则 |
---
## 常见问答
### 安装相关问题
**Q1：提示未找到 `REDFOX_API_KEY` 怎么办？**
按 [一键安装](#一键安装) 注册 红狐Hub官网 并配置环境变量；配置后重启终端。若用户不会配置，Agent 应协助写入 `~/.zshrc` / `~/.bashrc` 或 Windows 用户级环境变量。
**Q2：如何验证 API Key 已生效？**
执行 `echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确认以 `ak_` 开头。
**Q3：支持哪些安装/调用方式？**
SkillHub、ClawHub、WorkBuddy 本地技能目录，或直接运行 `scripts/` 下 Python 脚本。
---
### 使用相关问题
**Q4：榜单数据每天何时更新？**
每日 **19:00** 更新**昨日**数据。当前时间 ≥ 19:00 查昨日；< 19:00 查前天（未指定日期时）。
**Q5：「每日爆款笔记」指标含义是什么？**
笔记发布后**第 3 天相对第 2 天**的互动增量由高到低排序的 TOP50，不是累计总榜。
**Q6：为什么只显示 20 条？**
首次默认 TOP20；返回超过 20 条时回复「查看更多」可加载剩余，HTML 同步扩展为全量。
**Q7：一次查询会输出哪些内容？**
固定三部分：每日爆款笔记 → 每日爆款笔记分析（3 模块）→ 功能服务询问。HTML 文件包按需生成。顺序与格式以 [core_workflow.md](references/core_workflow.md) 为准。
---
### 安全与许可
**Q8：API Key 如何保管？**
仅通过环境变量读取，勿提交至公开仓库或聊天记录。
**Q9：数据使用边界？**
榜单以 API/脚本成功返回为准；跳转原文须遵守小红书平台规则与版权要求，不对未验证数据做夸大承诺。
### 接口调用优化
**Q10：一次查询会调用几次 API？**
正常有数据场景仅 **1 次**（fetcher 获取数据并写入缓存，gen_html 从缓存读取跳过 API）。默认日期无数据时脚本内置回退一天，最多 2 次。Agent 禁止在脚本之外自行构造 API 请求。
**Q11：gen_html 能否跳过 API 直接使用缓存？**
可以。使用 `--input_json` 参数指定 fetcher 输出的 JSON 缓存文件，gen_html 将完全跳过 API 调用，即使没有 API Key 也能正常生成 HTML。
---
## 核心工作流程
完整执行规范（触发前提、输出、表格/HTML 模板、功能服务询问原文、分类匹配、日期规则、脚本参数）**必须先读取并遵循** [references/core_workflow.md](references/core_workflow.md)，并**完整遵循**其中的触发规则、输出规范、操作步骤与注意事项。脚本路径相对于技能目录：`scripts/xhs_daily_fetcher.py`、`scripts/gen_xhs_html.py`。
执行任务时须严格遵循，包括但不限于：
- 禁止在用户未明确查询或未订阅时自动拉榜
- 必须按顺序输出：爆发榜 → 分析 → 功能服务询问
- 禁止折叠输出；禁止输出 CSV/JSON 等文件
- 表格与 HTML 数据源、顺序必须一致
- HTML 按需生成，文件名格式：小红书每日爆款笔记_{分类}_唯一时间戳.html
## 注意事项
- **数据时效**：每日 19:00 更新；查询日期规则见核心流程
- **输出完整性**：三部分缺一不可；功能服务询问须在每日分析之后立即原样输出
- **数据真实性**：以脚本/API 返回为准，禁止幻觉补齐排名或互动数
- **合规**：遵守平台与版权规范；订阅推送时间为每日 19:30
don't have the plugin yet? install it then click "run inline in claude" again.