- name
- xhs-daily-ranking
- description
- 获取小红书平台单日爆发榜单数据，支持按分类查询当日热门笔记；当用户需要查询小红书当日热门内容、分析单日爆款笔记、了解各领域当日趋势或获取创作灵感时使用
小红书单日爆发榜
简介
小红书单日爆发榜是一款专为内容创作者和营销人员设计的智能工具，帮助用户实时追踪小红书平台当日的爆款笔记数据。
通过简单的关键词查询，你可以：
- 🔥 获取每日单日爆发榜TOP50，解决「不知道今天什么内容在爆」的痛点
- 📊 自动分析爆款特征和规律，解决「找爆文、拆规律效率低」的痛点
- 📁 生成可视化HTML页面，一键导出分享，大幅降低内容分析成本
- 🔔 支持每日固定时间订阅推送，不用手动重复查询
适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。
技术基础：基于小红书公开内容接口，每日19:00更新昨日榜单数据。
功能特性
🎯 核心功能
- 🔥 单日爆发榜查询：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配
- 📊 智能规律分析：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告
- 📈 多维度数据展示：完整呈现互动数、点赞、评论、收藏、分享及新增数据
- 🔔 自动订阅推送：支持每日19:30固定时间推送最新榜单到消息栏
✨ 特色亮点
- ⏰ 智能日期适配：支持指定日期或模糊日期查询，自动按规则匹配近2天数据
- 📤 多格式输出：自动生成Markdown表格+HTML可视化文件，支持导出PDF/图片
- 🔗 一键跳转：笔记和作者主页可直接点击跳转，查看原内容更便捷
- ⚡ 无额外门槛：无需小红书账号、无需API密钥，安装依赖即可使用
使用指南
基础使用（3步）
1. 发起查询
告诉工具你要查询的分类或关键词（未指定日期则自动按规则匹配近2天数据）：
用户：帮我查一下睫毛膏相关的爆款笔记 助手：正在为你查询化妆美容分类的单日爆发榜数据...
2. 查看完整输出
系统自动输出4项内容（完整流程规范见 references/core_workflow.md）：
| 序号 | 输出内容 | 说明 |
|---|---|---|
| 1 | 🔥 单日爆发榜 | 含更新时间，展示TOP20数据 |
| 2 | 📊 单日爆发笔记分析 | 热门内容分析、爆款标题分析、最高数据作品分析 |
| 3 | 📁 HTML页面 | 直接输出可视化页面，支持导出PDF/图片 |
| 4 | 🔔 订阅服务 | 每日19:30推送选项 |
3. 查看更多数据
默认输出TOP20内容，输入「查看更多」即可获取全部50条内容：
用户：查看更多 助手：为你展示全部50条单日爆发笔记...
高级使用（4步）
1. 分类匹配规则（内部执行）
系统会根据用户输入自动匹配合适的分类，分类匹配逻辑在执行时内部完成，不直接向用户展示具体映射规则或匹配细节。
如需查看完整匹配规范，请参考 references/core_workflow.md。
2. 日期判断规则
- 用户指定了日期 → 直接使用指定日期
- 用户未指定日期：
- 当前时间 >= 19:00 → 查询昨日数据 - 当前时间 < 19:00 → 查询前天数据
3. 数据输出逻辑
| 阶段 | 单日爆发榜 | HTML页面 | 提示 |
|---|---|---|---|
| 首次输出 | TOP1-20 | TOP1-20 | 数据>20条时显示"查看更多"提示 |
| 查看更多 | TOP21-末尾 | TOP1-末尾（完整） | - |
4. 数据一致性保障
- 单日爆发榜表格与HTML页面必须使用相同数据源
- 两个脚本使用相同的API接口，禁止修改接口返回的顺序
命令速查表
| 命令 | 功能 | 示例 |
|---|---|---|
查[关键词]爆款 | 查询指定分类的单日爆发榜 | 查睫毛膏爆款 |
查[日期][关键词]爆款 | 查询指定日期/分类的爆文榜单 | 查2026-04-20化妆美容爆款 |
查看更多 | 获取完整50条榜单数据 | 查看更多 |
订阅 | 开通每日爆款推送 | 订阅 |
取消订阅 | 关闭每日推送服务 | 取消订阅 |
使用场景
| 场景 | 角色 | 需求 | 使用方式 |
|---|---|---|---|
| 找对标内容 | 0粉新手美妆博主 | 不知道小账号做什么内容能爆，头部博主参考性太低 | 每天查询美妆类单日爆发榜，拆解标题/内容/封面，模仿同款内容做差异化 |
| 品牌运营跟热点 | 快消品牌小红书运营 | 跟进平台最新热点，做符合用户喜好的营销内容 | 订阅每日推送，提取热门关键词和内容形式融入品牌推广 |
| MCN挖掘潜力新人 | MCN内容星探 | 挖掘还没火的潜力博主，降低签约成本 | 每天查看全分类单日爆发榜，筛选高互动新账号重点关注 |
| 内容策划找灵感 | 内容策划/文案编辑 | 快速了解平台近期热门内容方向，为选题提供参考 | 按分类查询当日爆发榜，分析爆款共性特征总结模版 |
项目架构
目录结构
xhs-daily-ranking/
├── scripts/
│ ├── xhs_daily_fetcher.py # 数据拉取、榜单生成核心脚本
│ └── gen_xhs_html.py # HTML可视化文件生成脚本
├── references/
│ └── core_workflow.md # 完整功能流程规范（核心）
├── requirements.txt # 依赖声明
└── SKILL.md # Skill定义文档技术栈
- 运行环境：Python 3.8+
- 依赖库：requests>=2.28.0
- 输出格式：Markdown / HTML
- 数据来源：小红书公开内容接口
数据流转
用户请求 → 参数校验（日期/分类匹配） → 调用公开接口拉取数据
↓
生成Markdown榜单 → 规律分析 → 渲染HTML文件
↓
返回4项结果（榜单 + 分析 + HTML + 订阅选项）→ 用户响应⚠️ 输出规范（重要）
完整功能流程规范见 references/core_workflow.md
触发前提（强制，禁止违反）
- 禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息
- 只有当用户主动输入关键词、分类名或明确表达查询意图时，才可调用脚本获取数据
- 禁止主动向用户推送热榜数据、禁止在闲聊或无关对话中自动调用接口
四项输出内容（强制执行）
| 序号 | 输出内容 | 要求 |
|---|---|---|
| 1 | 🔥 单日爆发榜 | 含更新时间，禁止折叠，禁止遗漏 |
| 2 | 📊 单日爆发笔记分析 | 3个模块，禁止折叠，禁止遗漏 |
| 3 | 📁 HTML页面 | 直接输出页面，禁止只输出路径 |
| 4 | 🔔 订阅服务 | HTML页面后立即输出，禁止跳过 |
输出格式要求（强制执行）
- 禁止折叠输出：所有内容必须直接完整输出
- 禁止输出文件：除HTML页面外，禁止输出任何其他文件
- 输出顺序：严格按照单日爆发榜 → 单日分析 → HTML页面 → 订阅服务
执行脚本命令
# 获取榜单数据（最多50条）
python scripts/xhs_daily_fetcher.py --keyword "{关键词}" --top_n 50
# 生成HTML页面
python scripts/gen_xhs_html.py --keyword "{关键词}" --top 20 # 首次输出
python scripts/gen_xhs_html.py --keyword "{关键词}" --top 50 # 查看更多资源索引
| 资源 | 路径 | 说明 |
|---|---|---|
| 完整流程规范 | references/core_workflow.md | 详细输出规范、操作步骤、使用示例 |
| 数据获取脚本 | scripts/xhs_daily_fetcher.py | 获取小红书爆款内容榜单数据 |
| HTML生成脚本 | scripts/gen_xhs_html.py | 生成可视化HTML页面 |
订阅服务内容（必须原样输出，禁止修改，禁止省略）
🔔 订阅服务（是否需要订阅小红书单日爆发笔记推荐？）
1. 每日19:30-推送小红书单日爆发笔记TOP50
2. 暂不需要-仅本次查询
请回复数字或"取消"。