# Space Xhs Hotspot

小红书热点搜集与选题判断。按关键词/赛道拉取近期高互动笔记，输出热点表格、趋势判断和可直接开写的选题建议。当用户说"小红书热点""小红书最近火什么""查一下 XX...

- Repository: https://github.com/SpaceZephyr/creator-buddy (1778 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-08-26
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add SpaceZephyr/creator-buddy --skill space-xhs-hotspot -g -a claude-code -y`
Codex: `npx skills add SpaceZephyr/creator-buddy --skill space-xhs-hotspot -g -a codex -y`
Cursor: `npx skills add SpaceZephyr/creator-buddy --skill space-xhs-hotspot -g -a cursor -y`
Gemini CLI: `npx skills add SpaceZephyr/creator-buddy --skill space-xhs-hotspot -g -a gemini-cli -y`

## Description

小红书热点搜集与选题判断。按关键词/赛道拉取近期高互动笔记，输出热点表格、趋势判断和可直接开写的选题建议。当用户说"小红书热点""小红书最近火什么""查一下 XX 赛道的爆款""小红书选题""找小红书素材""这个词在小红书热不热""小红书热榜/热门笔记/爆款笔记""帮我看看小红书数据"时触发。也适用于用户报出一个赛道词（如"减脂餐""通勤穿搭""AI 工具"）并问"能不能写"的场景。多数据源自动降级：红狐 API / socialdatax CLI / 怪壳 CLI，均未配置时走 WebSearch 手动兜底。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 小红书热点搜集（space-xhs-hotspot）

给创作者用的选题雷达。目标不是把数据倒出来，而是**回答三个问题**：这个赛道现在有没有流量？流量集中在哪几种内容形态上？我下一篇该写什么。

**产出链路**：本 skill 出选题 → `space-xhs-title` 起标题 → `space-xhs-writer` 写正文。所以最后一段必须是**可以直接粘给下游的选题卡**，不是一句"建议多观察"。

---

## 数据说明（展示任何数据之前必须先说明，逐字保留口径）

- **收录门槛**：红狐库只收录**互动数 1000+** 的笔记。搜不到 ≠ 这个方向没人写，只等于**这个方向没出过 1000+ 互动的爆款**, , 这本身就是一条判断（小众/低天花板 or 蓝海）。
- **更新节奏**：每日**早上 7 点**更新**昨日**数据。当天数据永远查不到，用户说"今天"时按"昨天"处理并说明。
- **数据快照**：互动数是**入库时刻**的快照，不是实时值。入库后还会继续涨, , 所以"3 天前的 8000 互动"实际热度可能高于"昨天的 1.2w"。
- **时间窗**：库内只有**昨天到 30 天前**的数据。超过 30 天的请求要明确告知并降级到最近可用范围。
- **链接口径**：`note_url` / `noteLink` **必须原样输出**，包含 `xsec_token` 查询参数。禁止截断、脱敏、重建，禁止只拿 `note_id` 自己拼 URL, , 拼出来的链接打不开。`note_id` 是 24 位小写十六进制，必须完整复制。

---

## 第 0 步：数据源探测与降级（每次执行前先做，不要假设 Key 存在）

```bash
env | grep -E '^(REDFOX_API_KEY|SOCIALDATAX_API_KEY|GUAIKEI_API_TOKEN)=' | sed 's/=.*/=<set>/'
```

按下表**从上往下**取第一条可用路线；某条路线报错（401/余额不足/网络失败）时继续往下降级，并在输出里注明"本次数据来自 X 路线"。

| 优先级 | 环境变量 | 路线 | 强项 | 短板 |
|---|---|---|---|---|
| 1 | `REDFOX_API_KEY` | 红狐 API（本 skill 自带脚本） | 唯一有**热度/相关性/时效三维评分**和 `relatedSearches` 拓词；天然只含 1000+ 爆款，信噪比最高 | 只有近 30 天；T+1 更新；无评论 |
| 2 | `SOCIALDATAX_API_KEY` | socialdatax CLI（npx，见 `xhs-content-research`） | 近实时；有 `--since-days`、多种排序、图文/视频筛选 | 无评分，需自己按互动排序；按量计费 |
| 3 | `GUAIKEI_API_TOKEN` | 怪壳 Node CLI（见 `xiaohongshu-content-tools`） | 能拿**笔记详情 + 评论区 + 博主全部作品**，做深挖唯一选择 | 需 node，脚本在另一 skill 目录下 |
| 兜底 | 无 | WebSearch 手动 | 零配置 | 无互动数，只能看到标题和大致方向 |

具体命令、参数、报错处理见 `references/data_sources.md`（执行前读它）。

**三个 Key 都没有时**，不要静默失败，按此模板回复：

```
未检测到小红书数据源，本次用公开搜索兜底（拿不到互动数，只能看内容方向）。

想要带互动数据的完整热点分析，配置任一即可（推荐第 1 个）：
  export REDFOX_API_KEY=...        # https://redfox.hk/settings/api-keys  近30天爆款库，带热度评分
  export SOCIALDATAX_API_KEY=...   # https://socialdatax.com/ai          近实时搜索
  export GUAIKEI_API_TOKEN=...     # https://www.guaikei.com             详情+评论深挖
写进 ~/.zshrc 后重开终端即可。
```

然后**继续用 WebSearch 兜底跑完流程**（`site:xiaohongshu.com <关键词>` + 小红书热点类聚合站），只是把"互动数"列换成"来源"列，并在结论里标注"未经互动数据验证"。不要因为没 Key 就停在提示上。

---

The rest: https://github.com/SpaceZephyr/creator-buddy/blob/HEAD/xhs-Skills/space-xhs-hotspot/SKILL.md