# Xiaohongshu Rewrite

> 小红书文案改写能力；当用户需要将文案改写为小红书风格时使用

- Skill: `redfox-data/xiaohongshu-rewrite` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add redfox-data/xiaohongshu-rewrite`
- Raw SKILL.md: https://api.skillmd.com/api/skills/redfox-data/xiaohongshu-rewrite/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: redfox-data (https://skillmd.com/u/redfox-data)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/redfox-data/xiaohongshu-rewrite

---


## 简介

小红书文案改写是一款小红书爆款文案生成工具，帮助用户将任意文案智能转换为符合小红书平台调性的高互动率内容。

通过简单的输入，你可以：
- 自动生成吸引人的小红书风格标题
- 为文案添加至少5个不重复的 emoji 表情符号
- 自动附加以 # 开头的 Tags 标签

适用于内容创作者、品牌运营、MCN 机构、小红书博主等需要高效产出小红书风格内容的用户。

技术基础：基于 Python 标准库实现，通过 AI 模型按照小红书平台规则进行文案改写。

## 功能特性

### 核心功能
- **🎯 智能标题生成**：自动生成具有吸引力和钩子的小红书风格标题
- **😊 Emoji 润色**：自动为文案添加至少5个不重复的 emoji 表情符号
- **🏷️ Tags 附加**：末尾自动附加以 # 开头的相关标签
- **📝 风格转换**：将任意文案转换为口语化、亲切自然的小红书表达方式

### 特色亮点
- **⚡ 即输即用**：输入原文案，直接输出改写结果，无需询问
- **📊 改写记录上报**：调用红狐 API 自动记录改写次数
- **🔧 规则可定制**：通过 `assets/platform-rules.md` 自定义改写规则

## 🔑 鉴权

### 获取 API Key

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

### 配置 API Key

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

```bash
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
```

方案2: 终端配置

```bash
export REDFOX_API_KEY="ak_xxxx..."
```

> 💡 **说明**：本 skill 仅需要你提供 API Key 用于身份识别，使用完全免费，不会扣除任何积分。若尚未配置 `REDFOX_API_KEY`，运行脚本会提示你配置，按上方步骤操作即可正常使用。

## 一键安装

### 前置条件
- Python 3（路径：`/usr/bin/python3`）
- 无额外依赖，仅使用 Python 标准库（`urllib`、`json`、`re` 等）

### 安装方式
将项目克隆到 Qoder skills 目录即可：

```bash
git clone <repo-url> ~/.qoder/skills/xiaohongshu-rewrite
```

## 使用指南

### 基础使用（3步）

#### 第1步：提供文案
向 Agent 提供需要改写为小红书风格的文案内容：

```
帮我改写这篇小红书文案：这款面霜保湿效果很好，用了一周皮肤明显变水润了
```

文案可以包含产品介绍、使用体验、攻略分享等各类内容。

#### 第2步：自动上报记录
脚本自动向记录接口上报改写记录（上报成功后再进行改写输出，上报失败不影响主流程）：

```bash
python scripts/rewrite.py "这款面霜保湿效果很好，用了一周皮肤明显变水润了"
```

#### 第3步：获取改写结果
Agent 读取 `assets/platform-rules.md` 中的完整规则，严格按照小红书的 **Profile**（角色定位）、**WritingSkills**（写作技巧）、**Rules**（改写规则）、**Workflow**（工作流程）进行文案风格改写，并直接输出结果：

- 内容包含吸引人的标题
- 文中使用 emoji 表情符号（至少5个不重复的 emoji）
- 末尾附加 Tags（以 # 开头）
- 使用口语化表达拉近与读者的距离

输出完成后不再询问用户是否需要调整。

### 脚本命令速查

| 命令 | 说明 |
|------|------|
| `python scripts/rewrite.py prompt` | 输出小红书改写规则 prompt |
| `python scripts/rewrite.py "<文案内容>"` | 上报改写记录 |

### 记录接口说明

| 项目 | 详情 |
|------|------|
| 接口地址 | `https://redfox.hk/story/api/skill/record/save` |
| 调用时机 | 输出改写结果之前 |
| 接口参数 | `source` 固定值 `"小红书文案改写-GitHub"` |
| 网络实现 | 原生 `urllib`，默认 SSL 证书验证 |
| 鉴权 | 需配置 `REDFOX_API_KEY`（免费，不扣积分），经 `X-API-Key` 请求头传入 |
| 失败处理 | 仅打印警告，不影响主流程输出 |

## 使用场景

### 场景1：产品营销文案改写
- **角色**：电商运营
- **需求**：将枯燥的产品说明书转换为小红书种草文
- **使用方式**：输入产品卖点和功能介绍文案
- **预期收益**：获得一篇带 emoji 和标签的种草笔记，提升内容曝光和转化

### 场景2：个人心得分享
- **角色**：小红书博主
- **需求**：将日常使用体验整理为吸引人的小红书笔记
- **使用方式**：输入个人使用体验描述
- **预期收益**：获得结构清晰、有钩子的小红书风格文案

### 场景3：活动推广文案
- **角色**：品牌市场人员
- **需求**：将促销活动信息改写为小红书爆款文案
- **使用方式**：输入活动内容、优惠信息等
- **预期收益**：生成吸引用户点击和参与的活动推广笔记

### 场景4：新人博主冷启动
- **角色**：新入驻小红书的内容创作者
- **需求**：快速掌握小红书爆款文风，降低创作门槛
- **使用方式**：输入想表达的主题或关键信息
- **预期收益**：获得符合平台调性的文案参考，加速账号成长

## 项目架构

### 目录结构
```
xiaohongshu-rewrite/
├── SKILL.md                   # 本文件
├── README.md                  # 用户文档（中文）
├── README.en.md               # 用户文档（英文）
├── assets/
│   └── platform-rules.md      # 小红书改写规则（Profile、WritingSkills、Rules、Workflow）
└── scripts/
    └── rewrite.py             # 辅助脚本（规则提取 + 记录上报）
```

### 核心模块说明

| 模块 | 文件 | 说明 |
|------|------|------|
| 改写规则 | `assets/platform-rules.md` | 定义小红书角色定位、写作技巧、改写规则和工作流程 |
| 辅助脚本 | `scripts/rewrite.py` | 提取平台规则 prompt + 上报改写记录到红狐接口（原生 urllib，默认 SSL 验证） |
| 记录来源 | `source` 参数 | 固定值 `"小红书文案改写-GitHub"`，用于统计来源 |

### 技术栈

| 技术 | 用途 |
|------|------|
| Python 3 | 脚本运行环境 |
| urllib | 原生 HTTP 请求（记录上报） |
| regex | 规则文件解析 |

### 资源索引
- 脚本：`scripts/rewrite.py`（用途：上报改写记录；参数：`prompt` / `<文案内容>`）
- 参考：`assets/platform-rules.md`（何时读取：进行文案改写时）

## 常见问答

### 安装相关
**Q: 需要安装什么依赖？**
A: 无需额外安装，仅使用 Python 标准库。

**Q: Python 版本要求？**
A: Python 3.x，脚本默认使用 `/usr/bin/python3`。

### 使用相关
**Q: 改写结果可以调整吗？**
A: 改写完成后直接输出结果，不提供二次调整。如有不满意，可重新提交文案。

**Q: 输出必须包含 emoji 吗？**
A: 是的，小红书文案必须包含至少5个不重复的 emoji 表情符号。

### 故障排除
**Q: 上报记录失败怎么办？**
A: 上报失败不影响主流程，仅打印警告信息，改写结果照常输出。

**Q: 规则文件找不到怎么办？**
A: 确认 `assets/platform-rules.md` 文件存在且路径正确。

### 安全与许可
**Q: 上报接口是否需要 API Key？**
A: 需要。脚本从环境变量 `REDFOX_API_KEY` 读取 Key，并通过 `X-API-Key` 请求头传给接口；使用完全免费，不会扣除积分。未配置时运行脚本会提示你配置，请先执行 `export REDFOX_API_KEY=<你的apikey>`。