space-xhs-hotspot

Collects Xiaohongshu trending notes and generates data-backed topic recommendations for creators.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Content creators on Xiaohongshu (RED) struggle to know which topics currently get traffic, which content formats the platform favors, and what to write next. This Skill turns keyword or niche queries into structured hotspot tables, trend analysis, and ready-to-write topic cards backed by real engagement data. ## Core Features & Use Cases - Multi-source data collection with automatic fallback: Queries the Redfox API (30-day database of 1000+ engagement notes with relevance/popularity/recency scores), socialdatax CLI, or Guaikei CLI, degrading gracefully to WebSearch when no API key is configured. - Six-dimension trend analysis: Breaks down top notes by content format, title hooks, account size, time distribution, and engagement structure (like/collect/comment ratios), plus viral pattern extraction with reusable/non-reusable/gap lists. - Offline comparison tooling: The compare_sets.py script normalizes saved JSON results for cross-niche or cross-time comparisons, computing medians, ratios, and high-frequency title words. - Use Case: A creator asks "Is the 'commute outfit' niche still hot on Xiaohongshu?" The Skill expands the query into 6-10 sub-keywords from its 24-sector word library, pulls recent high-engagement notes, and returns a trend report plus 3-5 topic cards ready to hand off to title-writing and content-writing skills. ## Quick Start Ask the AI to check what's trending on Xiaohongshu for a niche like "commute outfits" and get a hotspot table with topic suggestions.

Frequently Asked Questions about space-xhs-hotspot

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

FAQPage Schema
How do I find trending topics on Xiaohongshu with an AI agent?▼

Provide a keyword or niche and the Skill queries a 30-day database of notes with 1000+ engagement, returning a hotspot table, trend analysis across six dimensions, and 3-5 ready-to-write topic cards. Broad keywords are automatically expanded into 6-10 sub-keywords queried in parallel.

What API keys does Xiaohongshu hotspot research require?▼

It supports three data sources checked in priority order: REDFOX_API_KEY for the Redfox API with scoring, SOCIALDATAX_API_KEY for near-real-time search, and GUAIKEI_API_TOKEN for note details and comments. With no key configured, it falls back to WebSearch and labels conclusions as unverified by engagement data.

Can I compare two Xiaohongshu niches or time periods?▼

Yes. Save each query result as JSON and run scripts/compare_sets.py with labeled file arguments. It normalizes both Redfox and Guaikei formats, then outputs a comparison table with engagement medians, collect/like ratios, small-account share, dominant formats, and high-frequency title words.

Why does Xiaohongshu search return no results for my keyword?▼

The Redfox database only includes notes with 1000+ engagement from the last 30 days, so zero results means no viral hits, not that nobody writes about it. The Skill expands the time window up to 30 days before concluding the niche is low-output.

What are the limitations of Xiaohongshu engagement data?▼

Engagement counts are snapshots from ingestion time, not live values, and data older than 30 days is unavailable. The Guaikei route cannot retrieve author follower counts, so account-size analysis is marked as unavailable rather than estimated.