skill-xhs-analyzer · Xiaohongshu Analyzer

Xiaohongshu content analysis: a redbook CLI for searching notes, pulling engagement data, analyzing hit patterns, profiling creators, and detecting post throttling. Analysis capability is split into 13 composable modules (keyword engagement matrix, cross-topic heatmap, creator profiling, opportunity scoring, comment insights, hit-structure teardowns, etc.), combined per research goal.
Read-only: never calls post/comment/like operations — publishing and engagement belong to skill-xhs-publisher. Research discipline: reads are rate-limited too; large-scale reads must follow the research loop — no high-frequency hammering.
Example invocation: "Analyze hit-note patterns for this topic on Xiaohongshu."
Full brief
Positioning
skill-xhs-analyzer is a read-only analyzer for Xiaohongshu: search/data/hit-patterns/keyword matrices/creator profiles/throttle detection. Publishing and daily engagement belong to skill-xhs-publisher.
Core capabilities
- Note search & reading:
redbook searchto search,readfor full text (always--json). - Hit analysis:
analyze-viralscores single hits (0–100), dissecting title hooks, content structure, engagement patterns. - Creator profiling:
userreads profiles,account-reportdoes batch account metrics. - 13 composable modules (A–M): keyword engagement matrix / cross-topic heatmap / engagement signals / creator profiling / content-format breakdown / opportunity scoring / audience inference / content brainstorming / comment insights / hit-structure teardown / engagement-opportunity ID / card rendering / throttle detection. Combos: quick topic scan
A→C→F, full niche analysisA→B→C→D→E→F→G→H. - Throttle detection:
healthchecks note health. - Research discipline: Xiaohongshu throttles reads, not just writes; large-scale reads must follow the research loop (default human-paced, ~20s per note) — no high-frequency bursts, or captchas/IP bans (300012) follow.
Workflow
- Define the research goal (topic scan / niche analysis / single-post deep dive)
- Pick a module combo (e.g.
A→C→F) - Execute CLI commands under research-loop throttling (always
--json) - Parse JSON, interpret patterns
- Output conclusions
Inputs & outputs
| Input | Notes |
|---|---|
| Research goal | Required — topic scan / niche analysis / deep dive / profiling / throttle check |
| Keywords / note links / accounts | Required, per goal |
| CLI environment | macOS + Node.js ≥ 22 + Chrome logged into Xiaohongshu |
Output: analysis conclusions (engagement matrices, opportunity scores, hit teardowns, creator profiles, throttle checks).
Boundaries with adjacent skills
| Skill | Lane |
|---|---|
| skill-xhs-analyzer (this) | Read-only Xiaohongshu analysis |
| skill-xhs-publisher | Publishing + daily engagement operations |
Fit
- Researching hit patterns for a topic on Xiaohongshu
- Profiling benchmark creators' content formats
- Checking whether your own notes are throttled
- Demand-mapping and opportunity scoring before topic selection
Before you start
- Requires macOS, Node.js ≥ 22, Chrome logged into Xiaohongshu (cookies via native keychain).
- Depends on the
redbookCLI (clawhub install redbookor npm install).
skill-xhs-analyzer is part of the Aiglade Skill library. Invoke it from the Aiglade chat box in plain language.