xhs-publisher · 帮你自动发小红书
你说主题,AI 写文案、配封面、发帖子——全程不用你动手。
能做什么?
你只需要说一句话,比如:
「帮我发一篇关于五一假期攻略的小红书」
AI 会自动完成:
- ✍️ 写帖子 — 标题、正文、话题标签一次生成
- 🎨 做封面 — 从 6 套精美模板里自动配图
- 👀 给你看 — 发布前展示预览,你来确认
- 🚀 发出去 — 自动登录你的账号,发到小红书
适合任何主题:知识分享、美食、旅行、情感、节日、职场……
第一次用需要准备什么?
只需要两件事:
1. 安装字体(封面图需要)
中文封面图需要 Noto Sans SC 字体,安装方法见 references/setup.md,5 分钟搞定。
2. 登录小红书账号
第一次发帖时,AI 会引导你用手机号 + 验证码登录。登录一次后会自动保存,约 7 天内不用再登录。
💡 验证码只用于登录,不会被记录或上传。
怎么开始?
直接告诉 AI 你想发什么就行:
- 「帮我发一篇清明节的小红书」
- 「发一篇推荐北京咖啡馆的帖子」
- 「写一篇职场新人避坑指南发到小红书」
AI 会全程引导你完成。
6 套封面模板
根据标题自动匹配,每次同样的标题用同一套模板,保持账号风格统一。
| 模板 | 配色 | 适合 |
|---|---|---|
| 🔴 珊瑚红·撞色 | 红白对撞 | 热点、节日、吸睛话题 |
| ⬜ 奶油白·极简 | 白底黑字 | 知识、观点、深度好文 |
| 🌿 墨绿·自然风 | 深绿奶白 | 人文、旅行、生活方式 |
| 🌊 深蓝·知性风 | 深海蓝渐变 | 科普、职场、财经 |
| 💛 柠黄·活力风 | 明黄黑字 | 美食、穿搭、娱乐 |
| 💜 丁香紫·治愈风 | 薰衣草紫 | 情感、心理、治愈系 |
常见问题
Q:我不会写文案也能用吗? 完全可以,告诉 AI 主题,文案由 AI 生成,你只需要最后确认一下。
Q:会不会发出去奇怪的内容? 不会。每次发布前都会展示预览,你确认后才发出去。另外脚本内置安全过滤,会自动拦截人身攻击、煽动对立等违规内容。
Q:登录安全吗?
安全。登录信息只保存在你自己的机器上(~/.openclaw-sessions/xiaohongshu),不会上传到任何地方。
Q:发帖失败怎么办? 失败时会自动保存截图到工作目录,方便排查。常见原因:网络问题、session 过期(重新登录即可)、小红书触发风控(等 30 分钟后重试)。
给开发者
如果你想在自己的代码里调用:
const { generateCoverImage, publishPost } = require('./scripts/xhs_publisher.js');
// 第一步:生成封面图
const imgPath = await generateCoverImage(
'五一去哪儿玩?这几个地方别错过', // 标题(≤20字)
'人少景美还不贵\n亲测三个宝藏目的地\n每个都值得去一次', // 副标题(\n换行)
'/tmp/xhs_cover.png'
);
// 第二步:发布
await publishPost({
title: '五一去哪儿玩?这几个地方别错过',
content: '每年五一都在纠结去哪玩...', // 正文(不含话题标签)
topics: ['五一旅游', '旅行攻略', '小众目的地'], // 3个话题
imagePath: imgPath,
phone: '13812345678', // session 失效时自动触发登录
askCodeFn: async (prompt) => await askUser(prompt), // 返回6位验证码
});
导出函数一览:
| 函数 | 说明 |
|---|---|
generateCoverImage(title, subtitle, outputPath, footer?) |
生成封面图 PNG(1080×1440px) |
publishPost(options) |
发帖到小红书(含安全检查、登录引导) |
loginWithPhone(page, phone, askCodeFn) |
手机号登录(publishPost 内部已自动调用) |
checkContentSafety(title, content) |
独立安全检查,返回 { safe, reason } |
detectPageState(page) |
检测页面状态(已登录/未登录/风控拦截) |
isSessionLikelyValid() |
判断 session 是否在 7 天有效期内 |
环境变量:
| 变量 | 说明 | 默认值 |
|---|---|---|
XHS_PROFILE_DIR |
Session 存储目录 | ~/.openclaw-sessions/xiaohongshu |
XHS_OUTPUT_IMAGE |
封面图默认输出路径 | /tmp/xhs_post_cover.png |
更多配置说明见 references/setup.md,写作规范见 references/posting-guide.md。
