
Xhs Publisher
- 380 installs
- 2 repo stars
- Updated August 1, 2026
- byheaven/byheaven-skills
xhs-publisher is a Claude Code agent skill that automates Xiaohongshu (RedNote) creator post drafting on creator.xiaohongshu.com for developers who publish Chinese social content via browser automation.
About
Documents the Xiaohongshu creator platform publishing flow, including entry URLs and DOM selectors for short text-with-image posts versus longer article notes. A creator uses it to automate posting content to Xiaohongshu.
- Chooses publish form by content length (under vs over 140 chars)
- Includes creator.xiaohongshu.com entry URLs and DOM selectors
Xhs Publisher by the numbers
- 380 all-time installs (skills.sh)
- Ranked #457 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
- Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/byheaven/byheaven-skills --skill xhs-publisherAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 380 |
|---|---|
| repo stars | ★ 2 |
| Last updated | August 1, 2026 |
| Repository | byheaven/byheaven-skills ↗ |
How do you automate Xiaohongshu creator post publishing?
Publish posts to the Xiaohongshu (RED) creator platform, with the DOM selectors and step-by-step flow for text-with-image and article notes.
Who is it for?
Developers who regularly publish to Xiaohongshu from Obsidian vaults or scripts and want Claude in Chrome to handle DOM-heavy creator form filling.
Skip if: Developers who do not use Xiaohongshu, lack the Claude in Chrome extension, or need fully unattended API-based publishing without browser review.
When should I use this skill?
Trigger when a developer asks to publish or draft a Xiaohongshu post from Obsidian markdown, CLI content, or creator.xiaohongshu.com automation.
What you get
Filled Xiaohongshu creator draft in Chrome with title, body, hashtags, and generated images, stopped before the Publish button for human review.
- Filled Xiaohongshu creator draft in Chrome
- Auto-selected publish flow URL (target=image or target=article)
- Generated 2-3 hashtags appended to body text
By the numbers
- version 0.1.0
- covers 2 publish flows with 8 steps each
- supports posts from 1 to 10000 characters with 20-character title limit
Files
小红书发布技能 (Xiaohongshu Publishing Skill)
本技能文档包含小红书创作者平台的详细发布流程、DOM选择器和操作步骤。
平台概述
平台: 小红书创作者平台 (Xiaohongshu Creator Platform) 域名: creator.xiaohongshu.com
发布形式选择
根据内容长度选择不同的发布入口:
| 内容长度 | 发布形式 | 入口 URL |
|---|---|---|
| < 140字 | 文字配图 | https://creator.xiaohongshu.com/publish/publish?target=image |
| ≥ 140字 | 图文笔记 | https://creator.xiaohongshu.com/publish/publish?target=article |
一、文字配图流程 (< 140字)
流程概览
1. 导航到文字配图入口
2. 点击"文字配图"按钮
3. 输入第一张图片内容(标题)
4. 添加第二张图片并输入正文内容
5. 一次性生成全部图片
6. 选择模板样式并下一步
7. 填写发布信息(标题、正文、标签)
8. 用户确认后发布[!IMPORTANT]
核心流程: 先输入所有内容(标题 + 正文),再一次性生成全部图片。不要每张图片单独生成!
步骤 1: 导航到文字配图入口
URL: https://creator.xiaohongshu.com/publish/publish?target=image
页面加载后会显示"上传图文"选项,包含两个按钮:
- "上传图片"(红色按钮)
- "文字配图"(灰色按钮,带图标)
步骤 2: 点击"文字配图"按钮
查找方法:
find: "文字配图 button"元素特征:
- 类型:
button - 文本: "文字配图"
- 功能: 进入文字生成图片编辑器
操作:
find("文字配图 button")
click()
wait(2)步骤 3: 输入第一张图片内容(标题)
输入框:
find("真诚分享经验或资讯 textbox")操作:
find("真诚分享经验或资讯 textbox")
click()
type(title)
wait(1)步骤 4: 添加第二张图片并输入正文内容
添加第二张图片:
find("再写一张")
click()
wait(1)正文输入框:
find("在这里输入正文 textbox")操作:
find("在这里输入正文 textbox")
click()
type(content)
wait(1)[!NOTE]
此时已输入所有内容(标题 + 正文),准备一次性生成全部图片。
步骤 5: 一次性生成全部图片
生成图片按钮:
find("生成图片 button")操作:
find("生成图片 button")
click()
wait(5) // 等待所有图片生成,时间稍长[!NOTE]
点击"生成图片"会同时生成标题和正文两张图片。不需要分别点击生成。
步骤 6: 选择模板样式并下一步
页面特征:
- 标题: "预览图片"
- 左侧大预览区域显示生成的图片
- 右侧多种模板选项(基础、边框、备忘、涂鸦、手写、光影、简约、便签、印刷、科技等)
- 底部有"下一步"按钮
模板选择:
- 默认选中"边框"模板(蓝色边框高亮)
- 可点击其他模板切换样式
- 自动化流程建议使用默认选中的模板
操作:
// 使用默认选中的模板
find("下一步 button")
click()
wait(2)步骤 7: 填写发布信息
页面标题: "发布图文"
7.1 图片编辑区
特征:
- 显示 "图片编辑 (2/18)" - 表示已添加2张图片,最多18张
- 左侧有"添加"按钮可继续添加图片
- 显示已生成的图片缩略图
7.2 填写标题
标题输入框:
find("填写标题会有更多赞哦 input")操作:
find("填写标题会有更多赞哦 input")
form_input(title)7.3 填充完整正文内容和标签
正文文本框:
find(包含标题的 textbox) // 正文文本框重要说明:
- 正文文本框会自动填充第一张图片的内容(标题)
- 必须替换为完整的正文内容(不是摘要或部分内容)
- 正文内容包括:完整正文 + 两个换行 + 标签
操作:
find(包含标题的 textbox) // 正文文本框
click()
key("cmd+a") // 全选现有内容
type(content + "\n\n" + tags) // 填充完整正文 + 两个换行 + 标签[!WARNING]
标签格式要求: 正文内容和标签之间必须有两个换行(\n\n),否则标签会紧贴正文显示不美观。标签格式:
- 使用
#开头 - 多个标签用空格分隔
- 建议不超过3个标签
- 标签前必须有两个换行符与正文分隔
7.4 其他发布选项
话题按钮:
find: "话题"用户按钮:
find: "用户"表情按钮:
find: "表情"活动话题:
- 页面会显示当前平台的活动话题
- 格式: "# 第五人格五周年春"
- 可选择参与
添加地点:
find: "添加地点"添加合集:
find: "添加合集"关联群聊:
find: "选择群聊"步骤 8: 发布
发布按钮:
find: "发布 button"
element_type: button
color: 红色(主要行动按钮)暂存草稿按钮:
find: "暂存草稿 button"
element_type: button
color: 灰色(次要行动按钮)自动保存:
- 页面会自动保存草稿
- 底部显示"自动保存于 HH:MM"
⚠️ 重要提示: 根据安全策略,自动化脚本应该:
1. 填充所有内容后停止 2. 显示消息提示用户审核 3. 不要自动点击"发布"按钮 4. 由用户自己在浏览器中点击"发布"
二、图文笔记流程 (≥ 140字)
流程概览
1. 导航到图文笔记入口
2. 点击"新的创作"按钮
3. 填写标题
4. 填写正文内容
5. 点击"一键排版"选择模板
6. 填写正文摘录和标签
7. 填写其他发布信息
8. 用户确认后发布步骤 1: 导航到图文笔记入口
URL: https://creator.xiaohongshu.com/publish/publish?target=article
页面加载后会显示"写长文"页面,特征:
- 主标题:"支持千字长文,全屏阅读体验"
- 两个按钮:"新的创作"(红色)和"导入链接"
- 底部有"长文合集"区域
步骤 2: 点击"新的创作"按钮
查找方法:
find: "新的创作 button"元素特征:
- 类型:
button - 文本: "新的创作"
- 颜色: 红色(主要行动按钮)
步骤 3: 填写标题
点击"新的创作"后,进入长文编辑器。
页面特征:
- 顶部标题: "新的创作"
- 工具栏: H₁、H₂、列表、引用、图片、表情等格式化工具
- 两个输入区域: 标题区和正文区
标题输入框:
find: "输入标题"
element_type: textbox输入方法:
click(ref_51) // 点击标题输入框
type("小红书自动发布工具使用指南") // 输入标题步骤 4: 填写正文内容
正文编辑器:
// 正文编辑器是一个 generic 元素(ref_55)
// 不是标准的 textarea输入方法:
click(ref_55) // 点击正文编辑区域
type("正文内容...") // 输入正文正文特性:
- 支持富文本编辑
- 字数统计显示在底部:"字数:194"
- 自动保存功能:"自动保存于 HH:MM"
- 最大支持 10000 字
步骤 5: 点击"一键排版"选择模板
一键排版按钮:
find: "一键排版 button"点击后进入排版预览页面。
排版预览页面特征:
- 左侧: 内容预览(文章卡片形式)
- 右侧: 多种模板选项
- "简约基础"(默认选中 ✓)
- "清新明朗"
- "黑白极简"
- 底部: "拖动滑块快速定位"控件
下一步按钮:
find: "下一步 button"点击"下一步"进入最终发布页面。
步骤 6: 填写正文内容和标签
页面标题: "发布图文"
重要说明:
- 图文笔记有"正文摘录"输入框,名称虽然是"摘录",但必须填充完整的正文内容
- 不是填写摘要,而是填写全部正文内容 + 标签
正文内容输入框:
find: "输入正文摘录 textarea"
element_type: textbox输入方法:
click(ref_194) // 点击正文内容输入框
type(完整正文内容 + "\n\n" + 标签) // 输入完整正文 + 标签内容格式:
- 填充完整的正文内容(不是摘要)
- 在正文结束后换两行
- 然后添加标签(
#开头) - 多个标签用空格分隔
- 建议不超过3个标签
示例:
在这个信息爆炸的时代,内容创作者面临着越来越多的平台和渠道选择。小红书作为一个重要的社交电商平台,已经成为许多创作者分享生活方式和产品推荐的首选平台。
为了提高发布效率,我们开发了这款自动化发布工具。它可以帮助你快速将内容发布到小红书平台,节省大量的重复性工作时间。
本文将详细介绍如何使用这个工具,让你的内容发布工作变得更加轻松高效。无论你是个人创作者还是团队运营,这个工具都能为你带来显著的效率提升。
#小红书发布 #自动化工具 #效率提升步骤 7: 填写其他发布信息
标题输入框 (可选,通常自动填充):
find: 包含标题文本的 textbox
max_length: 20字符封面图:
- 系统会自动将长文内容转换为封面图
- 显示在"图片编辑"区域
- 左侧有"添加"按钮可添加更多封面图
其他选项:
- 添加地点
- 添加合集
- 关联群聊
- 活动话题(与文字配图相同)
步骤 8: 发布
发布按钮:
find: "发布 button"
element_type: button
color: 红色暂存草稿按钮:
find: "暂存草稿 button"⚠️ 重要提示: 根据安全策略,自动化脚本应该:
1. 填充所有内容后停止 2. 显示消息提示用户审核 3. 不要自动点击"发布"按钮 4. 由用户自己在浏览器中点击"发布"
图文笔记 vs 文字配图对比
| 特性 | 文字配图 (< 140字) | 图文笔记 (≥ 140字) |
|---|---|---|
| 入口 URL | target=image | target=article |
| 编辑方式 | 文字生成图片 | 富文本编辑器 |
| 标题输入 | 第一张图片内容 | 独立标题输入框 |
| 正文输入 | 第二张图片开始 | 正文编辑器 |
| 封面图 | 手动生成多张 | 自动生成封面 |
| 发布页正文区 | 正文文本框 | "正文摘录"输入框 |
| 正文填充方式 | 完整正文 + 标签 | 完整正文 + 标签 |
| 格式化 | 无 | 支持 H1/H2/列表等 |
| 字数限制 | 建议 < 140 | 140-10000字 |
关键提示: 两种模式在发布页面都必须填充完整的正文内容而非摘要或部分内容。
三、通用元素和选择器
登录状态检测
方法 1: 检查用户头像
find: "用户头像"如果找不到用户头像或显示"登录"按钮,说明未登录。
方法 2: 检查 URL 重定向 如果导航到发布页面后 URL 重定向到登录页面,说明未登录。
错误处理
常见错误提示:
- "请先登录" - 需要用户手动登录
- "内容不能为空" - 未填写必填字段
- "标题不能超过20字" - 标题过长
- "图片数量不足" - 至少需要1张图片
四、最佳实践
1. 内容准备
- 标题: 简洁明了,不超过20字
- 正文: 分段清晰,使用换行增强可读性
- 标签: 选择相关度高的标签,建议2-3个
2. 图片建议
- 文字配图: 至少2张(标题+正文)
- 内容分布:
- 第一张:核心标题或问题
- 后续图片:详细说明、步骤、总结
3. 标签选择
好的标签示例:
#小红书发布#自动化工具#效率提升#生活美学
避免:
- 过于宽泛的标签(如
#生活) - 无关标签
- 超过5个标签
4. 发布时机
- 避免频繁发布(建议间隔至少1小时)
- 考虑用户活跃时间(早8点、午12点、晚8点)
五、故障排除
问题 1: 文本输入失败
原因: 小红书使用自定义 DIV 编辑器,不是标准 input/textarea
解决方案:
1. 先点击文本框激活 2. 使用 type 动作输入文本 3. 不要使用 form_input(仅适用于标准表单元素)
问题 2: 生成图片按钮不可点击
原因: 文本内容为空或过短
解决方案:
1. 确保输入了足够的文本内容 2. 等待自动保存完成(查看底部"自动保存于"提示)
问题 3: 标签未正确添加
原因: 标签格式错误或未使用 # 开头
解决方案:
1. 确保标签以 # 开头 2. 多个标签之间用空格分隔 3. 标签后应有空格或换行
问题 4: 页面加载缓慢
原因: 网络延迟或服务器响应慢
解决方案:
1. 在关键操作后增加 wait 时间(2-3秒) 2. 使用 screenshot 验证页面状态 3. 检查页面标题确认导航成功
六、字数限制和规范
| 字段 | 最小值 | 最大值 | 备注 |
|---|---|---|---|
| 标题 | 1字 | 20字 | 必填 |
| 正文 | 1字 | 10000字 | 必填 |
| 标签 | 0个 | 建议3个 | 可选 |
| 图片数量 | 1张 | 18张 | 文字配图至少1张 |
七、自动化注意事项
反自动化检测
小红书可能有反自动化机制,建议:
1. 操作间隔: 在每个步骤之间添加1-3秒延迟 2. 随机化: 适当随机化延迟时间 3. 频率限制: 避免短时间内频繁发布 4. 人工审核: 始终让用户最终确认发布
安全性
1. 不自动点击发布: 仅填充内容,由用户手动发布 2. 内容审核: 建议用户预览内容 3. 敏感信息: 避免在自动化过程中处理敏感信息
八、总结
本技能文档提供了小红书文字配图发布的完整流程和详细的DOM选择器信息。图文笔记流程需要进一步测试完善。
核心原则:
- 文字配图流程: 先输入所有内容(标题 + 正文),再一次性生成全部图片
- 使用正确的入口 URL
- 按顺序执行每个步骤
- 使用
wait确保页面加载 - 通过
screenshot验证状态 - 让用户最终确认发布
interface:
display_name: "XHS Publisher"
short_description: "Automates Xiaohongshu (Little Red Book) content publishing with step-by-step Creator Platform workflows"
icon_small: "../assets/favicon.png"
icon_large: "../assets/favicon.png"
brand_color: "#3B82F6"
policy:
allow_implicit_invocation: false
Related skills
How it compares
Choose xhs-publisher when you need Xiaohongshu-specific DOM selectors, dual publish modes, and Obsidian-to-creator workflows instead of generic social schedulers without creator.xiaohongshu.com knowledge.
FAQ
What does xhs-publisher automate on Xiaohongshu?
xhs-publisher automates drafting on creator.xiaohongshu.com via Claude in Chrome: it picks text-image (<140 chars) or article (140-10000 chars) flows, fills title, body, and 2-3 hashtags, then stops before Publish for manual review.
How do you install xhs-publisher for Claude Code or Cursor?
Install xhs-publisher with npx skills add byheaven/byheaven-skills --skill xhs-publisher, or add the byheaven-skills plugin marketplace in Claude Code. The skill lands under .cursor/skills/xhs-publisher or the Claude plugin directory.
Does xhs-publisher click Publish automatically?
xhs-publisher does not click Publish. The skill fills the Xiaohongshu creator form, waits for auto-save, then requires a developer to preview and manually click Publish in Chrome to avoid anti-automation risk.