| name | xhs-viral-pulse |
| description | Generates a 5-section weekly viral content report for Xiaohongshu (小红书) — searches keywords, ranks TOP 30 viral notes, extracts title formulas, mines pain points from real comments, and recommends TOP 10 content topics. Output goes to a Feishu folder. Use when the user asks to 拆解本周爆款 / 跑爆款周报 / 看 X 赛道爆款 / 做内容选题 / 这周 X 关键词热门 / weekly viral report / xiaohongshu trending content / decompose viral notes for content planning. |
xhs-viral-pulse — 小红书爆款周报
Pulls TOP 30 viral notes for given keywords, mines real-comment pain points, and outputs a 5-section actionable weekly report to Feishu.
When to use
User asks (in any language):
- 「拆解本周心理赛道的同款爆款」
- 「跑下本周关键词 X/Y/Z 的爆款周报」
- 「我这周该写什么选题？」
- 「Generate this week's viral pulse for [niche]」
Quick start
bash skills/../tests/verify_install.sh
python3 shared/lib/cli.py viral-pulse \
--keywords 情绪管理,内耗,自我疗愈 \
--persona path/to/persona.json
What it produces (in Feishu folder)
- 数据排行榜 TOP 30 — table with likes / collects / comments / author / fans / category
- 爆款内容框架分析 — high-frequency title formulas (P1-P10) + form distribution + opinion category breakdown
- 核心信息点汇总 — TOP 20 hot topic words + 8 pain-point buckets with real verbatim comment quotes (IP + likes + source attribution)
- 本周可用爆款选题建议 TOP 10 — each topic anchored to specific TOP 30 viral notes
- 数据规律总结 — quantitative baselines (median likes, low-fan viral %, form ROI, formula upvote rate)
Plus a 58-row CSV of full data, importable as a native Feishu sheet.
Workflow detail
See workflow.md for the full step-by-step (data fetch → analyze → render → push).
Composition with other skills
Common chains:
xhs-viral-pulse → xhs-viral-rewrite (uses TOP 30 as input for persona-based rewrites)xhs-viral-pulse → xhs-trend-scan (mines emerging concepts from same dataset)
Failure modes — feishu output is REQUIRED
The skill must end with a Feishu doc URL handed back to the user. If feishu push fails for any reason, stop and ask the user to fix the configuration. Do NOT silently degrade to local-only output.
| Failure | Action |
|---|
lark-cli binary not in PATH | STOP. Tell user to install lark-cli per setup/02_install_lark_cli.md. |
lark-cli auth expired (LarkAuthExpired) | STOP. Tell user: lark-cli auth login --as bot |
Bot lacks scope (LarkScopeMissing) | STOP. Show the scope_url from the error; user grants in 1 click in 飞书 console. |
config.yaml missing feishu.folder_token | STOP. Tell user to edit config.yaml. |
Local markdown / JSON / xlsx files saved during the run are intermediate artifacts — they are not the deliverable.
Examples
See examples.md for a full sample report.
