小红书帖子创作与发布技能
概述
快速创作并发布小红书帖子,包括标题、正文、标签、配图,自动上传到小红书平台。
核心特点(v5.3):
- 🚀 极简流程:搜索 → 生成内容 → 获取配图 → 验证图片 → 自动上传
- 🖼️ 智能配图:从网络下载公开图片或 AI 生成
- ✅ 图片验证:自动检测无效图片并删除,确保5-6张有效图片
- 📁 精简输出:只生成 preview.html、config.json、images/
- 🤖 自动上传:直接触发,减少手动确认
- 🔐 登录检测:智能检测登录状态,20秒等待提示
- 🐍 零依赖:Python 原生能力为主
前置检查(第一步,自动执行)
检查 Python
python3 --version # 要求 3.7+全局检测并安装 Playwright
重要: 只在未安装时才安装,避免重复安装
# 检查 playwright 是否已安装(全局检测)
if python3 -c "import playwright" 2>/dev/null; then
echo "✅ Playwright 已安装,跳过安装"
else
echo "📦 正在安装 Playwright 到用户全局环境..."
# 安装到用户全局环境
pip3 install --user playwright
# 安装 Chromium 浏览器
python3 -m playwright install chromium
echo "✅ Playwright 安装完成"
fi检测逻辑:
- 先检查系统是否已安装 playwright 模块
- 如果已安装,跳过安装步骤
- 如果未安装,安装到用户全局环境(
--user) - 只需安装一次,后续使用无需重复安装
输出:✅ 环境检查完成
工作流程
步骤1:深度搜索话题
使用 WebSearch 工具搜索 2-3 个相关关键词,获取最新数据和案例。
步骤2:生成帖子内容
- 标题:不超过20个字符(含emoji),包含钩子词,简洁有力
- 正文:300-500字,开头钩子 → 核心内容 → 总结互动
- 标签:5个(精选核心标签,不要超过5个)
步骤3:获取配图(5-6张)
优先级:
- 从网络下载公开图片(Unsplash/Pexels/Pixabay)
- AI 生成补充(可选,如果模型无法生成则跳过)
要求:
- 数量:5-6张(1封面 + 4-5内容图)
- 命名:cover.png, image_1.png, image_2.png, image_3.png, image_4.png...
- 格式:PNG/JPG
🎯 精准配图关键词生成策略(重要!)
核心原则: 搜索关键词必须高度具体化,避免泛化词汇
关键词生成规则:
- 主体词必须具体化: 不用泛化词,用具体实体名
- ❌ 错误: "游戏" "game" "gaming" - ✅ 正确: "Minecraft" "我的世界方块" "Minecraft Steve"
- 场景/画面词优先: 描述具体画面内容
- ❌ 错误: "美食" "food" - ✅ 正确: "拉面特写" "ramen noodles closeup"
- 英文关键词为主: 图库用英文搜索效果更好
- 将中文主题翻译成对应的英文专有名词 - 游戏:用游戏官方英文名 - 品牌:用品牌英文名
不同主题的关键词构建:
| 主题类型 | 泛化词(❌避免) | 精准词(✅使用) |
|---|---|---|
| 游戏《我的世界》 | game, gaming, 游戏 | Minecraft, Minecraft blocks, Minecraft world, pixel art cube |
| 游戏《原神》 | game, RPG | Genshin Impact, Genshin character, anime game |
| 游戏《王者荣耀》 | MOBA, 手游 | Honor of Kings, MOBA hero |
| 美食-火锅 | food, 美食 | hotpot, Chinese hotpot, spicy pot |
| 旅行-日本 | travel, 旅行 | Tokyo tower, Japan temple, cherry blossom |
| 科技-AI | technology | AI robot, artificial intelligence, neural network |
| 穿搭-韩系 | fashion, 穿搭 | Korean outfit, OOTD, minimalist style |
配图搜索执行步骤:
- 分析帖子主题,提取核心实体(游戏名/品牌名/地点名等)
- 将核心实体转换为英文专有名词
- 组合搜索词:
[英文专有名词] + [画面描述词] - 每张图使用不同角度的关键词组合
示例 - 主题"我的世界游戏":
封面图: "Minecraft world landscape" 或 "Minecraft building"
图1: "Minecraft blocks closeup"
图2: "Minecraft Steve character"
图3: "Minecraft castle build"
图4: "Minecraft pixel art"
图5: "Minecraft survival gameplay"示例 - 主题"火锅推荐":
封面图: "Chinese hotpot restaurant"
图1: "hotpot ingredients fresh"
图2: "spicy hotpot soup"
图3: "hotpot meat slices"
图4: "hotpot dipping sauce"mkdir -p ./redbook-article/[主题]-[日期]/images/
# 使用精准关键词下载图片到 images 目录步骤3.5:验证图片有效性(重要!)
下载完成后必须验证每张图片,删除无效图片并补充下载,确保最终有5-6张有效图片。
import os
import struct
def is_valid_image(file_path):
"""验证图片文件是否有效"""
if not os.path.exists(file_path):
return False
# 检查文件大小(至少1KB)
if os.path.getsize(file_path) < 1024:
return False
try:
with open(file_path, 'rb') as f:
header = f.read(32)
# PNG: 89 50 4E 47 0D 0A 1A 0A
if header[:8] == b'\x89PNG\r\n\x1a\n':
return True
# JPEG: FF D8 FF
if header[:3] == b'\xff\xd8\xff':
return True
# GIF: GIF87a 或 GIF89a
if header[:6] in (b'GIF87a', b'GIF89a'):
return True
# WebP: RIFF....WEBP
if header[:4] == b'RIFF' and header[8:12] == b'WEBP':
return True
except Exception:
return False
return False
def validate_and_clean_images(images_dir):
"""验证并清理无效图片,返回有效图片列表"""
valid_images = []
invalid_images = []
for filename in sorted(os.listdir(images_dir)):
if filename.lower().endswith(('.png', '.jpg', '.jpeg', '.gif', '.webp')):
file_path = os.path.join(images_dir, filename)
if is_valid_image(file_path):
valid_images.append(filename)
print(f"✅ {filename} - 有效")
else:
invalid_images.append(filename)
print(f"❌ {filename} - 无效,已删除")
os.remove(file_path)
return valid_images, invalid_images
# 使用示例
images_dir = '/path/to/images'
valid, invalid = validate_and_clean_images(images_dir)
print(f"\n有效图片: {len(valid)} 张")
print(f"已删除无效图片: {len(invalid)} 张")
# 如果有效图片不足5张,需要补充下载
if len(valid) < 5:
print(f"⚠️ 图片不足,需要补充 {5 - len(valid)} 张")验证流程:
- 下载所有图片后,运行验证脚本
- 删除无效图片(文件头不正确或大小过小)
- 统计有效图片数量
- 如果有效图片少于5张,必须补充下载新图片
- 重复验证直到有5-6张有效图片
步骤4:生成本地文件
目录结构:
redbook-article/
└── [主题]-[日期]/
├── preview.html
├── config.json
└── images/
├── cover.png
├── image_1.png
├── image_2.png
├── image_3.png
└── image_4.png生成 config.json(重要:使用 json.dump 自动转义):
import json
config = {
"title": title,
"content": content, # json.dump 会自动处理转义
"tags": tags,
"cover": "images/cover.png",
"images": ["images/image_1.png", "images/image_2.png", "images/image_3.png", "images/image_4.png"]
}
with open('config.json', 'w', encoding='utf-8') as f:
json.dump(config, f, ensure_ascii=False, indent=2)生成 preview.html(使用 Newsprint 风格模板):
- 读取模板:
/Users/a58/.claude/skills/redbook-creator-publish/assets/preview-template.html - 替换变量:
- {{TITLE}} → 标题 - {{CONTENT}} → 正文 - {{DATE}} → 日期 - {{TAGS}} → 标签HTML(每个标签包裹在 <span class="tag"> 中)
- 添加封面图和配图的
<img>标签 - 保存为
preview.html
步骤5:自动上传到小红书
重要:必须触发自动上传,即使前面有错误也要尝试。
python3 /Users/a58/.claude/skills/redbook-creator-publish/scripts/auto_upload_playwright.py \
--config ./redbook-article/[主题]-[日期]/config.json流程(v5.1 优化):
- 打开小红书创作者平台
- 智能登录检测:
- 自动检测上传控件DOM是否存在 - 如未登录,提示用户在 20 秒内登录 - 每秒检测一次,登录成功后自动继续 - 20 秒后仍未检测到控件,退出并提示手动上传
- 上传图片(cover.png 第一张)
- 填写标题
- 填写正文
- 逐个输入标签(间隔1秒+回车)
- 点击发布
- 浏览器保持打开(不自动关闭)
注意事项
内容创作
- 标题:不超过20个字符(含emoji)
- 正文字数:300-500字
- 配图数量:5-6张(1封面+4-5副图)
- 标签:5个(不要超过5个)
- 图片来源:公开免费图库或 AI 生成
- 图片验证:下载后必须验证有效性,删除无效图片并补充
自动上传(v5.1)
- 必须触发上传脚本
- 首次使用:在20秒提示期内登录小红书账号
- 后续使用:自动保持登录,无需重复登录
- 标签间隔 1 秒并回车
- 浏览器不会自动关闭,可继续查看或编辑
- 如 20 秒内未登录,请手动上传或重新执行
技术配置
- Python 3.7+
- Playwright(只需安装一次,全局检测)
- config.json 中文符号需正确转义
手动上传备选方案
如果自动上传失败:
- 打开:https://creator.xiaohongshu.com/publish/publish
- 按顺序上传图片(cover.png 第一张)
- 从 preview.html 复制标题和正文
- 添加标签
- 点击发布
参考文档
- references/style-guide.md - 小红书内容风格规范
- scripts/auto_upload_playwright.py - Playwright 自动上传脚本
- assets/preview-template.html - Newsprint 风格预览模板
更新日志
v5.4 (2026-01-27)
- ✅ 新增精准配图关键词生成策略
- ✅ 添加不同主题的关键词构建规则表
- ✅ 强调使用英文专有名词搜索
- ✅ 提供游戏/美食/旅行等主题的搜索关键词示例
- ✅ 更新style-guide.md增加主题精准匹配原则
v5.3 (2026-01-27)
- ✅ 新增图片有效性验证(检测文件头和大小)
- ✅ 自动删除无效图片并提示补充下载
- ✅ 配图数量调整为5-6张(1封面+4-5副图)
- ✅ 添加 allowedCommands 配置,减少手动确认提示
v5.2 (2026-01-27)
- ✅ 标题限制改为20个字符(含emoji)
- ✅ 标签数量从8-10个改为5个
- ✅ 配置自动批准权限,减少确认提示
v5.1 (2026-01-27)
- ✅ 新增智能登录检测(检测上传控件DOM)
- ✅ 20秒登录等待提示,每秒检测
- ✅ 浏览器不自动关闭,保持打开状态
- ✅ Playwright 全局安装检测,避免重复安装
v5.0 (2026-01-27)
- 极简版发布
版本:v5.4(精准配图版) 更新日期:2026-01-27