name: xiaohongshu-write
description: 专为小红书内容创作打造的一站式笔记生成工具，基于全网每日持续收录的2000+条爆款笔记数据，根据用户输入关键词，精准检索查询平台当下热门爆款笔记，通过AI深度复盘爆款内容的结构、开头逻辑、干货密度与互动话术，提炼核心流量密码与创作要点，严格贴合小红书内容生态与传播逻辑，生成通顺、合规、可直接发布的完整笔记文案，降低创作门槛，高效产出流量内容。仅在主Agent中执行,不派发给子Agent。
专为小红书内容创作打造的一站式笔记生成工具 -- 基于全网每日持续收录的 2000+ 条爆款笔记数据，根据用户输入关键词精准检索热门爆款笔记，通过 AI 深度复盘爆款内容的结构、开头逻辑、干货密度与互动话术，提炼核心流量密码与创作要点，生成通顺、合规、可直接发布的完整笔记文案。
适用对象：小红书创作者、内容运营、品牌方内容团队、需要高效产出流量内容的个人或团队。
核心功能：
特色亮点：
请前往 红狐hub 获取API KEY
方案1: 以OpenClaw为例，将REDFOXAPIKEY添加到~/.openclaw/openclaw.json中
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }方案2: 终端配置：export REDFOXAPIKEY="ak_xxxx..."
export REDFOX_API_KEY="ak_xxxx..."无需额外安装，使用 Python 标准库即可运行。
触发条件：当用户说 "帮我写一篇关于 XX 的小红书笔记"、"生成 XX 相关的文案内容" 等文案生成类需求时使用。
核心规则：仅在主 Agent 中执行，不派发给子 Agent。
Step 1：查询爆款笔记
1.1 关键词处理：
""，查询全站热门1.2 时间范围：
startDate = 今天 - 7 天）1.3 调用脚本：
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--start-date：开始日期，格式 yyyy-MM-dd脚本输出（JSON 格式输出到控制台）：
items：搜索结果列表（noteId、title、desc、createTime、互动数据、评分等）latestHotArticles：推荐热门笔记relatedSearches：拓展词推荐详细字段说明见 references/xhs_hot_article_format.md。
执行要求：
Step 2：分析爆款规律
基于脚本返回的 50 条数据 进行深度分析：
标题规律：
内容规律：
标签策略：
数据分析维度：
| 指标 | 分析要点 |
|------|---------|
| 互动总量 | 高互动内容的核心特征 |
| 收藏率 | 内容实用价值高低 |
| 评论量 | 话题性与互动引导效果 |
| 点赞比 | 情绪共鸣程度 |
| 评分排名 | 有关键词时参考 totalScore 排序 |
Step 3：引导用户上传个人风格参考
在生成文案前，必须主动询问用户是否提供个人风格参考：
想让我更懂你的风格？发几段平时的笔记、日记或随笔给我就行
Step 4：生成文案
必须严格按照爆款规律分析结果进行创作。
创作前的准备：
web_search 工具搜索 小红书 + <选题关键词> + 最新，必须获取至少 1-2 个最新热点或资讯作为创作素材撰写小红书笔记内容：
Step 5：输出前自检（必须执行）
在输出前逐项检查：
### 推荐标题
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禁止输出：卡片设计或图片、脚本执行命令、文件路径或下载链接、仅展示数据而不生成文案。
数据说明：数据库仅包含昨天至 30 天前的数据。笔记互动数据截止为入库时间，不是实时数据。
| 场景 | 输入示例 | 处理方式 |
| ---- | -------- | -------- |
| 细分词直接生成 | "帮我写一篇关于减脂餐的小红书笔记" | 直接搜索生成文案 |
| 泛化词需拓展 | "帮我写一篇穿搭相关的文案" | 先推荐 10 个细分方向 |
| 融合个人风格 | 用户提供笔记样本后 | 分析风格融合到生成文案中 |
xiaohongshu-write/
├── SKILL.md # 本文件
├── scripts/
│ └── fetch_xhs_hot_articles.py # 调用红狐数据API获取热门笔记数据，输出JSON到stdout
└── references/
└── xhs_hot_article_format.md # 数据字段格式和输出规范| 技术 | 用途 |
| ---- | ---- |
| Python 标准库 | HTTP 请求与数据解析 |
| 红狐 API | 小红书爆款笔记数据来源 |
| WebSearch | 获取最新热点资讯补充创作素材 |
| AI 智能分析 | 爆款规律提炼与文案生成 |
| 文件 | 用途 |
| ---- | ---- |
| scripts/fetch<em>xhs</em>hot<em>articles.py | 调用红狐数据API获取热门笔记数据，输出JSON到stdout |
| references/xhs<em>hot</em>article<em>format.md | 了解数据字段格式和输出规范时读取 |
Q: 需要安装什么依赖？
A: 无需额外安装，使用 Python 标准库即可运行。
Q: 如何配置 API Key？
A: 请前往 红狐hub 获取 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 天的顺序扩展时间范围，禁止换词。