小红书自动发布工具包 (Xiaohongshu Publish Kit)
通过 OpenClaw 托管浏览器实现小红书图文笔记的完全自动化发布。支持AI内容生成、封面制作、格式化和一键发布。
功能特性
✨ 完整自动化流程
- 自动登录检测和页面导航
- 智能图片上传（支持多张图片）
- 标题和正文自动填写
- 发布状态验证
🎨 内容创作支持
- 自动生成科技风封面图片
- AI内容格式化（适配小红书规范）
- 话题标签自动插入
- 字数限制自动检查
🔧 开发者友好
- 完整的Python脚本示例
- 详细的浏览器控制命令
- 错误处理和重试机制
- 可扩展的模块化设计
平台限制（严格遵守）
⚠️ 小红书平台规则
- 标题：最多 20 个字符（超出导致发布失败）
- 正文：最多 1000 个字符
- 图片：1-18张，最大32MB，推荐png/jpg/jpeg/webp
- 尺寸：推荐3:4至2:1，分辨率≥720x960
快速开始
1. 环境准备
# 启动托管浏览器
browser --browser-profile openclaw start
# 创建图片上传目录
mkdir -p /tmp/openclaw/uploads
2. 登录小红书创作平台
首次使用需要手动登录一次：
browser --browser-profile openclaw navigate https://creator.xiaohongshu.com
手动扫码登录后，可设置自动保活：
# 设置登录保活（推荐）
./scripts/setup_keepalive.sh
3. 登录保活设置（重要）
为避免频繁扫码，强烈建议设置自动保活：
方法1: Crontab 定时保活（推荐）
./scripts/setup_keepalive.sh
# 选择选项1，每30分钟自动检查登录状态
方法2: 手动检查
python3 scripts/login_keeper.py --mode check
方法3: 守护进程
python3 scripts/login_keeper.py --mode daemon --interval 30
3. 使用脚本发布
python3 ~/.openclaw/workspace/skills/xiaohongshu-publish-kit/scripts/publish.py \
--title "你的标题（≤20字）" \
--content "你的正文内容（≤1000字）" \
--image "/path/to/your/cover.jpg"
或者使用AI辅助发布：
python3 ~/.openclaw/workspace/skills/xiaohongshu-publish-kit/scripts/ai_publish.py \
--topic "AI技术发展" \
--generate-cover
详细使用说明
浏览器控制流程
小红书发布涉及多个步骤的浏览器操作，每步都有特定的技术要求：
Step 1: 页面导航
browser --browser-profile openclaw navigate https://creator.xiaohongshu.com/publish/publish
browser --browser-profile openclaw wait 3000
Step 2: 切换到图文模式
⚠️ 重要：必须使用JS方式点击，直接click会触发文件选择器
browser --browser-profile openclaw evaluate --fn "() => {
const tabs = document.querySelectorAll('.creator-tab, [class*=tab]');
for (const t of tabs) {
if (t.textContent.trim().includes('上传图文')) {
t.click();
return 'switched to image-text mode';
}
}
return 'tab not found';
}"
Step 3: 上传图片
# 先arm文件，再点击按钮
browser --browser-profile openclaw upload /tmp/openclaw/uploads/cover.jpg
browser --browser-profile openclaw snapshot # 找到上传按钮的ref
browser --browser-profile openclaw click <upload_button_ref>
browser --browser-profile openclaw wait 5000 # 等待上传完成
Step 4: 填写标题
标题是<input>元素，需要使用原生setValue方式：
browser --browser-profile openclaw evaluate --fn "() => {
const el = document.querySelector('input[placeholder*=\"标题\"]');
if (!el) return 'title input not found';
const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
setter.call(el, '你的标题内容');
el.dispatchEvent(new Event('input', {bubbles:true}));
el.dispatchEvent(new Event('change', {bubbles:true}));
return 'title set, length=' + el.value.length;
}"
Step 5: 填写正文
正文是contenteditable富文本编辑器，使用innerHTML：
browser --browser-profile openclaw evaluate --fn "() => {
const el = document.querySelector('.ql-editor, [contenteditable=true], .ProseMirror');
if (!el) return 'editor not found';
el.focus();
el.innerHTML = '<p>第一段</p><p><br></p><p>第二段</p><p><br></p><p>#话题标签</p>';
el.dispatchEvent(new Event('input', {bubbles:true}));
return 'body set, length=' + el.textContent.length;
}"
Step 6: 发布验证
# 检查字数是否合规
browser --browser-profile openclaw evaluate --fn "() => {
const titleEl = document.querySelector('input[placeholder*=\"标题\"]');
return 'title length=' + (titleEl ? titleEl.value.length : 0);
}"
# 点击发布
browser --browser-profile openclaw evaluate --fn "() => {
const btns = document.querySelectorAll('button');
for (const b of btns) {
if (b.textContent.trim() === '发布') {
b.click();
return 'publish clicked';
}
}
return 'publish button not found';
}"
# 验证发布成功（URL包含published=true）
browser --browser-profile openclaw tabs
高级功能
自动封面生成
使用内置的封面生成功能：
from scripts.cover_generator import generate_tech_cover
# 生成蓝紫科技风封面
cover_path = generate_tech_cover(
title="AI热点速递",
date="2026.03.17",
style="tech_blue"
)
内容格式化
from scripts.content_formatter import format_for_xiaohongshu
# 自动格式化内容
formatted = format_for_xiaohongshu(
title="原始标题可能很长需要截断",
content="原始内容...",
tags=["AI", "科技", "热点"]
)
批量发布
from scripts.batch_publisher import BatchPublisher
publisher = BatchPublisher()
publisher.add_post(title="标题1", content="内容1", image="图片1")
publisher.add_post(title="标题2", content="内容2", image="图片2")
publisher.publish_all()
常见问题
Q: 发布按钮点击无反应？
A: 检查标题是否超过20字，或正文是否为空。小红书会禁用不合规的发布。
Q: 图片上传失败？
A: 确认图片格式（png/jpg/jpeg/webp）和大小（<32MB），避免使用gif。
Q: 登录状态丢失？
A: 重新在托管浏览器中扫码登录一次即可。
Q: 页面加载缓慢？
A: 增加等待时间，或检查网络连接。
扩展开发
添加新的封面样式
在scripts/cover_generator.py中添加新的样式模板：
def generate_custom_cover(title, **kwargs):
# 你的自定义封面逻辑
pass
集成其他内容源
实现ContentProvider接口：
class MyContentProvider(ContentProvider):
def fetch_content(self):
# 返回格式化的内容
pass
许可证
MIT License - 可自由使用、修改和分发。
注意：本工具仅供学习和合法使用，请遵守小红书平台规则和相关法律法规。
