xiaohongshu-dailytop

---
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