小红书热点搜集（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 存在）

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 就停在提示上。

---