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 账号与 API Key（格式 ak_xxxxxxxx，新用户注册赠免费积分）

安装方式

SkillHub / ClawHub（推荐）

1. 前往 SkillHub 或 ClawHub
2. 搜索 xiaohongshu-dailytop 或 小红书每日爆款笔记
3. 按平台指引安装技能包
4. 在对话环境或本机配置 REDFOX_API_KEY（见下方）

WorkBuddy / 龙虾（本地技能）

1. 将本技能目录放入 WorkBuddy 的 skills 路径（如 ~/.workbuddy/skills/xiaohongshu-dailytop）
2. 在对话中通过技能名或描述触发（如「查小红书每日爆款笔记」「睫毛膏爆款」）
3. 配置 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。

---

使用场景

场景一：内容创作者找每日爆款灵感

角色：美妆 / 穿搭博主

需求：快速找到当日互动暴涨的对标笔记与标题套路

使用方式：

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 为准。

---

安全与许可

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