ahang1598 小红书每日爆款笔记
简介
一句话定位：按关键词或赛道查询小红书当日互动暴涨 TOP50 爆款笔记，自动拆解标题、内容与趋势规律，帮创作者和运营快速抓住流量风口、落地下一篇选题。
通过简单的关键词查询，你可以：
- 分类查询当日热门笔记 ：按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记，快速掌握各赛道头部内容。
- 单日爆款笔记分析：查看单日互动增长最快、曝光飙升的笔记详情，分析其标题、封面、内容结构等爆款特征。
- 各领域当日趋势追踪：监测不同领域的实时热度变化，识别正在起量的内容方向，预判下一波流量风口。
- 创作灵感生成：基于当日爆款内容，提炼可复用的选题、话术与呈现形式，直接用于你的下一篇笔记策划。
适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。
功能特性
🎯 核心功能
- 🔥 单日爆发榜查询：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配
- 📊 智能规律分析：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告
- 📈 多维度数据展示：完整呈现互动数、点赞、评论、收藏、分享及新增数据
- 🔔 自动订阅推送：支持每日19:30固定时间推送最新榜单到消息栏
✨ 特色亮点
- 🏷️ 全分类覆盖：综合全部、化妆美容、时尚穿搭、美味佳肴等 25 个主流分类
- 🔍 智能分类匹配：输入「睫毛膏」→ 化妆美容，无需手动选类（对用户不展示匹配结果）
- ⏰ 灵活日期适配：支持指定日期；未指定时按 19:00 更新规则自动判断查询日
- 📄 双格式输出：Markdown 表格 + 按需生成 HTML 页面，自用与汇报均可
一键安装
前置条件
- Python 3.8 及以上
requests：pip install requests- 红狐Hub 账号与 API Key（格式
ak_xxxxxxxx，新用户注册赠免费积分）
安装方式
SkillHub / ClawHub（推荐）
WorkBuddy / 龙虾（本地技能）
- 将本技能目录放入 WorkBuddy 的
skills路径（如~/.workbuddy/skills/xiaohongshu-dailytop） - 在对话中通过技能名或描述触发（如「查小红书每日爆款笔记」「睫毛膏爆款」）
- 配置
REDFOX_API_KEY后重启终端，确保 Agent 与脚本均可读取
命令行独立使用
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官网 → 注册/登录 → 个人中心复制 Key。
macOS / Linux：
echo 'export REDFOX_API_KEY=<你的apikey>' >> ~/.zshrc
source ~/.zshrc
Windows（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 可能无法读取，需在命令中显式注入：
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。
使用场景
场景一：内容创作者找每日爆款灵感
角色：美妆 / 穿搭博主
需求：快速找到当日互动暴涨的对标笔记与标题套路
使用方式：
- 输入赛道关键词（如「化妆美容」「穿搭」）查询每日爆款笔记
- 阅读「爆款标题分析」「最高数据作品分析」提炼可复制结构
- 导出 HTML 为 PDF 留存参考
预期收益：缩短选题时间，提高笔记点击率与互动率
场景二：品牌运营追踪当日热点
角色：快消品牌小红书运营
需求：掌握当日各分类爆发内容，指导投放与种草方向
使用方式：
- 按品类关键词每日查询爆发榜 TOP20
- 对比互动、收藏、分享新增数据筛选高转化笔记
- 订阅每日 19:30 推送，持续跟踪赛道变化
预期收益：热点响应更及时，内容策略与平台节奏对齐
场景三：MCN 挖掘潜力笔记与账号
角色：MCN 内容星探
需求：发现低粉高互动的爆发笔记，评估签约价值
使用方式：
- 查看榜单中作者粉丝数与互动新增对比
- 结合「最高互动作品分析」判断账号成长潜力
- 使用 HTML 内链接跳转原文与作者主页二次核实
预期收益：降低漏检成本，提高达人挖掘效率
场景四：竞品与赛道日报复盘
角色：增长 / 数据分析
需求：为团队提供可存档的每日爆款数据包
使用方式：
- 指定日期拉取目标分类 TOP50（先 TOP20，再「查看更多」）
- 将 HTML 导出 PDF 纳入日报
- 基于「热门内容分析」归纳封面、选题、热点结合等共性
预期收益：数据口径统一，复盘与汇报材料一键生成
项目架构
目录结构
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 为准。
安全与许可
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，并完整遵循其中的触发规则、输出规范、操作步骤与注意事项。脚本路径相对于技能目录：scripts/xhs_daily_fetcher.py、scripts/gen_xhs_html.py。
执行任务时须严格遵循，包括但不限于：
- 禁止在用户未明确查询或未订阅时自动拉榜
- 必须按顺序输出：爆发榜 → 分析 → 功能服务询问
- 禁止折叠输出；禁止输出 CSV/JSON 等文件
- 表格与 HTML 数据源、顺序必须一致
- HTML 按需生成，文件名格式：小红书每日爆款笔记_{分类}_唯一时间戳.html
注意事项
- 数据时效：每日 19:00 更新；查询日期规则见核心流程
- 输出完整性：三部分缺一不可；功能服务询问须在每日分析之后立即原样输出
- 数据真实性：以脚本/API 返回为准，禁止幻觉补齐排名或互动数
- 合规：遵守平台与版权规范；订阅推送时间为每日 19:30