小红书自动发布工具包 (Xiaohongshu Publish Kit)

小红书自动发布工具包 (Xiaohongshu Publish Kit)

通过 OpenClaw 托管浏览器实现小红书图文笔记的完全自动化发布。支持AI内容生成、封面制作、格式化和一键发布。

功能特性

✨ 完整自动化流程

自动登录检测和页面导航 智能图片上传（支持多张图片） 标题和正文自动填写 发布状态验证

🎨 内容创作支持

自动生成科技风封面图片 AI内容格式化（适配小红书规范） 话题标签自动插入 字数限制自动检查

🔧 开发者友好

完整的Python脚本示例 详细的浏览器控制命令 错误处理和重试机制 可扩展的模块化设计 平台限制（严格遵守）

⚠️ 小红书平台规则

标题：最多 20 个字符（超出导致发布失败） 正文：最多 1000 个字符 图片：1-18张，最大32MB，推荐png/jpg/jpeg/网页p 尺寸：推荐3:4至2:1，分辨率≥720x960 快速开始

• 环境准备

# 启动托管浏览器 browser --browser-性能分析 OpenClaw 启动

# 创建图片上传目录 mkdir -p /tmp/OpenClaw/上传s

• 登录小红书创作平台

首次使用需要手动登录一次：

browser --browser-性能分析 OpenClaw navigate https://创建器.xiaohongshu.com

手动扫码登录后，可设置自动保活：

# 设置登录保活（推荐） ./scripts/设置up_keepalive.sh

• 登录保活设置（重要）

为避免频繁扫码，强烈建议设置自动保活：

方法1: Crontab 定时保活（推荐）

./scripts/设置up_keepalive.sh # 选择选项1，每30分钟自动检查登录状态

方法2: 手动检查

python3 scripts/记录in_keeper.py --mode 检查

方法3: 守护进程

python3 scripts/记录in_keeper.py --mode daemon --interval 30

• 使用脚本发布

python3 ~/.OpenClaw/workspace/技能s/xiaohongshu-publish-kit/scripts/publish.py \ --title "你的标题（≤20字）" \ --content "你的正文内容（≤1000字）" \ --image "/path/to/your/cover.jpg"

或者使用AI辅助发布：

python3 ~/.OpenClaw/workspace/技能s/xiaohongshu-publish-kit/scripts/AI_publish.py \ --topic "AI技术发展" \ --生成-cover

详细使用说明 浏览器控制流程

小红书发布涉及多个步骤的浏览器操作，每步都有特定的技术要求：

Step 1: 页面导航 browser --browser-性能分析 OpenClaw navigate https://创建器.xiaohongshu.com/publish/publish browser --browser-性能分析 OpenClaw wAIt 3000

Step 2: 切换到图文模式

⚠️ 重要：必须使用JS方式点击，直接命令行工具ck会触发文件选择器

browser --browser-性能分析 OpenClaw evaluate --fn "() => { const tabs = document.查询SelectorAll('.创建器-tab, [class=tab]'); for (const t of tabs) { if (t.textContent.trim().includes('上传图文')) { t.命令行工具ck(); return 'switched to image-text mode'; } } return 'tab not found'; }"

Step 3: 上传图片 # 先arm文件，再点击按钮 browser --browser-性能分析 OpenClaw 上传 /tmp/OpenClaw/上传s/cover.jpg browser --browser-性能分析 OpenClaw snapshot # 找到上传按钮的ref browser --browser-性能分析 OpenClaw 命令行工具ck <上传_button_ref> browser --browser-性能分析 OpenClaw wAIt 5000 # 等待上传完成

Step 4: 填写标题

标题是<输入>元素，需要使用原生设置Value方式：

browser --browser-性能分析 OpenClaw evaluate --fn "() => { const el = document.查询Selector('输入[placeholder=\"标题\"]'); if (!el) return 'title 输入 not found'; const 设置ter = Object.获取OwnPropertyDescriptor(window.HTML输入Element.prototype, 'value').设置; 设置ter.call(el, '你的标题内容'); el.dis补丁Event(new Event('输入', {bubbles:true})); el.dis补丁Event(new Event('change', {bubbles:true})); return 'title 设置, length=' + el.value.length; }"

Step 5: 填写正文

正文是contenteditable富文本编辑器，使用innerHTML：

browser --browser-性能分析 OpenClaw evaluate --fn "() => { const el = document.查询Selector('.ql-editor, [contenteditable=true], .ProseMirror'); if (!el) return 'editor not found'; el.focus(); el.innerHTML = '

第一段

第二段

#话题标签

'; el.dis补丁Event(new Event('输入', {bubbles:true})); return 'body 设置, length=' + el.textContent.length; }"

Step 6: 发布验证 # 检查字数是否合规 browser --browser-性能分析 OpenClaw evaluate --fn "() => { const titleEl = document.查询Selector('输入[placeholder=\"标题\"]'); return 'title length=' + (titleEl ? titleEl.value.length : 0); }"

# 点击发布 browser --browser-性能分析 OpenClaw evaluate --fn "() => { const btns = document.查询SelectorAll('button'); for (const b of btns) { if (b.textContent.trim() === '发布') { b.命令行工具ck(); return 'publish 命令行工具cked'; } } return 'publish button not found'; }"

# 验证发布成功（URL包含published=true） browser --browser-性能分析 OpenClaw tabs

高级功能 自动封面生成

使用内置的封面生成功能：

from scripts.cover_生成器 导入 生成_tech_cover

# 生成蓝紫科技风封面 cover_path = 生成_tech_cover( title="AI热点速递", date="2026.03.17", style="tech_blue" )

内容格式化 from scripts.content_格式化器 导入 格式化_for_xiaohongshu

# 自动格式化内容 格式化ted = 格式化_for_xiaohongshu( title="原始标题可能很长需要截断", content="原始内容...", tags=["AI", "科技", "热点"] )

批量发布 from scripts.batch_publisher 导入 BatchPublisher

publisher = BatchPublisher() publisher.添加_post(title="标题1", content="内容1", image="图片1") publisher.添加_post(title="标题2", content="内容2", image="图片2") publisher.publish_all()

常见问题 Q: 发布按钮点击无反应？

A: 检查标题是否超过20字，或正文是否为空。小红书会禁用不合规的发布。

Q: 图片上传失败？

A: 确认图片格式（png/jpg/jpeg/网页p）和大小（<32MB），避免使用gif。

Q: 登录状态丢失？

A: 重新在托管浏览器中扫码登录一次即可。

Q: 页面加载缓慢？

A: 增加等待时间，或检查网络连接。

扩展开发 添加新的封面样式

在scripts/cover_生成器.py中添加新的样式模板：

def 生成_custom_cover(title, *kwargs): # 你的自定义封面逻辑 pass

集成其他内容源

实现Content提供者接口：

class MyContent提供者(Content提供者): def fetch_content(self): # 返回格式化的内容 pass

许可证

MIT License - 可自由使用、修改和分发。

注意：本工具仅供学习和合法使用，请遵守小红书平台规则和相关法律法规。