Xiaohongshu Daily Viral Notes
Overview
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
- 🔥 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
- 🏷️ 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 or above
- :
- RedfoxHub account and API Key (format , new users get free credits upon registration)
Installation Methods
SkillHub / ClawHub (Recommended)
- Go to SkillHub or ClawHub
- Search for xiaohongshu-dailytop or 小红书每日爆款笔记
- Install the skill package according to the platform guidelines
- Configure in the conversation environment or local machine (see below)
WorkBuddy / Lobster (Local Skill)
- Place this skill directory into the path of WorkBuddy (e.g.,
~/.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
Standalone Command-line Usage
bash
pip install requests
cd xiaohongshu-dailytop
# Step 1: Fetch data and write to cache
python scripts/xhs_daily_fetcher.py --keyword "mascara" --top_n 50 --output_json /tmp/xhs_daily_cache.json
# Step 2: Generate HTML from cache (skip API call)
python scripts/gen_xhs_html.py --keyword "mascara" --top 20 --input_json /tmp/xhs_daily_cache.json
Environment Variable Configuration
| 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 ~/.zshrc
Windows (PowerShell):
powershell
[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<your apikey>", "User")
Verification:
(macOS/Linux) or
(Windows). Restart the terminal if it doesn't take effect.
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. Initiate Query
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 mascara
Assistant: Output daily viral notes TOP20, daily viral note analysis, and function service inquiry in sequence
2. View More
Default is TOP20; reply "View more" when there are more than 20 entries:
User: View more
Assistant: Display entries from TOP21 to the end of the leaderboard
3. Generate HTML File Package
After the function service inquiry, reply "2" or "Generate":
User: 2
Assistant: Generate Xiaohongshu-style HTML file package, support PDF export
4. Subscribe to Push
After the function service inquiry, reply "1" or "Subscribe":
User: 1
Assistant: Successfully subscribed to daily push of Xiaohongshu Daily Viral Notes TOP50 at 19:30
Advanced Usage
1. Query by Specified Date
User: Check daily viral beauty notes on 2026-04-20
2. General Query of Popular Content
User: What's popular on Xiaohongshu recently
(Use "Comprehensive" category when no keyword is specified.)
3. Query by Specified Category
User: Check yesterday's viral leaderboard for fashion category
4. Unsubscribe
User: Unsubscribe
Quick Reference for Common Commands
| Command / User Input | Function |
|---|
Check [keyword] viral notes
| Query daily viral leaderboard by keyword (default TOP20) |
Check [date] [category/keyword] viral notes
| 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 |
python scripts/xhs_daily_fetcher.py --keyword "mascara" --top_n 50 --output_json /tmp/cache.json
| Pull leaderboard data via command line and write to cache |
python scripts/gen_xhs_html.py --keyword "mascara" --top 20 --input_json /tmp/cache.json
| 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
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
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
Scenario 3: MCNs Discovering Potential Notes and Accounts
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
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 # 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
| Item | Description |
|---|
| Runtime Environment | Python 3.8+ |
| Core Dependency | |
| Data Source | Redfox API |
| Authentication | Request header ← Environment variable |
| Deployment Methods | SkillHub / ClawHub / WorkBuddy local skill / Command line |
Core Modules
| Module | Responsibility |
|---|
| Match categories by keywords, judge dates, call API, output leaderboard data; support to write JSON cache for gen_html reuse |
| Prioritize reading data from cache to generate HTML (skip API call), fall back to independent API when cache is invalid; support |
| Four mandatory output sections, table/HTML format, subscription copy, category list, API call limit and data reuse rules |
FAQs
Installation-related Questions
Q1: What to do if prompted that is not found?
Register 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.
Q2: How to verify that the API Key has taken effect?
Execute
(macOS/Linux) or
(Windows), confirm it starts with
.
Q3: What installation/call methods are supported?
SkillHub, ClawHub, WorkBuddy local skill directory, or directly run Python scripts under
.
Usage-related Questions
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: 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: 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.
Core Workflow
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.py
,
.
Must 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
- 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