by 运行时依赖
安装命令
点击复制技能文档
小红书单日爆发榜 简介 小红书单日爆发榜是一款专为内容创作者和营销人员设计的智能工具，帮助用户实时追踪小红书平台当日的爆款笔记数据。 通过简单的关键词查询，你可以： 🔥 获取每日单日爆发榜TOP50，解决「不知道今天什么内容在爆」的痛点 📊 自动分析爆款特征和规律，解决「找爆文、拆规律效率低」的痛点 📁 生成可视化HTML页面，一键导出分享，大幅降低内容分析成本 🔔 支持每日固定时间订阅推送，不用手动重复查询 适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。 技术基础：基于小红书公开内容接口，每日19:00更新昨日榜单数据。
功能特性 🎯 核心功能 🔥 单日爆发榜查询：获取当日热门笔记TOP50，按分类查询，支持25个垂直领域精准匹配 📊 智能规律分析：生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告 📈 多维度数据展示：完整呈现互动数、点赞、评论、收藏、分享及新增数据 🔔 自动订阅推送：支持每日19:30固定时间推送最新榜单到消息栏
✨ 特色亮点 ⏰ 智能日期适配：支持指定日期或模糊日期查询，自动按规则匹配近2天数据 📤 多格式输出：自动生成Markdown表格+HTML可视化文件，支持导出PDF/图片 🔗 一键跳转：笔记和作者主页可直接点击跳转，查看原内容更便捷 ⚡ 无额外门槛：无需小红书账号、无需API密钥，安装依赖即可使用
一键安装 前置条件 已安装 Python 3.8 及以上版本 网络可正常访问小红书公开数据接口
安装方式 # 进入项目目录 cd ~/.workbuddy/skills/xhs-daily-ranking # 安装依赖 pip install requests # 验证脚本可执行 python scripts/xhs_daily_fetcher.py --help
环境变量配置 变量名 | 必填 | 说明 XHS_API_PROXY | 否 | 代理服务器地址，若网络访问受限可配置，格式示例：http://127.0.0.1:7890 OUTPUT_PATH | 否 | 生成的榜单文件（.md/.html）保存路径，默认值为当前脚本运行目录 DEFAULT_TOP_N | 否 | 默认查询的爆文数量，默认值为50，支持配置10-50范围内的整数 SCHEDULE_PUSH_HOUR | 否 | 订阅服务的每日推送时间（24小时制），默认值为19，即每日19:30推送
使用指南 基础使用（3步）
- 发起查询
- 查看完整输出
- 查看更多数据
高级使用（4步）
- 分类匹配规则
- 日期判断规则
- 数据输出逻辑
- 数据一致性保障
命令速查表 命令 | 功能 | 示例 查[关键词]爆款 | 查询指定分类的单日爆发榜 | 查睫毛膏爆款 查[日期][关键词]爆款 | 查询指定日期/分类的爆文榜单 | 查2026-04-20化妆美容爆款 查看更多 | 获取完整50条榜单数据 | 查看更多 订阅 | 开通每日爆款推送 | 订阅 取消订阅 | 关闭每日推送服务 | 取消订阅
使用场景 场景 | 角色 | 需求 | 使用方式 | 预期收益 找对标内容 | 0粉新手美妆博主 | 不知道小账号做什么内容能爆，头部博主参考性太低 | 每天查询美妆类单日爆发榜，拆解标题/内容/封面，模仿同款内容做差异化 | 最快1周找到爆文模版，起号速度提升3倍 品牌运营跟热点 | 快消品牌小红书运营 | 跟进平台最新热点，做符合用户喜好的营销内容 | 订阅每日推送，提取热门关键词和内容形式融入品牌推广 | 内容点击率提升40%，推广成本降低25% MCN挖掘潜力新人 | MCN内容星探 | 挖掘还没火的潜力博主，降低签约成本 | 每天查看全分类单日爆发榜，筛选高互动新账号重点关注 | 新人签约成本降低60%，账号孵化成功率提升50% 内容策划找灵感 | 内容策划/文案编辑 | 快速了解平台近期热门内容方向，为选题提供参考 | 按分类查询当日爆发榜，分析爆款共性特征总结模版 | 选题效率提升2倍，内容产出质量更稳定
项目架构 目录结构 xhs-daily-ranking/ ├── scripts/ │ ├── xhs_daily_fetcher.py # 数据拉取、榜单生成核心脚本 │ └── gen_xhs_html.py # HTML可视化文件生成脚本 ├── assets/ │ └── core_workflow.md # 完整功能流程规范（核心） ├── references/ │ └── api-spec.md # 接口规范文档 ├── requirements.txt # 依赖声明 └── SKILL.md # Skill定义文档
技术栈 运行环境：Python 3.8+ 依赖库：requests>=2.28.0 输出格式：Markdown / HTML 数据来源：小红书公开内容接口
数据流转 用户请求 → 参数校验（日期/分类匹配） → 调用公开接口拉取数据 ↓ 生成Markdown榜单 → 规律分析 → 渲染HTML文件 ↓ 返回4项结果（榜单 + 分析 + HTML + 订阅选项）→ 用户响应
常见问答 安装相关问题 Q1: 安装时提示依赖缺失怎么办？ A: 请确保已安装 requests 库： pip install requests Q2: 支持哪些平台部署？ A: 目前支持以下平台： Coze（字节跳动）- 推荐，功能最全 Dify - 适合企业级应用 百度千帆 - 适合国内用户 阿里云百炼 - 适合阿里云生态用户
使用相关问题 Q3: 数据多久更新一次？ A: 榜单每日19:00更新昨日数据。订阅推送时间为每日19:30。 Q4: 为什么有时候看不到当天的数据？ A: 由于数据更新机制，当日19:00前只能查到前天数据。19:00后才能查到昨日数据。 Q5: 为什么分享数据有时候不显示？ A: 分享字段使用 AnaAddBean.useShareCount（累计分享数）和 AnaAddBean.addShareCount（新增分享数）。如数据缺失请检查API返回字段。
故障排除 Q6: 数据不更新怎么办？ A: 请按以下步骤排查： 检查网络连接是否正常 确认当前时间是否 >= 19:00（数据更新时间） 尝试手动触发更新：发送命令重新查询 检查API接口是否可用 Q7: HTML页面打不开或显示异常？ A: 请确保： 浏览器支持HTML5 网络可正常加载页面资源 如导出PDF异常，请检查浏览器打印功能是否正常
安全许可 Q8: 使用这个Skill有封号风险吗？ A: 本Skill基于小红书公开内容接口，无需登录账号，无封禁风险。但请勿高频大量请求，以免触发平台限流。
⚠️ 输出规范（重要） 完整功能流程规范见 assets/core_workflow.md
触发前提（强制，禁止违反） 禁止在用户未明确输入查询内容或未订阅时，自动查询和输出热榜信息 只有当用户主动输入