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（推荐） 前往 SkillHub 或 ClawHub 搜索 xiaohongshu-dailytop 或 小红书每日爆款笔记 按平台指引安装技能包 在对话环境或本机配置 REDFOX_API_KEY （见下方） 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