小红书帖子创作与发布技能

概述

快速创作并发布小红书帖子,包括标题、正文、标签、配图,自动上传到小红书平台。

核心特点(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

redbook-creator-publish

Safety Notice

Copy this and send it to your AI assistant to learn