xiaohongshu ｜小红书 AI 宣传图和图文笔记技能

API key required

小红书 AI 宣传图和图文笔记技能 - 根据用户提示词判断生成单张或多张宣传图，调用 gpt-image-2 生成视觉素材并合成小红书图片；仅在用户明确要求发布到小红书时才执行发布。

Install

openclaw skills install xiaohongshu-ai

小红书 AI 宣传图和图文笔记技能

一体化工作流：理解用户意图 → 主题和文案生成 → gpt-image-2 直接生成单张或多张宣传图 → 按需发布

🎯 使用场景

用户需要创建小红书宣传图、封面图、产品推广图或图文笔记时
用户只提供一段产品、服务、活动、知识点或个人经历描述，需要自动转成小红书图文内容
需要 AI 直接生成贴合主题的单张海报或多张组图
批量创作多条笔记素材

🧭 意图判定与执行规则

先根据用户提示词判断目标，再选择生成和发布动作：

只生成不发布是默认行为。用户没有明确说“发布到小红书”“帮我发小红书”“生成并发布”“发到小红书账号”等发布意图时，只生成图片和文案，不运行 scripts/publish_xhs.py。
只有明确要求发布到小红书才发布。即使生成了标题、描述和 Tags，也不能自动发布；发布前必须能从用户原话中判断出发布意图。
单张宣传图：用户说“一张”“单张”“封面”“海报”“主图”“宣传图”且没有要求组图时，生成一张主宣传图/封面图。
多张宣传图：用户说“多张”“组图”“轮播”“N 张”“一套”“系列图”时，按用户指定数量生成；未指定数量时生成封面 + 3-5 张正文卡片，总数不超过 9 张。
图文笔记：用户要求“小红书笔记”“种草文”“发布文案”“带正文分页”时，生成封面、正文卡片、发布描述和 Tags。
发布内容来源：发布时使用生成目录里的 manifest.json 读取标题和 publish_desc，图片按 cover.png、card_*.png 顺序上传，最多 9 张。

执行顺序：

理解用户提示词，确定主题、受众、卖点、语气、是否单张/多张、是否发布。
调用 gpt-image-2 直接生成贴合主题的小红书规格宣传图。
保存 cover.png / card_*.png 和 manifest.json。
仅当用户明确要求发布到小红书时，再运行发布脚本。

✨ 核心功能

1️⃣ 智能内容创作

根据用户输入自动生成：

标题：不超过 20 字，吸引眼球，制造好奇心
主题：自动选择适合的视觉主题
正文分页：多图时按卡片天然拆页，短句、强重点、适量 Emoji
发布文案：生成描述和 SEO Tags

2️⃣ AI 宣传图生成

默认调用 gpt-image-2
直接生成竖版、无 Logo、无水印的最终宣传图
单张输出 cover.png，多张输出 cover.png + card_*.png

3️⃣ 图片输出

封面图：3:4 比例，默认 1024×1536px
正文图：多张宣传图自动拆页，最多 9 张

4️⃣ 明确授权后发布

自动登录（使用 Cookie）
上传图片（最多 9 张）
设置标题、描述、Tags
发布后返回笔记链接
不允许在用户未明确要求发布时自动发布

🚀 快速开始

方式一：一句话自动生成（推荐）

# 需要 OPENAI_API_KEY
export OPENAI_API_KEY="your_api_key"

python3 scripts/generate_xhs.py \
  "给 蒙语 AI 翻译 API 写一篇小红书推广笔记，突出一个 API Key 搞定翻译、OCR 和语音识别" \
  -o ./output

生成结果：

output/
├── manifest.json              # 结构化标题、主题、发布文案、Tags 和图片路径
├── cover.png
└── card_*.png

方式二：跳过图片生成，只生成结构化内容

python3 scripts/generate_xhs.py "你的描述" -o ./output --skip-image

方式三：指定单张或多张宣传图

# 单张宣传图，只输出 cover.png
python3 scripts/generate_xhs.py "你的描述" -o ./output --image-count 1

# 多张组图，总数包含封面，最多 9 张
python3 scripts/generate_xhs.py "你的描述" -o ./output --image-count 5

📁 文件结构

xiaohongshu-ai/
├── SKILL.md                 # 技能文档
├── scripts/
│   ├── generate_xhs.py      # 自动内容 + AI 宣传图生成脚本
│   └── publish_xhs.py       # 明确要求发布时使用的发布脚本

🤖 自动生成参数

Python 脚本参数

参数	说明	默认值
`description`	用户输入的文字描述	必填或使用 `--input-file`
`--input-file`	从文件读取描述	无
`--output-dir`, `-o`	输出目录	`./output`
`--text-model`	主题和正文生成模型	`gpt-5-mini` 或 `XHS_TEXT_MODEL`
`--image-model`	宣传图生成模型	`gpt-image-2` 或 `XHS_IMAGE_MODEL`
`--image-size`	宣传图尺寸	`1024x1536`
`--image-quality`	宣传图质量	`high`
`--skip-image`	不调用图片模型，只生成 `manifest.json`	关闭
`--image-count`	目标输出图片总数，包含封面；单张宣传图使用 `1`	不限制，按内容自动生成

常用命令

# 自动生成宣传图
python3 scripts/generate_xhs.py "你的描述" -o ./output

# 生成单张宣传图
python3 scripts/generate_xhs.py "你的描述" -o ./output --image-count 1

# 生成 5 张组图
python3 scripts/generate_xhs.py "你的描述" -o ./output --image-count 5

# 从文件读取需求描述
python3 scripts/generate_xhs.py --input-file brief.txt -o ./output

# 指定模型
python3 scripts/generate_xhs.py "你的描述" --text-model gpt-5-mini --image-model gpt-image-2

📤 发布参数

发布是独立步骤，只能在用户明确要求“发布到小红书”时执行。

python3 scripts/publish_xhs.py \
  --title "笔记标题" \
  --desc "笔记描述 #标签 1 #标签 2" \
  --images cover.png card_1.png card_2.png

前置条件

配置 OpenAI API Key：
- export OPENAI_API_KEY="your_api_key"
配置 Cookie（发布时二选一）：
- 环境变量：export XHS_COOKIE="your_cookie_string"
- 文件存储：memory/xhs-cookie.md（推荐）
获取 Cookie：
- 浏览器登录 https://www.xiaohongshu.com
- F12 → Network → 查看请求头 Cookie
- 复制完整 Cookie 字符串

⚠️ 注意事项

图片规格：
- 封面：1080×1440px（3:4）
- 正文卡片：1080×1440px（可动态调整）
- 最多 9 张图片
Cookie 有效期：
- Cookie 有有效期，过期需重新获取
- 建议定期更新 memory/xhs-cookie.md
发布限制：
- 标题不超过 20 字
- 描述不超过 1000 字
- Tags 不超过 10 个
内容规范：
- 遵守小红书社区规范
- 避免违规内容
- 原创内容优先

🔧 依赖安装

pip install openai requests