xiaohongshu-dailytop
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese小红书每日爆款笔记
Xiaohongshu Daily Viral Notes
简介
Overview
一句话定位:按关键词或赛道查询小红书当日互动暴涨 TOP50 爆款笔记,自动拆解标题、内容与趋势规律,帮创作者和运营快速抓住流量风口、落地下一篇选题。
通过简单的关键词查询,你可以:
- 分类查询当日热门笔记 :按美妆、穿搭、美食等分类检索小红书当天热度最高的笔记,快速掌握各赛道头部内容。
- 单日爆款笔记分析:查看单日互动增长最快、曝光飙升的笔记详情,分析其标题、封面、内容结构等爆款特征。
- 各领域当日趋势追踪:监测不同领域的实时热度变化,识别正在起量的内容方向,预判下一波流量风口。
- 创作灵感生成:基于当日爆款内容,提炼可复用的选题、话术与呈现形式,直接用于你的下一篇笔记策划。
适用于品牌方、MCN机构、自媒体从业者、内容策划等需要监测小红书热门内容的场景。
One-sentence positioning: Query the TOP 50 viral Xiaohongshu notes with surging interactions of the day by keywords or tracks, automatically analyze titles, content and trend patterns, helping creators and operators quickly seize traffic opportunities and develop the next content idea.
With simple keyword queries, you can:
- Category-based daily popular note query: Search for the most popular Xiaohongshu notes of the day by categories such as beauty, fashion, food, etc., and quickly grasp the top content in each track.
- Single-day viral note analysis: View details of notes with the fastest interaction growth and soaring exposure, analyze their viral features such as titles, covers, and content structures.
- Daily trend tracking across fields: Monitor real-time popularity changes in different sectors, identify emerging content directions, and predict the next wave of viral traffic opportunities.
- Creative inspiration generation: Extract reusable topics, scripts, and presentation formats based on the day's viral content, directly applicable to your next note planning.
Suitable for scenarios where brands, MCN agencies, self-media practitioners, content planners need to monitor popular Xiaohongshu content.
功能特性
Features
🎯 核心功能
🎯 Core Features
- 🔥 单日爆发榜查询:获取当日热门笔记TOP50,按分类查询,支持25个垂直领域精准匹配
- 📊 智能规律分析:生成热门内容分析、爆款标题分析、最高数据作品分析三维度报告
- 📈 多维度数据展示:完整呈现互动数、点赞、评论、收藏、分享及新增数据
- 🔔 自动订阅推送:支持每日19:30固定时间推送最新榜单到消息栏
- 🔥 Daily Viral Leaderboard Query: Obtain the TOP 50 daily popular notes, support category-based queries and precise matching for 25 vertical sectors
- 📊 Intelligent Pattern Analysis: Generate three-dimensional reports including popular content analysis, viral title analysis, and top-performing work analysis
- 📈 Multi-dimensional Data Display: Fully present interaction count, likes, comments, favorites, shares and new data
- 🔔 Auto Subscription & Push: Support fixed-time push of the latest leaderboard to the message bar at 19:30 every day
✨ 特色亮点
✨ Highlight Features
- 🏷️ 全分类覆盖:综合全部、化妆美容、时尚穿搭、美味佳肴等 25 个主流分类
- 🔍 智能分类匹配:输入「睫毛膏」→ 化妆美容,无需手动选类(对用户不展示匹配结果)
- ⏰ 灵活日期适配:支持指定日期;未指定时按 19:00 更新规则自动判断查询日
- 📄 双格式输出:Markdown 表格 + 按需生成 HTML 页面,自用与汇报均可
- 🏷️ Full Category Coverage: Cover 25 mainstream categories including comprehensive, beauty, fashion, food, etc.
- 🔍 Intelligent Category Matching: Input "mascara" → automatically match to beauty category (matching results not displayed to users)
- ⏰ Flexible Date Adaptation: Support specified dates; automatically determine the query date according to the 19:00 update rule when no date is specified
- 📄 Dual-format Output: Markdown table + on-demand HTML page generation, suitable for personal use and reporting
一键安装
One-click Installation
前置条件
Prerequisites
- Python 3.8 及以上
- :
requestspip install requests - 红狐Hub 账号与 API Key(格式 ,新用户注册赠免费积分)
ak_xxxxxxxx
- Python 3.8 or above
- :
requestspip install requests - RedfoxHub account and API Key (format , new users get free credits upon registration)
ak_xxxxxxxx
安装方式
Installation Methods
SkillHub / ClawHub(推荐)
SkillHub / ClawHub (Recommended)
WorkBuddy / 龙虾(本地技能)
WorkBuddy / Lobster (Local Skill)
- 将本技能目录放入 WorkBuddy 的 路径(如
skills)~/.workbuddy/skills/xiaohongshu-dailytop - 在对话中通过技能名或描述触发(如「查小红书每日爆款笔记」「睫毛膏爆款」)
- 配置 后重启终端,确保 Agent 与脚本均可读取
REDFOX_API_KEY
- Place this skill directory into the path of WorkBuddy (e.g.,
skills)~/.workbuddy/skills/xiaohongshu-dailytop - Trigger it via skill name or description in conversations (e.g., "Check Xiaohongshu daily viral notes" "Viral mascara notes")
- Restart the terminal after configuring to ensure both Agent and scripts can read it
REDFOX_API_KEY
命令行独立使用
Standalone Command-line Usage
bash
pip install requests
cd xiaohongshu-dailytopbash
pip install requests
cd xiaohongshu-dailytop步骤一:获取数据并写入缓存
Step 1: Fetch data and write to cache
python scripts/xhs_daily_fetcher.py --keyword "睫毛膏" --top_n 50 --output_json /tmp/xhs_daily_cache.json
python scripts/xhs_daily_fetcher.py --keyword "mascara" --top_n 50 --output_json /tmp/xhs_daily_cache.json
步骤二:从缓存生成 HTML(跳过 API 调用)
Step 2: Generate HTML from cache (skip API call)
python scripts/gen_xhs_html.py --keyword "睫毛膏" --top 20 --input_json /tmp/xhs_daily_cache.json
undefinedpython scripts/gen_xhs_html.py --keyword "mascara" --top 20 --input_json /tmp/xhs_daily_cache.json
undefined环境变量配置
Environment Variable Configuration
| 变量名 | 必填 | 说明 |
|---|---|---|
| 是 | 红狐 API 密钥,格式 |
macOS / Linux:
bash
echo 'export REDFOX_API_KEY=<你的apikey>' >> ~/.zshrc
source ~/.zshrcWindows(PowerShell):
powershell
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<你的apikey>", "User")验证:(macOS/Linux)或 (Windows)。未生效请重启终端。
echo $REDFOX_API_KEYecho %REDFOX_API_KEY%Windows Git Bash 注意事项:PowerShell 设置的用户级环境变量 Git Bash 可能无法读取,需在命令中显式注入:
bash
export REDFOX_API_KEY="ak_xxx" && python scripts/xhs_daily_fetcher.py ...| Variable Name | Required | Description |
|---|---|---|
| Yes | Redfox API Key, format |
Get API Key: Visit RedfoxHub Official Website → Register/Login → Copy Key from personal center.
macOS / Linux:
bash
echo 'export REDFOX_API_KEY=<your apikey>' >> ~/.zshrc
source ~/.zshrcWindows (PowerShell):
powershell
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<your apikey>", "User")Verification: (macOS/Linux) or (Windows). Restart the terminal if it doesn't take effect.
echo $REDFOX_API_KEYecho %REDFOX_API_KEY%Windows Git Bash Notes: User-level environment variables set in PowerShell may not be readable by Git Bash, so you need to explicitly inject them in the command:
bash
export REDFOX_API_KEY="ak_xxx" && python scripts/xhs_daily_fetcher.py ...使用指南
Usage Guide
基础使用
Basic Usage
1. 发起查询
1. Initiate Query
告诉助手关键词或领域(未指定分类则自动匹配,未指定日期则按 19:00 规则判断):
用户:帮我查一下睫毛膏相关的爆款笔记助手:依次输出每日爆款笔记 TOP20、每日爆款笔记分析、功能服务询问
Tell the assistant keywords or sectors (automatically match categories if not specified, determine the query date according to the 19:00 rule if no date is specified):
User: Help me check viral notes related to mascaraAssistant: Output daily viral notes TOP20, daily viral note analysis, and function service inquiry in sequence
2. 查看更多
2. View More
默认 TOP20;数据超过 20 条时可回复「查看更多」:
用户:查看更多助手:展示 TOP21 至榜单末尾
Default is TOP20; reply "View more" when there are more than 20 entries:
User: View moreAssistant: Display entries from TOP21 to the end of the leaderboard
3. 生成 HTML 文件包
3. Generate HTML File Package
在功能服务询问后,回复"2"或"生成":
用户:2助手:生成小红书风格的 HTML 文件包,支持导出 PDF
After the function service inquiry, reply "2" or "Generate":
User: 2Assistant: Generate Xiaohongshu-style HTML file package, support PDF export
4. 订阅推送
4. Subscribe to Push
在功能服务询问后,回复"1"或"订阅":
用户:1助手:已开通每日 19:30 推送小红书每日爆款笔记 TOP50
After the function service inquiry, reply "1" or "Subscribe":
User: 1Assistant: Successfully subscribed to daily push of Xiaohongshu Daily Viral Notes TOP50 at 19:30
高级使用
Advanced Usage
1. 指定日期查询
1. Query by Specified Date
用户:查 2026-04-20 美妆类每日爆款笔记
User: Check daily viral beauty notes on 2026-04-20
2. 泛查询热门内容
2. General Query of Popular Content
用户:最近小红书有什么热门内容
(未指定关键词时使用「综合全部」分类。)
User: What's popular on Xiaohongshu recently
(Use "Comprehensive" category when no keyword is specified.)
3. 指定分类查询
3. Query by Specified Category
用户:查时尚穿搭分类昨天的爆发榜
User: Check yesterday's viral leaderboard for fashion category
4. 取消订阅
4. Unsubscribe
用户:取消订阅
User: Unsubscribe
常用命令速查
Quick Reference for Common Commands
| 命令 / 用户说法 | 功能 |
|---|---|
| 按关键词查询当日爆发榜(默认 TOP20) |
| 指定日期或分类查询 |
| 展示 TOP21–末尾 |
| 开通每日 19:30 TOP50 推送 |
| 生成小红书风格 HTML 文件包 |
| 命令行拉取榜单数据并写入缓存 |
| 命令行从缓存生成 HTML(跳过 API) |
Agent 执行说明:完整输出顺序、表格格式、功能服务询问文案等硬性约束见 references/core_workflow.md。
| Command / User Input | Function |
|---|---|
| Query daily viral leaderboard by keyword (default TOP20) |
| Query by specified date or category |
| Display entries from TOP21 to the end |
| Subscribe to daily push of TOP50 at 19:30 |
| Generate Xiaohongshu-style HTML file package |
| Pull leaderboard data via command line and write to cache |
| Generate HTML from cache via command line (skip API call) |
Agent Execution Instructions: Hard constraints such as complete output sequence, table format, function service inquiry copy are specified in references/core_workflow.md.
使用场景
Usage Scenarios
场景一:内容创作者找每日爆款灵感
Scenario 1: Content Creators Seeking Daily Viral Inspiration
角色:美妆 / 穿搭博主
需求:快速找到当日互动暴涨的对标笔记与标题套路
使用方式:
- 输入赛道关键词(如「化妆美容」「穿搭」)查询每日爆款笔记
- 阅读「爆款标题分析」「最高数据作品分析」提炼可复制结构
- 导出 HTML 为 PDF 留存参考
预期收益:缩短选题时间,提高笔记点击率与互动率
Role: Beauty / Fashion Blogger
Demand: Quickly find benchmark notes and title routines with surging interactions of the day
Usage:
- Query daily viral notes by track keywords (e.g., "beauty" "fashion")
- Extract replicable structures from "Viral Title Analysis" and "Top-performing Work Analysis"
- Export HTML as PDF for reference
Expected Benefit: Shorten topic selection time, increase note click-through rate and interaction rate
场景二:品牌运营追踪当日热点
Scenario 2: Brand Operators Tracking Daily Hotspots
角色:快消品牌小红书运营
需求:掌握当日各分类爆发内容,指导投放与种草方向
使用方式:
- 按品类关键词每日查询爆发榜 TOP20
- 对比互动、收藏、分享新增数据筛选高转化笔记
- 订阅每日 19:30 推送,持续跟踪赛道变化
预期收益:热点响应更及时,内容策略与平台节奏对齐
Role: FMCG Brand Xiaohongshu Operator
Demand: Master the viral content of each category of the day, guide placement and grass-growing directions
Usage:
- Query the daily viral leaderboard TOP20 by category keywords every day
- Filter high-conversion notes by comparing new data of interactions, favorites and shares
- Subscribe to daily push at 19:30 to continuously track track changes
Expected Benefit: More timely response to hotspots, align content strategy with platform rhythm
场景三:MCN 挖掘潜力笔记与账号
Scenario 3: MCNs Discovering Potential Notes and Accounts
角色:MCN 内容星探
需求:发现低粉高互动的爆发笔记,评估签约价值
使用方式:
- 查看榜单中作者粉丝数与互动新增对比
- 结合「最高互动作品分析」判断账号成长潜力
- 使用 HTML 内链接跳转原文与作者主页二次核实
预期收益:降低漏检成本,提高达人挖掘效率
Role: MCN Talent Scout
Demand: Discover viral notes with low follower count but high interactions, evaluate signing value
Usage:
- Compare the author's follower count with new interaction data in the leaderboard
- Judge account growth potential combined with "Top-performing Work Analysis"
- Use links in HTML to jump to original notes and author homepages for secondary verification
Expected Benefit: Reduce missed detection costs, improve talent discovery efficiency
场景四:竞品与赛道日报复盘
Scenario 4: Competitor and Track Daily Review
角色:增长 / 数据分析
需求:为团队提供可存档的每日爆款数据包
使用方式:
- 指定日期拉取目标分类 TOP50(先 TOP20,再「查看更多」)
- 将 HTML 导出 PDF 纳入日报
- 基于「热门内容分析」归纳封面、选题、热点结合等共性
预期收益:数据口径统一,复盘与汇报材料一键生成
Role: Growth / Data Analyst
Demand: Provide the team with archivable daily viral data packages
Usage:
- Pull the TOP50 of the target category by specified date (first TOP20, then "View more")
- Export HTML as PDF and include it in daily reports
- Summarize commonalities such as covers, topics, hotspot integration based on "Popular Content Analysis"
Expected Benefit: Unified data caliber, one-click generation of review and reporting materials
项目架构
Project Architecture
目录结构
Directory Structure
xiaohongshu-dailytop/
├── SKILL.md # 产品说明(本文档)
├── references/
│ └── core_workflow.md # Agent 执行流程、输出规范、分类与日期规则
└── scripts/
├── xhs_daily_fetcher.py # 调用 API 获取榜单数据
├── gen_xhs_html.py # 生成可视化 HTML 页面
└── xhs_weekly.html # HTML 模板资源xiaohongshu-dailytop/
├── SKILL.md # Product Description (this document)
├── references/
│ └── core_workflow.md # Agent execution flow, output specifications, category and date rules
└── scripts/
├── xhs_daily_fetcher.py # Call API to get leaderboard data
├── gen_xhs_html.py # Generate visual HTML page
└── xhs_weekly.html # HTML template resources技术栈
Tech Stack
| 项目 | 说明 |
|---|---|
| 运行环境 | Python 3.8+ |
| 核心依赖 | |
| 数据来源 | 红狐 API |
| 鉴权 | 请求头 |
| 部署方式 | SkillHub / ClawHub / WorkBuddy 本地技能 / 命令行 |
| Item | Description |
|---|---|
| Runtime Environment | Python 3.8+ |
| Core Dependency | |
| Data Source | Redfox API |
| Authentication | Request header |
| Deployment Methods | SkillHub / ClawHub / WorkBuddy local skill / Command line |
核心模块
Core Modules
| 模块 | 职责 |
|---|---|
| 关键词匹配分类、日期判断、调用 API、输出榜单数据;支持 |
| 优先从 |
| 四段强制输出、表格/HTML 格式、订阅文案、分类列表、接口调用上限与数据复用规则 |
| Module | Responsibility |
|---|---|
| Match categories by keywords, judge dates, call API, output leaderboard data; support |
| Prioritize reading data from |
| Four mandatory output sections, table/HTML format, subscription copy, category list, API call limit and data reuse rules |
常见问答
FAQs
安装相关问题
Installation-related Questions
Q1:提示未找到 怎么办?
REDFOX_API_KEYQ2:如何验证 API Key 已生效?
执行 (macOS/Linux)或 (Windows),确认以 开头。
echo $REDFOX_API_KEYecho %REDFOX_API_KEY%ak_Q3:支持哪些安装/调用方式?
SkillHub、ClawHub、WorkBuddy 本地技能目录,或直接运行 下 Python 脚本。
scripts/Q1: What to do if prompted that is not found?
REDFOX_API_KEYRegister on RedfoxHub Official Website and configure environment variables according to One-click Installation; restart the terminal after configuration. If users don't know how to configure, Agent should assist in writing to / or Windows user-level environment variables.
~/.zshrc~/.bashrcQ2: How to verify that the API Key has taken effect?
Execute (macOS/Linux) or (Windows), confirm it starts with .
echo $REDFOX_API_KEYecho %REDFOX_API_KEY%ak_Q3: What installation/call methods are supported?
SkillHub, ClawHub, WorkBuddy local skill directory, or directly run Python scripts under .
scripts/使用相关问题
Usage-related Questions
Q4:榜单数据每天何时更新?
每日 19:00 更新昨日数据。当前时间 ≥ 19:00 查昨日;< 19:00 查前天(未指定日期时)。
Q5:「每日爆款笔记」指标含义是什么?
笔记发布后第 3 天相对第 2 天的互动增量由高到低排序的 TOP50,不是累计总榜。
Q6:为什么只显示 20 条?
首次默认 TOP20;返回超过 20 条时回复「查看更多」可加载剩余,HTML 同步扩展为全量。
Q7:一次查询会输出哪些内容?
固定三部分:每日爆款笔记 → 每日爆款笔记分析(3 模块)→ 功能服务询问。HTML 文件包按需生成。顺序与格式以 core_workflow.md 为准。
Q4: When is the leaderboard data updated every day?
Update yesterday's data at 19:00 every day. If current time ≥ 19:00, query yesterday's data; if < 19:00, query the day before yesterday (when no date is specified).
Q5: What does the "Daily Viral Notes" indicator mean?
TOP50 notes sorted by interaction increment on the 3rd day relative to the 2nd day after publication, not the cumulative total leaderboard.
Q6: Why only 20 entries are displayed?
Default is TOP20 for the first query; reply "View more" to load remaining entries when there are more than 20 entries, and HTML will be expanded to full volume synchronously.
Q7: What content will be output in one query?
Fixed three parts: Viral leaderboard → Viral note analysis (3 modules) → Function service inquiry. HTML file package is generated on demand. The sequence and format are subject to core_workflow.md.
安全与许可
Security & License
Q8:API Key 如何保管?
仅通过环境变量读取,勿提交至公开仓库或聊天记录。
Q9:数据使用边界?
榜单以 API/脚本成功返回为准;跳转原文须遵守小红书平台规则与版权要求,不对未验证数据做夸大承诺。
Q8: How to keep API Key secure?
Only read via environment variables, do not submit to public repositories or chat records.
Q9: Data usage boundaries?
The leaderboard is based on successful API/script returns; jumping to original notes must comply with Xiaohongshu platform rules and copyright requirements, and no exaggerated promises are made for unverified data.
接口调用优化
API Call Optimization
Q10:一次查询会调用几次 API?
正常有数据场景仅 1 次(fetcher 获取数据并写入缓存,gen_html 从缓存读取跳过 API)。默认日期无数据时脚本内置回退一天,最多 2 次。Agent 禁止在脚本之外自行构造 API 请求。
Q11:gen_html 能否跳过 API 直接使用缓存?
可以。使用 参数指定 fetcher 输出的 JSON 缓存文件,gen_html 将完全跳过 API 调用,即使没有 API Key 也能正常生成 HTML。
--input_jsonQ10: How many API calls will be made in one query?
Only 1 call in normal scenarios with data (fetcher gets data and writes to cache, gen_html reads from cache and skips API). If there is no data for the default date, the script will automatically fall back to the previous day, up to 2 calls. Agent is prohibited from constructing API requests outside the script.
Q11: Can gen_html skip API and use cache directly?
Yes. Use the parameter to specify the JSON cache file output by fetcher, gen_html will completely skip API calls and can generate HTML normally even without API Key.
--input_json核心工作流程
Core Workflow
完整执行规范(触发前提、输出、表格/HTML 模板、功能服务询问原文、分类匹配、日期规则、脚本参数)必须先读取并遵循 references/core_workflow.md,并完整遵循其中的触发规则、输出规范、操作步骤与注意事项。脚本路径相对于技能目录:、。
scripts/xhs_daily_fetcher.pyscripts/gen_xhs_html.py执行任务时须严格遵循,包括但不限于:
- 禁止在用户未明确查询或未订阅时自动拉榜
- 必须按顺序输出:爆发榜 → 分析 → 功能服务询问
- 禁止折叠输出;禁止输出 CSV/JSON 等文件
- 表格与 HTML 数据源、顺序必须一致
- HTML 按需生成,文件名格式:小红书每日爆款笔记_{分类}_唯一时间戳.html
Complete execution specifications (trigger prerequisites, output, table/HTML template, function service inquiry copy, category matching, date rules, script parameters) must be read and followed first from references/core_workflow.md, and fully comply with its trigger rules, output specifications, operation steps and precautions. Script paths relative to the skill directory: , .
scripts/xhs_daily_fetcher.pyscripts/gen_xhs_html.pyMust strictly follow when executing tasks, including but not limited to:
- Prohibit automatic leaderboard pulling when users do not explicitly query or subscribe
- Must output in order: Viral leaderboard → Analysis → Function service inquiry
- Prohibit folded output; prohibit outputting files such as CSV/JSON
- Data sources and sequences of tables and HTML must be consistent
- HTML is generated on demand, file name format: Xiaohongshu Daily Viral Notes_{Category}_Unique Timestamp.html
注意事项
Notes
- 数据时效:每日 19:00 更新;查询日期规则见核心流程
- 输出完整性:三部分缺一不可;功能服务询问须在每日分析之后立即原样输出
- 数据真实性:以脚本/API 返回为准,禁止幻觉补齐排名或互动数
- 合规:遵守平台与版权规范;订阅推送时间为每日 19:30
- Data Timeliness: Updated daily at 19:00; query date rules refer to core workflow
- Output Completeness: All three parts are indispensable; function service inquiry must be output immediately after daily analysis as is
- Data Authenticity: Based on script/API returns, prohibit hallucinating rankings or interaction counts
- Compliance: Comply with platform and copyright regulations; subscription push time is 19:30 daily