xiaohongshu-dailytop

Xiaohongshu Daily Viral Notes

Overview

One-sentence positioning: Query Xiaohongshu's TOP50 viral notes with surging interactions for the day by keyword or track, automatically break down titles, content, and trend patterns, helping creators and operators quickly seize traffic trends and land their next topic.

Through simple keyword queries, you can:

Categorized query of the day's popular notes : Retrieve the highest-popularity notes on Xiaohongshu that day by categories such as beauty, fashion, and food, to quickly grasp the leading content in each track.
Single-day viral note analysis: View details of notes with the fastest interaction growth and surging exposure in a single day, and analyze their viral characteristics such as titles, covers, and content structure.
Daily trend tracking across fields: Monitor real-time popularity changes in different fields, identify content directions that are gaining momentum, and predict the next wave of traffic trends.
Creative inspiration generation: Based on the day's viral content, distill reusable topics, phrasing, and presentation formats for direct use in planning your next note.

Suitable for scenarios where brands, MCN agencies, self-media practitioners, content planners, etc. need to monitor popular content on Xiaohongshu.

Features

🎯 Core Features

🔥 Single-day breakout ranking query: Get the day's TOP50 popular notes, query by category, with precise matching support for 25 vertical fields
📊 Intelligent pattern analysis: Generate three-dimensional reports on popular content analysis, viral title analysis, and highest-performing work analysis
📈 Multi-dimensional data display: Fully present interactions, likes, comments, favorites, shares, and newly added data
🔔 Automatic subscription push: Supports pushing the latest ranking to the message bar at a fixed time of 19:30 every day

✨ Highlights

🏷️ Full category coverage: 25 mainstream categories including All, Makeup & Beauty, Fashion & Outfits, Delicious Food, etc.
🔍 Intelligent category matching: Enter "mascara" → Makeup & Beauty, no need to manually select a category (matching results are not shown to users)
⏰ Flexible date adaptation: Supports specifying a date; when not specified, automatically determines the query date according to the 19:00 update rule
📄 Dual-format output: Markdown table + on-demand HTML page generation, suitable for both personal use and reporting

One-click installation

Prerequisites

Python 3.8 or above
requests：pip install requests
Honghu Hub account and API Key (format ak_xxxxxxxx, new users receive free credits upon registration)

Installation method

SkillHub / ClawHub (recommended)

Go to SkillHub or ClawHub
Search xiaohongshu-dailytop or Xiaohongshu Daily Viral Notes
Install the skill package according to the platform's instructions
In the conversation environment or locally configure REDFOX_API_KEY(see below)

WorkBuddy / Lobster (local skill)

Place this skill directory into WorkBuddy's skills path (e.g., ~/.workbuddy/skills/xiaohongshu-dailytop）
Trigger in conversation via the skill name or description (e.g., "Check Xiaohongshu daily viral notes" "mascara viral")
Configure REDFOX_API_KEY then restart the terminal to ensure both the Agent and scripts can read it

Standalone command-line use

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

Environment variable configuration

Variable name	Required	Description
`REDFOX_API_KEY`	Yes	Red Fox API key, format `ak_xxxxxxxx`

Get API Key: visit Red Fox Hub official website → register/log in → copy the Key from the personal center.

macOS / Linux：

echo 'export REDFOX_API_KEY=<你的apikey>' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell）：

[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<你的apikey>", "User")

Verify:echo $REDFOX_API_KEY(macOS/Linux) or echo %REDFOX_API_KEY%(Windows). If it does not take effect, restart the terminal.

Windows Git Bash notes: User-level environment variables set in PowerShell may not be readable by Git Bash; they must be explicitly injected in the command:

export REDFOX_API_KEY="ak_xxx" && python scripts/xhs_daily_fetcher.py ...

User guide

Basic usage

1. Initiate a query

Tell the assistant a keyword or domain (if no category is specified, it will be matched automatically; if no date is specified, it will be determined by the 19:00 rule):

User: Help me check viral notes related to mascara

Assistant: Output daily viral notes TOP20, daily viral notes analysis, and feature service inquiry in sequence

2. View more

Default is TOP20; when there are more than 20 items of data, you can reply "view more":

User: View more

Assistant: Display TOP21 to the end of the list

3. Generate HTML file package

After the feature service inquiry, reply "2" or "generate":

User: 2

Assistant: Generate a Xiaohongshu-style HTML file package, supporting PDF export

4. Subscription push

After the feature service inquiry, reply "1" or "subscribe":

User: 1

Assistant: Daily 19:30 push of Xiaohongshu daily viral notes TOP50 has been enabled

Advanced usage

1. Query by specified date

User: Check 2026-04-20 beauty daily viral notes

2. Broad query for popular content

User: What popular content is on Xiaohongshu recently?

(When no keyword is specified, the "all categories combined" category is used.)

3. Query by specified category

User: Check yesterday's breakout ranking in the fashion outfit category

4. Unsubscribe

User: Unsubscribe

Common command quick reference

Command / user phrasing	Function
`查[关键词]爆款` / `每日爆款笔记`	Query the day's breakout ranking by keyword (default TOP20)
`查[日期] [分类/关键词]爆款`	Query by specified date or category
`查看更多`	Display TOP21–end
`1` / `订阅`	Enable daily 19:30 TOP50 push
`2` / `生成`	Generate Xiaohongshu-style HTML file package
`python scripts/xhs_daily_fetcher.py --keyword "睫毛膏" --top_n 50 --output_json /tmp/cache.json`	Pull ranking data via command line and write it to cache
`python scripts/gen_xhs_html.py --keyword "睫毛膏" --top 20 --input_json /tmp/cache.json`	Generate HTML from cache via command line (skip API)

Agent execution instructions: For hard constraints such as the complete output order, table format, and feature service inquiry wording, see references/core_workflow.md。

Use cases

Scenario 1: Content creators looking for daily viral inspiration

Role: Beauty / Fashion Blogger

Needs: Quickly find benchmark notes and title formulas with surging engagement today

How to Use：

Enter track keywords (e.g., "Makeup & Beauty", "Fashion") to query daily viral notes
Read "Viral Title Analysis" and "Top-Performing Work Analysis" to extract replicable structures
Export HTML as PDF for reference

Expected Benefits: Shorten topic selection time, increase note click-through rate and engagement rate

Scenario 2: Brand Operations Tracking Daily Hot Topics

Role: FMCG Brand Xiaohongshu Operations

Needs: Grasp daily breakout content across categories to guide ad placement and seeding direction

How to Use：

Query the daily breakout ranking TOP20 by category keywords
Compare new engagement, saves, and shares data to filter high-conversion notes
Subscribe to daily 19:30 push notifications to continuously track track changes

Expected Benefits: More timely hot topic response, content strategy aligned with platform rhythm

Scenario 3: MCN Mining Potential Notes and Accounts

Role: MCN Content Scout

Needs: Discover breakout notes with low followers but high engagement, evaluate signing value

How to Use：

View author follower count and new engagement comparison in the rankings
Combine with "Top Engagement Work Analysis" to judge account growth potential
Use links in the HTML to jump to the original post and author homepage for secondary verification

Expected Benefits: Reduce missed detection costs, improve influencer discovery efficiency

Scenario 4: Competitor and Track Daily Report Review

Role: Growth / Data Analysis

Needs: Provide the team with an archivable daily viral data package

How to Use：

Pull TOP50 for target categories on a specified date (first TOP20, then "View More")
Export HTML to PDF and include in the daily report
Based on "Hot Content Analysis", summarize commonalities in covers, topics, and hot topic integration

Expected Benefits: Unified data standards, 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 模板资源

Tech Stack

Project	Description
Runtime Environment	Python 3.8+
Core Dependencies	`requests`
Data Source	Red Fox API `getXhsCozeSkillDataOne`
Authentication	Request Header `X-API-KEY` ← Environment Variable `REDFOX_API_KEY`
Deployment Methods	SkillHub / ClawHub / WorkBuddy local skill / command line

Core Modules

Module	Responsibility
`xhs_daily_fetcher.py`	Keyword matching categorization, date determination, API calls, output ranking data; supports `--output_json` writing to JSON cache for gen_html reuse
`gen_xhs_html.py`	Preferentially read data from `--input_json` cache to generate HTML (skip API calls); fall back to standalone API when cache is invalid; supports `--top 20/50`
`core_workflow.md`	four-segment mandatory output, table/HTML format, subscription copy, category list, API call limits and data reuse rules

FAQ

Installation-related questions

Q1: Prompt shows not found REDFOX_API_KEY What should I do?

Follow one-click installation Register at the RedFox Hub official website and configure environment variables; after configuring, restart the terminal. If the user does not know how to configure it, the Agent should assist in writing to ~/.zshrc / ~/.bashrc or the Windows user-level environment variables.

Q2: How do I verify that the API Key has taken effect?

Run echo $REDFOX_API_KEY(macOS/Linux) or echo %REDFOX_API_KEY%(Windows), and confirm that it starts with ak_ .

Q3: Which installation/invocation methods are supported?

SkillHub, ClawHub, WorkBuddy local skill directories, or directly run the Python script under scripts/ .

Usage-related questions

Q4: What time is the ranking data updated every day?

Daily at 19:00 UpdatedYesterday'sdata. If the current time is ≥ 19:00, query yesterday; if < 19:00, query the day before yesterday (when no date is specified).

Q5: What does the "Daily Viral Notes" metric mean?

After a note is published,Day 3 relative to Day 2interaction increment sorted from high to low, TOP50, not a cumulative overall ranking.

Q6: Why are only 20 items displayed?

The first time defaults to TOP20; when more than 20 items are returned, reply "View More" to load the rest, and the HTML is synchronously expanded to the full set.

Q7: What content will a single query output?

Fixed three parts: Daily Viral Notes → Daily Viral Notes Analysis (3 modules) → Feature Service Inquiry. The HTML file package is generated on demand. The order and format are subject to core_workflow.md .

Security and Licensing

Q8: How should the API Key be kept?

Read only through environment variables; do not commit it to public repositories or chat logs.

Q9: What are the boundaries for data use?

The ranking is based on successful API/script returns; jumping to the original text must comply with Xiaohongshu platform rules and copyright requirements, and do not make exaggerated promises about unverified data.

API Call Optimization

Q10: How many API calls does one query make?

In a normal scenario with data, only 1 time(fetcher obtains data and writes it to cache, gen_html reads from cache and skips the API). When there is no data for the default date, the script has a built-in fallback of one day, up to 2 times. The Agent is prohibited from constructing API requests on its own outside the script.

Q11: Can gen_html skip the API and use the cache directly?

Yes. Use the --input_json parameter to specify the JSON cache file output by the fetcher; gen_html will completely skip the API call, and the HTML can be generated normally even without an API Key.

Core Workflow

Complete execution specification (trigger prerequisites, output, table/HTML templates, original text of feature service inquiry, category matching, date rules, script parameters)must first read and follow references/core_workflow.md, andfully followthe trigger rules, output specifications, operation steps, and precautions therein. Script paths are relative to the skill directory:scripts/xhs_daily_fetcher.py、scripts/gen_xhs_html.py。

When executing tasks, it must be strictly followed, including but not limited to:

Do not automatically pull rankings when the user has not explicitly queried or subscribed
Must output in order: Explosion Ranking → Analysis → Feature Service Inquiry
Do not collapse output; do not output files such as CSV/JSON
The table and HTML data sources and order 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; for query date rules, see the core process
Output completeness: All three parts are indispensable; functional service inquiries must be output verbatim immediately after the daily analysis
Data authenticity: Based on what the script/API returns; hallucinating rankings or interaction counts to fill in gaps is prohibited
Compliance: Comply with platform and copyright regulations; subscription push time is daily at 19:30

About this skill

Overview

Suitable for scenarios where brands, MCN agencies, self-media practitioners, content planners, etc. need to monitor popular content on Xiaohongshu.

Features

🎯 Core Features

✨ Highlights

One-click installation

Prerequisites

Installation method

SkillHub / ClawHub (recommended)

WorkBuddy / Lobster (local skill)

Standalone command-line use

Environment variable configuration

User guide

Basic usage

1. Initiate a query

2. View more

3. Generate HTML file package

4. Subscription push

Advanced usage

1. Query by specified date

2. Broad query for popular content

3. Query by specified category

4. Unsubscribe

Common command quick reference

Use cases

Scenario 1: Content creators looking for daily viral inspiration

Scenario 2: Brand Operations Tracking Daily Hot Topics

Scenario 3: MCN Mining Potential Notes and Accounts

Scenario 4: Competitor and Track Daily Report Review

Project Architecture

Directory Structure

Tech Stack

Core Modules

FAQ

Installation-related questions

Usage-related questions

Security and Licensing

API Call Optimization

Core Workflow

Notes