xhs-publisher

📁 byheaven/byheaven-skills 📅 Jan 23, 2026
49
总安装量
49
周安装量
#4313
全站排名
安装命令
npx skills add https://github.com/byheaven/byheaven-skills --skill xhs-publisher

Agent 安装分布

claude-code 31
opencode 30
gemini-cli 27
openclaw 26
codex 25
antigravity 24

Skill 文档

小红书发布技能 (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 验证状态
  • 让用户最终确认发布