# Xiaohongshu Search

小红书热门笔记搜索工具，支持关键词搜索获取热门内容数据，基于数据评分排序推荐热门笔记，助力创作者发现热门趋势、获取创作灵感。仅在主Agent中执行,不派发给子Agent。

- 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 xiaohongshu-search -g -a claude-code -y`
Codex: `npx skills add SpaceZephyr/creator-buddy --skill xiaohongshu-search -g -a codex -y`
Cursor: `npx skills add SpaceZephyr/creator-buddy --skill xiaohongshu-search -g -a cursor -y`
Gemini CLI: `npx skills add SpaceZephyr/creator-buddy --skill xiaohongshu-search -g -a gemini-cli -y`

## Description

小红书热门笔记搜索工具，支持关键词搜索获取热门内容数据，基于数据评分排序推荐热门笔记，助力创作者发现热门趋势、获取创作灵感。仅在主Agent中执行,不派发给子Agent。

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

# 小红书爆款笔记查询

## 1. 简介

小红书热门笔记搜索工具，支持按关键词搜索小红书热门爆款笔记，并基于相关性、热度、时效三维评分智能排序推荐。同时提供热门笔记推荐和细分赛道引导，助力创作者、品牌方和 MCN 机构发现热门趋势、获取创作灵感。注意：本工具仅在主 Agent 中执行，不派发给子 Agent。

## 2. 功能特性

- 🔍 **关键词智能搜索**, 支持关键词精确搜索、多关键词组合（逗号分隔）、全站热门查询（空关键词）
- 📊 **三维评分排序**, 有关键词时按相关性（满分10分）、热度（满分3分）、时效（满分2分）加权计算总分（满分15分），全站热门按互动数排序
- 🧠 **精细意图理解**, 优先从用户描述中提取细分方向词，识别泛化词并自动推荐 10 个细分方向
- ⏱️ **灵活时间范围**, 默认查询最近7天，数据不足时自动扩展时间范围（1天→3天→7天→30天），每日早上7点更新
- 🔥 **热门笔记推荐**, 结果较少时自动展示近期热门推荐笔记和热门话题标签
- 📈 **细分赛道引导**, 每次查询后主动推荐 10 个相关细分方向，帮助用户深入探索
- 🏷️ **拓词推荐**, 脚本返回 relatedSearches 字段，自动展示相关搜索建议
- 📩 **定时订阅推送**, 支持创建日历订阅任务，到达设定时间自动推送最新热门笔记
- 📄 **HTML 报告生成**, 自动生成 `{keyword}_热门数据.html` 可视化文件
- 🛡️ **强数据说明**, 热门笔记收录标准为互动数1000+，顶部展示数据说明和排序依据

## 3. 一键安装

### 鉴权

#### 获取 API Key

请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=skillhub) 获取API KEY

#### 配置 API Key

方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中：

```bash
{ "env": { "REDFOX_API_KEY": "your_api_key_here" } }
```

方案2: 终端配置

```bash
export REDFOX_API_KEY="your_api_key_here"
```

### 依赖安装

本 Skill 使用 Python 3 标准库，无需额外安装第三方依赖。确保系统中已安装 Python 3.x 即可。

### 环境变量配置

| 环境变量 | 说明 | 是否必填 | 获取方式 |
| -------- | ---- | -------- | -------- |
| `REDFOX_API_KEY` | 红狐数据 API Key | 是 | [红狐hub](https://redfox.hk/settings/api-keys?source=skillhub) |

## 4. 使用指南

### ⚠️ 核心执行规则（必须遵守）

1. **泛化词必须先询问再查询**：当识别到泛化词时，**绝对禁止直接调用脚本**，必须先输出细分词推荐并等待用户选择后再执行查询
2. **正确执行顺序**：关键词提取 → 判断是否泛化词 → 是泛化词则询问用户 → 用户回复后再调用脚本
3. **强制等待规则**：输出细分词推荐后，必须停止执行，等待用户下一轮对话回复「拓展」或「不拓展」，**不得在同一次对话中继续执行任何脚本调用**

**常见泛化词**：
泛词：抽象层级高、覆盖范围广的概括性词汇，无具体场景/属性修饰，行业分类等，可包含多个子类。特征：①语义上为上位概念（如"美妆"包含"粉底液/口红"；"运动"包含"跑步/瑜伽"；如AI）；②上下文中常搭配"领域""类型"等概括词（如"美妆领域""运动类型"）。

**常见具体词**：
具体词：抽象层级低、指向明确的实例化词汇，含具体场景/属性修饰，属于某泛词的直接子类。特征：①语义上为下位概念（如"粉底液"是"美妆产品"子类；"生酮饮食"是"饮食方式"子类）；②词语结构多含修饰成分（如"春日"→"春日穿搭"；"生酮"→"生酮饮食"）。

---

### 基础使用（3 步完成查询）

**Step 1, 提取关键词**：从用户自然语言描述中提取搜索关键词。优先提取细分方向词（含具体场景/属性修饰），而非泛化大类词。

**Step 2, 调用脚本**：

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