--- id: sm-xhs-publisher name: "xhs-publisher" url: https://skills.yangsir.net/skill/sm-xhs-publisher author: byheaven domain: content-creation tags: ["xiaohongshu-marketing", "social-media-publishing", "chinese-social-media", "content-marketing", "influencer-engagement"] install_count: 354 rating: 4.10 (77 reviews) github: https://github.com/byheaven/byheaven-skills --- # xhs-publisher > 提供小红书创作者平台的详细发布流程、DOM选择器和操作步骤。 **Stats**: 354 installs · 4.1/5 (77 reviews) ## Before / After 对比 ### 小红书内容发布效率对比 | Metric | Before | After | Change | |---|---|---|---| | - | - | - | - | | - | - | - | - | ## Readme # xhs-publisher # 小红书发布技能 (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" **⚠️ 重要提示**: 根据安全策略，自动化脚本应该： - 填充所有内容后停止 - 显示消息提示用户审核 - **不要自动点击"发布"按钮** - 由用户自己在浏览器中点击"发布" ## 二、图文笔记流程 (≥ 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" ``` **⚠️ 重要提示**: 根据安全策略，自动化脚本应该： - 填充所有内容后停止 - 显示消息提示用户审核 - **不要自动点击"发布"按钮** - 由用户自己在浏览器中点击"发布" ### 图文笔记 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 **解决方案**: - 先点击文本框激活 - 使用 `type` 动作输入文本 - 不要使用 `form_input`（仅适用于标准表单元素） ### 问题 2: 生成图片按钮不可点击 **原因**: 文本内容为空或过短 **解决方案**: - 确保输入了足够的文本内容 - 等待自动保存完成（查看底部"自动保存于"提示） ### 问题 3: 标签未正确添加 **原因**: 标签格式错误或未使用 `#` 开头 **解决方案**: - 确保标签以 `#` 开头 - 多个标签之间用空格分隔 - 标签后应有空格或换行 ### 问题 4: 页面加载缓慢 **原因**: 网络延迟或服务器响应慢 **解决方案**: - 在关键操作后增加 `wait` 时间（2-3秒） - 使用 `screenshot` 验证页面状态 - 检查页面标题确认导航成功 ## 六、字数限制和规范 字段 最小值 最大值 备注 标题 1字 20字 必填 正文 1字 10000字 必填 标签 0个 建议3个 可选 图片数量 1张 18张 文字配图至少1张 ## 七、自动化注意事项 ### 反自动化检测 小红书可能有反自动化机制，建议： - **操作间隔**: 在每个步骤之间添加1-3秒延迟 - **随机化**: 适当随机化延迟时间 - **频率限制**: 避免短时间内频繁发布 - **人工审核**: 始终让用户最终确认发布 ### 安全性 - **不自动点击发布**: 仅填充内容，由用户手动发布 - **内容审核**: 建议用户预览内容 - **敏感信息**: 避免在自动化过程中处理敏感信息 ## 八、总结 本技能文档提供了小红书文字配图发布的完整流程和详细的DOM选择器信息。图文笔记流程需要进一步测试完善。 **核心原则**: - **文字配图流程**: 先输入所有内容（标题 + 正文），再一次性生成全部图片 - 使用正确的入口 URL - 按顺序执行每个步骤 - 使用 `wait` 确保页面加载 - 通过 `screenshot` 验证状态 - 让用户最终确认发布 Weekly Installs234Repository[byheaven/byheaven-skills](https://github.com/byheaven/byheaven-skills)GitHub Stars2First SeenJan 23, 2026Security Audits[Gen Agent Trust HubPass](/byheaven/byheaven-skills/xhs-publisher/security/agent-trust-hub)[SocketPass](/byheaven/byheaven-skills/xhs-publisher/security/socket)[SnykWarn](/byheaven/byheaven-skills/xhs-publisher/security/snyk)Installed onopencode200gemini-cli195codex193openclaw189cursor187github-copilot178 --- *Source: https://skills.yangsir.net/skill/sm-xhs-publisher* *Markdown mirror: https://skills.yangsir.net/api/skill/sm-xhs-publisher/markdown*