xiaohongshu-search

Search Xiaohongshu trending notes via the Redfox API and generate ranked Markdown tables and HTML reports.

Updated Aug 16, 2026
One-click install
npx skills add https://github.com/chuanyue98/skillhub --skill xiaohongshu-search-chuanyue98
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xiaohongshu-search
Source: https://github.com/chuanyue98/skillhub/tree/main/vendored/SpaceZephyr/creator-buddy/gzh-Skills/xhs-hotnotes
Command: npx skills add https://github.com/chuanyue98/skillhub --skill xiaohongshu-search-chuanyue98

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Finding high-performing Xiaohongshu (Little Red Book) notes for content inspiration requires manually browsing the platform, and there is no easy way to compare notes by relevance, engagement, and recency across niches. ## Core Features & Use Cases - Keyword Trending Search: Query trending notes with 1,000+ engagements from the last 30 days, ranked by a weighted score of relevance, popularity, and timeliness. - Generic Keyword Expansion: Detects broad keywords (e.g., "fashion", "food") and proposes 10 niche sub-directions, waiting for user confirmation before searching. - HTML Report Generation: Automatically produces a visual {keyword}_热门数据.html report alongside structured JSON output. - Subscription Push: Supports creating calendar-based subscriptions for scheduled daily pushes of new trending notes. - Use Case: A content creator asks for trending notes on "fat-loss meals" from the last 7 days and receives a ranked TOP10 table with engagement stats, related search suggestions, and an HTML report for review. ## Quick Start Ask the agent to find trending Xiaohongshu notes about a specific niche keyword from the last 7 days after setting the REDFOX_API_KEY environment variable.

Frequently Asked Questions about xiaohongshu-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search trending Xiaohongshu notes by keyword?▼

Run the fetch_xhs_hot_articles.py script with --keyword and --start-date arguments after setting the REDFOX_API_KEY environment variable. The script returns ranked JSON results and generates an HTML report file automatically.

What API key is needed for Xiaohongshu trending data search?▼

The skill requires a REDFOX_API_KEY issued by Redfox Hub (redfox.hk) for API authentication. Configure it as an environment variable or in the OpenClaw config file before running the script.

Does the Xiaohongshu search script need third-party Python packages?▼

No, the script uses only the Python 3 standard library (urllib, json, argparse). Any system with Python 3.x installed can run it without pip installs.

What time range of Xiaohongshu data can I query?▼

The database covers yesterday back to 30 days ago, updated daily at 7 AM with the previous day's data. The default query window is the last 7 days, and it auto-extends to 30 days when results are sparse.

Why does my Xiaohongshu keyword search return no results?▼

Only notes with 1,000+ engagements are indexed, so very niche keywords or short time windows may return nothing. Try broadening the keyword, extending the date range, or using the relatedSearches suggestions returned by the API.