xiaohongshu-write · diff
git:20260528.3ae8327 to git:20260602.08c4de8
153 added, 132 removed. Audit A to A.
---
name: xiaohongshu-write
description: 专为小红书内容创作打造的一站式笔记生成工具，基于全网每日持续收录的2000+条爆款笔记数据，根据用户输入关键词，精准检索查询平台当下热门爆款笔记，通过AI深度复盘爆款内容的结构、开头逻辑、干货密度与互动话术，提炼核心流量密码与创作要点，严格贴合小红书内容生态与传播逻辑，生成通顺、合规、可直接发布的完整笔记文案，降低创作门槛，高效产出流量内容。仅在主Agent中执行,不派发给子Agent。
---
# 小红书笔记创作
- ## 自我介绍
+ ## 1. 简介
- 当用户询问"你的技能是什么"、"你能做什么"、"你的触发条件是什么"等问题时，请回答：
+ 专为小红书内容创作打造的一站式笔记生成工具 -- 基于全网每日持续收录的 2000+ 条爆款笔记数据，根据用户输入关键词精准检索热门爆款笔记，通过 AI 深度复盘爆款内容的结构、开头逻辑、干货密度与互动话术，提炼核心流量密码与创作要点，生成通顺、合规、可直接发布的完整笔记文案。
- **我的技能**：专为小红书内容创作打造的一站式笔记生成工具，基于全网每日持续收录的2000+条爆款笔记数据，根据用户输入关键词，精准检索查询平台当下热门爆款笔记，通过AI深度复盘爆款内容的结构、开头逻辑、干货密度与互动话术，提炼核心流量密码与创作要点，严格贴合小红书内容生态与传播逻辑，生成通顺、合规、可直接发布的完整笔记文案，降低创作门槛，高效产出流量内容。
+ **适用对象**：小红书创作者、内容运营、品牌方内容团队、需要高效产出流量内容的个人或团队。
- **触发条件**：当用户说"帮我写一篇关于XX的小红书笔记"、"生成XX相关的文案内容"等文案生成类需求时使用。
+ ---
- ## 任务目标
+ ## 2. 功能特性
- 1. **查询爆款**：根据用户关键词查询小红书热门笔记
- 2. **分析规律**：从爆款数据中提炼流量密码与创作要点
- 3. **生成文案**：基于爆款规律生成可发布的文案内容
+ **核心功能**：
- ## 触发条件
+ - 爆款笔记查询 -- 基于关键词搜索小红书热门笔记，最多获取 50 条数据
+ - 爆款规律分析 -- 从标题、内容结构、互动引导、标签策略等维度提炼流量密码
+ - 智能内容生成 -- 生成完整的推荐标题（3-6 个）、正文内容、推荐标签（5-10 个）
+ - 个人风格融合 -- 支持用户上传个人写作样本，融合其风格到生成的文案中
+ - 爆款公式溯源 -- 输出参考的爆款规律和核心参考笔记
- 当用户询问以下场景时使用本 Skill：
+ **特色亮点**：
- - "帮我找 XXX 的爆款笔记"
- - "分析 XXX 的爆款规律"
- - "帮我写一篇 XXX 的文案"
- - "生成 XXX 相关的笔记内容"
+ - 泛化词拓展策略：对大类词推荐 10 个细分方向
+ - 数据不足自动扩展时间范围（禁止换词）
+ - 严格输出格式：推荐标题 + 正文内容 + 推荐标签 + 爆款公式来源
+ - 输出前自检查机制：确保所有字段完整
+ - 搜索最新热点补充创作素材
- ## 鉴权
+ ---
+ ## 3. 一键安装
+
+ ### 鉴权
+
#### 获取 API Key
请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取API KEY
#### 配置 API Key
- 方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：
+ 方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中
```bash
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
```
- 方案2: 终端配置
+ 方案2: 终端配置：export REDFOX_API_KEY="ak_xxxx..."
```bash
export REDFOX_API_KEY="ak_xxxx..."
```
- ## 重要数据说明
+ ### 依赖安装
- - 数据库仅包含昨天至30天前的数据
- - 默认时间范围为最近7天（today-6天）
- - 数据不足时自动扩展时间范围
+ 无需额外安装，使用 Python 标准库即可运行。
- ## 操作流程
+ ---
- ### Step 1: 查询爆款笔记
+ ## 4. 使用指南
- #### 1.1 关键词处理
+ ### 基础使用
- **核心规则：优先提取用户描述中的细分方向词，而非泛化的大类词**
+ **触发条件**：当用户说 "帮我写一篇关于 XX 的小红书笔记"、"生成 XX 相关的文案内容" 等文案生成类需求时使用。
- 1. **无赛道关键词**（如"最近热门笔记有哪些"、"看看热门数据"）→ 关键词传空字符串 `""`，查询全站热门
- 2. **有赛道关键词** → 提取精确搜索关键词：
- - **细分词/垂直赛道**（含具体场景/属性修饰，如"职场穿搭"、"减脂餐"）→ 直接搜索
- - **泛化词/大类**（纯大类词，如"穿搭"、"美食"、"美妆"）→ 先推荐细分方向，等待用户选择后再查询
+ **核心规则**：仅在主 Agent 中执行，不派发给子 Agent。
- **泛化词拓展**：
+ ### 完整操作流程
- - 输出10个细分方向词（覆盖不同场景：趋势词、人群词、场景词、意图词各2-3个）
- - 必须等待用户回复后再调用脚本，禁止自动执行
+ **Step 1：查询爆款笔记**
- #### 1.2 时间范围
+ **1.1 关键词处理**：
- - 默认最近7天（`startDate = 今天 - 7天`）
- - 近N天：`startDate = 今天 - N天`
- - 数据不足时自动扩展时间范围（优先扩展时间，禁止换词）：
- - 近1天 → 近3天 → 近7天 → 近30天
+ - 无赛道关键词（如 "最近热门笔记有哪些"）-> 关键词传空字符串 `""`，查询全站热门
+ - 有赛道关键词 -> 提取精确搜索关键词：
+ - 细分词 / 垂直赛道 -> 直接搜索
+ - 泛化词 / 大类（如 "穿搭"、"美食"）-> 先推荐 10 个细分方向，等待用户选择后再查询
- #### 1.3 调用脚本
+ **1.2 时间范围**：
+ - 默认最近 7 天（`startDate = 今天 - 7 天`）
+ - 数据不足时自动扩展时间范围（优先扩展时间，禁止换词）：近 1 天 -> 近 3 天 -> 近 7 天 -> 近 30 天
+
+ **1.3 调用脚本**：
+
```bash
python scripts/fetch_xhs_hot_articles.py \
--keyword "<用户关键词>" \
--max-items 50 \
--page-size 50 \
--start-date "<yyyy-MM-dd>"
```
**参数说明**：
-
- `--keyword`：搜索关键词，无关键词时传空字符串 `""`
- - `--max-items`：固定传 50，获取50条数据用于深度分析
- - `--page-size`：固定传 50，每页获取50条
- - `--start-date`：开始日期，格式 yyyy-MM-dd，默认最近7天
-
- **脚本输出**（JSON 格式输出到控制台）：
+ - `--max-items`：固定传 50，获取 50 条数据用于深度分析
+ - `--page-size`：固定传 50
+ - `--start-date`：开始日期，格式 yyyy-MM-dd
- - `items`：搜索结果列表，每条包含：
- - 基本信息：noteId、title、desc、createTime
- - 作者信息：authorId、authorNickname、authorFans
- - 链接：noteLink（作品链接）、authorLink（作者链接）
- - 互动数据：interactiveCount、likedCount、collectedCount、commentsCount、sharedCount
- - 评分（有关键词时）：totalScore、relevanceScore、popularityScore、recencyScore
+ **脚本输出（JSON 格式输出到控制台）**：
+ - `items`：搜索结果列表（noteId、title、desc、createTime、互动数据、评分等）
- `latestHotArticles`：推荐热门笔记
- `relatedSearches`：拓展词推荐
- 详细字段说明见 [references/xhs_hot_article_format.md](references/xhs_hot_article_format.md)
+ 详细字段说明见 `references/xhs_hot_article_format.md`。
**执行要求**：
-
- 执行脚本后，直接基于输出数据进行分析
- 禁止将原始爆款数据展示给用户
- - 禁止仅发送文件路径或"已保存"等简短提示
+ - 禁止仅发送文件路径或 "已保存" 等简短提示
- ### Step 2: 分析爆款规律
+ **Step 2：分析爆款规律**
- 基于脚本返回的 **50 条数据**进行深度分析，提炼以下规律：
+ 基于脚本返回的 **50 条数据** 进行深度分析：
**标题规律**：
-
- 高互动标题的共同特征（数字使用、情绪词、人群标签）
- 标题长度与结构模式
**内容规律**：
-
- 热门笔记的主题方向与切入角度
- 内容结构与段落分布特点
- 互动引导方式
**标签策略**：
-
- 高频出现的标签类型
- 热门话题标签
**数据分析维度**：
+
| 指标 | 分析要点 |
|------|---------|
| 互动总量 | 高互动内容的核心特征 |
| 收藏率 | 内容实用价值高低 |
| 评论量 | 话题性与互动引导效果 |
| 点赞比 | 情绪共鸣程度 |
| 评分排名 | 有关键词时参考 totalScore 排序 |
- ### Step 3: 引导用户上传个人风格参考
+ **Step 3：引导用户上传个人风格参考**
在生成文案前，**必须**主动询问用户是否提供个人风格参考：
> 想让我更懂你的风格？发几段平时的笔记、日记或随笔给我就行
- **处理方式**：
-
- 若用户提供：分析其写作风格（用词习惯、语气特点、表达方式），融合到生成的文案中
- 若用户不提供：直接基于爆款规律生成文案
- ### Step 4: 生成文案
-
- **必须严格按照爆款规律分析结果进行创作**，生成符合爆款规律的小红书笔记
-
- **创作前的准备**
-
- 1. **回顾爆款规律分析结果**（必须执行）：
- - 提取的高频关键词和热词（必须融入正文）
- - 热门标题模式（必须严格遵循）
- - 爆款内容的结构特征（必须参考）
- - 热门内容风格（必须保持一致）
-
- 2. **搜索最新资讯/热点**（必须执行）：
- - 使用 `web_search` 工具搜索该领域的最新动态、热点事件、深度分析或行业趋势
- - 搜索关键词格式：`小红书 + <选题关键词> + 最新`
- - **必须获取至少1-2个最新热点或资讯作为创作素材**
-
- **撰写小红书笔记内容**（必须遵循爆款规律）
-
- 1. **标题创作**（严格遵循爆款标题模式）：
- - **必须参考**爆款数据中出现最多的标题结构
- - 优先使用数字型标题（如："3个技巧"、"5天见效"）
- - 可使用疑问句引发好奇（如："为什么..."、"居然..."）
- - 可使用感叹句增强情绪（如："太绝了！"、"绝了！"）
- - 标题最多不超过 20 字（包含标点符号，超出必须精简）
-
- 2. **正文创作**（严格遵循爆款内容结构）：
- - **必须融入**爆款数据中出现的高频关键词
- - **必须参考**爆款内容的开头"钩子"手法（如：痛点共鸣、惊人数据、反差对比）
- - **必须保持**爆款内容的写作风格（如：口语化、亲切感、代入感）
- - **必须融入**最新搜索到的热点/资讯，增加时效性和话题度
- - **结构参考**：分点说明、步骤教程、对比展示等
- - **结尾引导**：添加引导互动的话术（如："你们觉得呢？"、"评论区告诉我"）
- - **排版**：良好分段，点缀少量 Emoji（每段 1-2 个），使用简短句子
- - **Tags**：结尾添加 5-10 个相关标签（**注意：Tags 仅用于笔记正文，不渲染到图片中**）
+ **Step 4：生成文案**
- ### Step 5: 输出前自检【必须执行】
+ 必须严格按照爆款规律分析结果进行创作。
- 在输出前,逐项检查输出格式的每一个字段是否完整:
+ **创作前的准备**：
+ 1. 回顾爆款规律分析结果：提取的高频关键词和热词（必须融入正文）、热门标题模式（必须严格遵循）、爆款内容的结构特征、热门内容风格
+ 2. 搜索最新资讯 / 热点：使用 `web_search` 工具搜索 `小红书 + <选题关键词> + 最新`，必须获取至少 1-2 个最新热点或资讯作为创作素材
- - []**推荐标题**:是否包含3-6个推荐标题?
- - []**正文内容**:是否包含完整可发布的正文?
- - []**推荐标签**:是否包含5-10个相关标签?
- - []**爆款公式来源-参考的爆款规律**:是否简述提炼的爆款公式?
- - []**爆款公式来源-参考的爆款笔记**:是否列出2-3篇核心参考笔记,每篇包含笔记标题、作品链接、作者名、作者链接和完整互动数据(收藏/分享/评论/点赞)?
+ **撰写小红书笔记内容**：
+ 1. **标题创作**：严格遵循爆款标题模式，优先使用数字型标题、疑问句、感叹句，标题最多不超过 20 字
+ 2. **正文创作**：必须融入高频关键词，参考爆款开头 "钩子" 手法，融入最新热点资讯，结构参考分点说明 / 步骤教程 / 对比展示，结尾添加引导互动话术，良好分段并点缀少量 Emoji
+ 3. **Tags**：结尾添加 5-10 个相关标签（Tags 仅用于笔记正文，不渲染到图片中）
- 如有任何字段遗漏或不完整,必须补齐后再输出。
+ **Step 5：输出前自检（必须执行）**
- ## 输出格式
+ 在输出前逐项检查：
+ - [ ] **推荐标题**：是否包含 3-6 个推荐标题？
+ - [ ] **正文内容**：是否包含完整可发布的正文？
+ - [ ] **推荐标签**：是否包含 5-10 个相关标签？
+ - [ ] **爆款公式来源 - 参考的爆款规律**：是否简述提炼的爆款公式？
+ - [ ] **爆款公式来源 - 参考的爆款笔记**：是否列出 2-3 篇核心参考笔记（每篇含标题、作品链接、作者名、作者链接、完整互动数据）？
- 最终输出**纯文案内容**，包含：
+ ### 输出格式（必须严格遵守）
```
### 推荐标题
1. [标题1]
2. [标题2]
3. [标题3]
### 正文内容
[完整可发布的正文]
### 推荐标签
#标签1 #标签2 #标签3 #标签4 #标签5
### 爆款公式来源
**参考的爆款规律**：[简述提炼的爆款公式，如"数字型标题 + 痛点开场 + 分点干货 + 互动收尾"]
**参考的爆款笔记**（列出 2-3 篇核心参考笔记，优先选择互动数据最高的笔记）：
1. [笔记标题](noteLink) - [@作者名](authorLink) - 互动数据：收藏 X / 分享 X / 评论 X / 点赞 X
2. [笔记标题](noteLink) - [@作者名](authorLink) - 互动数据：收藏 X / 分享 X / 评论 X / 点赞 X
3. [笔记标题](noteLink) - [@作者名](authorLink) - 互动数据：收藏 X / 分享 X / 评论 X / 点赞 X
```
- **输出格式要求（强制）**：
+ **禁止输出**：卡片设计或图片、脚本执行命令、文件路径或下载链接、仅展示数据而不生成文案。
- - 如果是在子 Agent 中执行，主 Agent 也必须保持此输出格式不变，禁止调整、精简或重新组织
- - 必须严格按照上述结构输出，不得遗漏任何部分（推荐标题、正文内容、推荐标签、爆款公式来源）
- - 爆款公式来源必须包含"参考的爆款规律"和"参考的爆款笔记"两部分
+ ### 高级使用
- **禁止输出**：
+ **数据说明**：数据库仅包含昨天至 30 天前的数据。笔记互动数据截止为入库时间，不是实时数据。
- - 卡片设计或图片
- - 脚本执行命令
- - 文件路径或下载链接
- - 仅展示数据而不生成文案
+ ### 常用指令速查
- ## 使用示例
+ | 场景 | 输入示例 | 处理方式 |
+ | ---- | -------- | -------- |
+ | 细分词直接生成 | "帮我写一篇关于减脂餐的小红书笔记" | 直接搜索生成文案 |
+ | 泛化词需拓展 | "帮我写一篇穿搭相关的文案" | 先推荐 10 个细分方向 |
+ | 融合个人风格 | 用户提供笔记样本后 | 分析风格融合到生成文案中 |
- - 示例1:
- - 场景/输入: 用户说"帮我写一篇关于减脂餐的小红书笔记"
- - 预期产出: 查询"减脂餐"热门笔记 → 分析爆款规律 → 生成符合爆款规律的文案
- - 关键要点: "减脂餐"为细分词，直接搜索
+ ---
- - 示例2:
- - 场景/输入: 用户说"帮我写一篇穿搭相关的文案"
- - 预期产出: 识别"穿搭"为泛化词 → 推荐10个细分方向 → 用户选择后查询 → 分析 → 生成文案
- - 关键要点: "穿搭"为泛化词，需先推荐细分方向
+ ## 5. 使用场景
- ## 资源索引
+ 1. **新手创作者从零开始**：输入选题关键词（如 "减脂餐"），获取基于真实爆款数据分析的可发布完整笔记，直接降低创作门槛。
+ 2. **内容运营批量产出**：输入不同细分关键词，批量生成多篇差异化文案，提高团队产出效率。
+ 3. **品牌方深度定制内容**：提供品牌产品信息和风格样本，生成符合品牌调性同时踩中爆款规律的小红书种草笔记。
+ 4. **创作者优化已有内容**：将已有文案作为风格参考输入，基于最新热点和爆款数据重新生成优化版本，提升内容竞争力。
- - 脚本: 见 [scripts/fetch_xhs_hot_articles.py](scripts/fetch_xhs_hot_articles.py)(用途:调用红狐数据API获取热门笔记数据，输出JSON到stdout)
- - 参考: 见 [references/xhs_hot_article_format.md](references/xhs_hot_article_format.md)(何时读取:了解数据字段格式和输出规范)
+ ---
- ## 注意事项
+ ## 6. 项目架构
- - 严格基于查询到的真实爆款数据进行分析
- - 生成的文案必须遵循提炼出的爆款规律
- - 禁止在文案中添加外部联系方式或违规信息
- - 生成的文案必须符合小红书社区规范
+ ### 目录结构
+
+ ```
+ xiaohongshu-write/
+ ├── SKILL.md # 本文件
+ ├── scripts/
+ │ └── fetch_xhs_hot_articles.py # 调用红狐数据API获取热门笔记数据，输出JSON到stdout
+ └── references/
+ └── xhs_hot_article_format.md # 数据字段格式和输出规范
+ ```
+
+ ### 技术栈
+
+ | 技术 | 用途 |
+ | ---- | ---- |
+ | Python 标准库 | HTTP 请求与数据解析 |
+ | 红狐 API | 小红书爆款笔记数据来源 |
+ | WebSearch | 获取最新热点资讯补充创作素材 |
+ | AI 智能分析 | 爆款规律提炼与文案生成 |
+
+ ### 核心模块说明
+
+ - **fetch_xhs_hot_articles.py**：接收关键词、max-items、page-size、start-date 参数，调用红狐 API 获取热门笔记数据，输出 JSON 格式到 stdout，包含 items（搜索结果）、latestHotArticles（推荐热门笔记）、relatedSearches（拓展词推荐）。
+
+ ### 资源索引
+
+ | 文件 | 用途 |
+ | ---- | ---- |
+ | [scripts/fetch_xhs_hot_articles.py](scripts/fetch_xhs_hot_articles.py) | 调用红狐数据API获取热门笔记数据，输出JSON到stdout |
+ | [references/xhs_hot_article_format.md](references/xhs_hot_article_format.md) | 了解数据字段格式和输出规范时读取 |
+
+ ---
+
+ ## 7. 常见问答
+
+ ### 安装
+
+ **Q: 需要安装什么依赖？**
+ A: 无需额外安装，使用 Python 标准库即可运行。
+
+ **Q: 如何配置 API Key？**
+ A: 请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API KEY，通过环境变量 `REDFOX_API_KEY` 配置。
+
+ ### 使用
+
+ **Q: 为什么不能直接在子 Agent 中执行？**
+ A: 本 Skill 仅限于在主 Agent 中执行，不派发给子 Agent，以确保输出格式的一致性和爆款公式来源的完整性。
+
+ **Q: 数据范围是多少？**
+ A: 数据库仅包含昨天至 30 天前的数据，默认时间范围为最近 7 天。
+
+ **Q: 什么时候会用到 WebSearch？**
+ A: 在创作准备阶段，需要搜索 `小红书 + <选题关键词> + 最新` 获取至少 1-2 个最新热点作为创作素材。
+
+ **Q: 输出必须包含哪些部分？**
+ A: 必须包含推荐标题（3-6 个）、正文内容、推荐标签（5-10 个）、爆款公式来源（参考的爆款规律 + 参考的爆款笔记 2-3 篇）。
+
+ ### 故障排除
+
+ **Q: 生成的文案不符合预期？**
+ A: 提供个人写作样本（平时的笔记、日记或随笔），让系统分析你的风格并融合到生成的文案中。
+
+ **Q: 数据不足怎么办？**
+ A: 自动按近 1 天 -> 近 3 天 -> 近 7 天 -> 近 30 天的顺序扩展时间范围，禁止换词。