Skills
skills/aaaaqwq/claude-code-skills/xhs-smart-publisher

xhs-smart-publisher

Installation
SKILL.md

小红书智能发布

  • Author: Daniel Li
  • Copyright © Daniel Li. All rights reserved.

⚡ 快速工作流

触发词 → 填写内容 → 🔍 截图确认 → ⏳ 等待指令 → ✅ 发布/存草稿

关键：截图确认步骤不可跳过！

步骤 操作 阻塞?
1 填写标题、正文、标签、上传封面 ❌
2 截图发送到群 ⚠️ 必须
3 等待用户确认 ✅ 阻塞
4 收到"发布"→点击发布 ❌
4 收到"存草稿"→点击暂存 ❌

用户指令：

  • 发布 / 确认发布 → 执行发布
  • 存草稿 / 暂存 → 保存到草稿箱

排版规则

项 规则
标题 ≤20字，emoji+关键词+数字，公式：人群+关键词+数字+悬念+emoji
正文 300-1000字，双换行分段，每段1-2个emoji开头，前3行放核心
标签 #话题名(无空格) 3-8个，精准在前泛话题在后
封面 3:4竖版(1080×1440)，大字+对比色+人物/产品占60%+
图片 1-18张，JPG/PNG，≤20MB/张
最佳时间 工作日18-22点，周末20-23点

内容适配模板

将任意内容转化为小红书格式时：

  1. 标题：提炼核心卖点，套用公式 人群定位+关键词+数字+悬念词+emoji
    • 例：打工人必看🔥5个效率工具让你准时下班
  2. 正文排版： 
    emoji 开头金句/痛点（抓注意力）

emoji 正文第一段（核心信息，≤3行）

emoji 正文第二段（展开论述）

emoji 正文第三段（补充/案例）

emoji 总结/互动引导（提问/投票）

#精准话题1 #精准话题2 #泛话题3 #泛话题4
  3. emoji策略：每段开头1个，正文中关键词旁适度点缀，不超过正文的5%
  4. 标签策略：2个精准话题(搜索量高) + 2-4个泛话题(曝光量大) + 1-2个长尾话题

发布流程（Browser工具操作）

通用流程

Step 0: 确认发布内容类型

  • 视频 → 走视频发布流程
  • 图文 → 走图文发布流程
  • 长文 → 走长文发布流程

📷 图文发布流程（7步）

Step 1: 打开发布页面

browser(action="navigate", profile="openclaw", 
       targetUrl="https://creator.xiaohongshu.com/publish/publish?source=official&target=image")

Step 2: 确认发布类型

  • 点击「上传图文」

Step 3: 上传封面图片

  • 点击上传按钮或 input[type='file'] 上传封面图
  • 等待图片加载完成

Step 4: 填写标题

  • ⚠️ 定位标题输入框：placeholder="填写标题会有更多赞哦"
  • 使用 JavaScript 精确填充（防止UI错位）：
// 找到标题输入框并设置值
const titleInput = document.querySelector('input[placeholder*="标题"]');
if(titleInput) {
  titleInput.value = '标题内容（≤20字）';
  titleInput.dispatchEvent(new Event('input', {bubbles: true}));
}

Step 5: 填写正文（⚠️ 最关键一步）

  • 先点击正文编辑器获取焦点： 
    browser(action="act", kind="click", ref="<正文框ref>")
  • 等待 500ms 让 Tiptap/ProseMirror 编辑器初始化
  • 使用 Tiptap/ProseMirror API 填写正文：
// 将 Markdown 转换为 HTML
const text = `要粘贴的正文内容`;
const paragraphs = text.split('\n').filter(p => p.trim());
const htmlParts = paragraphs.map(p => {
    // 处理 **粗体**
    p = p.replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>');
    return '<p>' + p + '</p>';
});
const html = htmlParts.join('');

// 写入编辑器
const editor = document.querySelector('.tiptap.ProseMirror');
if (editor) {
    editor.focus();
    editor.innerHTML = html;
    editor.dispatchEvent(new Event('input', {bubbles: true}));
}
  • 验证：正文框字数统计应显示 X/1000（X>0），如果仍显示 0/1000，尝试方案B/C/D（见"UI问题与解决方案"）
  • ⚠️ 如果使用 browser evaluate，fn 中不能有 await，用 setTimeout 包裹：new Promise(r=>setTimeout(r,500)).then(()=>{...})

Step 6: 检查排版

  • ⚠️ 必须先验证正文已写入：正文框字数应 > 0
  • 截图确认格式
  • 确认标题框内只有标题（≤20字），字数 X/20
  • 确认正文框内有完整正文，字数 X/1000
  • 如正文 0/1000 → 正文未写入 → 回到 Step 5 尝试其他方案
  • 如有排版问题，手动调整

Step 7: 🔍 截图确认（必须步骤）

  • ⚠️ 在点击发布/保存草稿之前，必须执行此步骤
  • 使用 browser 截图当前页面内容： 
    browser(action="screenshot", target="host")
  • 将截图发送到群中汇报： 
    message(action="send", channel="telegram", target="-1003890797239", 
       message="📝 小红书内容已填写完毕，请确认后回复'发布'或'存草稿'",
       accountId="xiaocode")
  • 必须等待用户确认后才能继续（不自动发布）

Step 8: ⏳ 等待用户确认

  • 用户回复以下指令之一：
    • 发布 / 确认发布 → 执行发布
    • 存草稿 / 暂存 → 保存到草稿箱
    • 修改 / 取消 → 停止流程，等待重新触发
  • ⚠️ 此步骤是阻塞的，在收到明确指令前不执行任何操作

Step 9: ✅ 执行发布/存草稿

根据用户确认选择：

发布模式：

  • 点击「发布」按钮
  • 等待发布成功提示
  • 截图确认发布结果
  • 发送完成通知到群

草稿模式：

  • 点击「暂存离开」按钮
  • 确认草稿保存成功
  • 发送完成通知到群

📝 长文发布流程（6步）

相比图文，少去上传图片封面步骤

Step 1: 打开发布页面

  • URL: https://creator.xiaohongshu.com/publish/publish?source=official

Step 2: 确认发布类型

  • 点击「写长文」

Step 3: 填写标题

  • 同图文 Step 4

Step 4: 填写正文

  • 同图文 Step 5

Step 5: 🔍 截图确认（必须步骤）

  • 同图文 Step 7：必须先截图发送到群等待确认

Step 6: ⏳ 等待用户确认

  • 同图文 Step 8：等待用户回复「发布」或「存草稿」

Step 7: ✅ 执行发布/存草稿

  • 同图文 Step 9

🎬 视频发布流程（3步）

Step 1: 上传视频

  • 点击「上传视频」
  • 选择视频文件上传

Step 2: 🔍 截图确认（必须步骤）

  • 填写标题、描述等内容后
  • 执行 browser(action="screenshot", target="host") 截图
  • 发送到群中等待确认
  • ⚠️ 必须等待用户确认后才能发布

Step 3: ⏳ 等待用户确认

  • 同图文 Step 8

Step 4: ✅ 执行发布

  • 用户确认后点击「发布」

自动化脚本用法

python scripts/xhs_publish.py \
  --title "标题文字" \
  --content "正文内容" \
  --tags "话题1,话题2,话题3" \
  --image "/path/to/cover.jpg" \
  --mode draft \
  --auto-login

参数说明：

  • --auto-login: 自动连接 openclaw 浏览器获取登录态
  • --mode draft: 保存到草稿箱（默认）
  • --mode publish: 直接发布

浏览器自动化注意事项

已登录态获取

使用 openclaw 浏览器 profile="openclaw"，通过 CDP 连接 (http://127.0.0.1:18800) 自动复用登录态。

UI 问题与解决方案

❌ 问题1：正文框 0/1000 写不进去（已确认 2026-03-20）

现象：标题正确（8字），但正文框显示 0/1000，browser 的 fill/type 均无法写入内容。

根因：小红书创作者平台已从 Quill.js 迁移到 Tiptap/ProseMirror（class=tiptap.ProseMirror）。普通 DOM 操作（设置 innerText/value）不触发 React 状态更新，导致：

  • 内容虽然视觉上出现，但 Tiptap 内部状态为空
  • 字数统计不变（0/1000）
  • 保存草稿后正文丢失

✅ 解决方案（推荐方案）：

方案A：Tiptap/ProseMirror API 直接写入（推荐）

// 将 Markdown 转换为 HTML 段落
const text = '要粘贴的正文内容\n第二段内容';
const paragraphs = text.split('\n').filter(p => p.trim());
const htmlParts = paragraphs.map(p => {
    // 处理 **粗体**
    p = p.replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>');
    return '<p>' + p + '</p>';
});
const html = htmlParts.join('');

// 写入 Tiptap 编辑器
const editor = document.querySelector('.tiptap.ProseMirror');
if (editor) {
    editor.focus();
    editor.innerHTML = html;
    editor.dispatchEvent(new Event('input', {bubbles: true}));
}

方案B：Clipboard API 模拟粘贴（备选）

// 先点击正文编辑器获取焦点
document.querySelector('.tiptap.ProseMirror')?.click();
// 等待 300ms 让编辑器初始化
await new Promise(r => setTimeout(r, 300));
// 使用 Clipboard API 粘贴
const text = '要粘贴的正文内容';
const clipboardData = new DataTransfer();
clipboardData.setData('text/plain', text);
const pasteEvent = new ClipboardEvent('paste', {
  clipboardData: clipboardData,
  bubbles: true,
  cancelable: true
});
document.querySelector('.tiptap.ProseMirror')?.dispatchEvent(pasteEvent);

方案C：executeCommand（兼容方案）

document.querySelector('.tiptap.ProseMirror')?.focus();
document.execCommand('selectAll');
document.execCommand('insertText', false, '正文内容');

验证标准：写入后正文框字数统计应显示 X/1000（X>0）。

❌ 问题2：标题和正文内容混串

现象：标题输入框显示字符计数如 "510/20"，内容被粘贴到了标题位置。

根因：编辑器 UI 的 contenteditable 字段定位错误。

解决：

  1. 先填标题：使用 input[placeholder*="标题"] 定位
  2. 再点击正文框：点击 .ql-editor 后等待 500ms
  3. 最后填正文：使用方案A粘贴
  4. 验证标题框字数 ≤ 20，正文框字数 > 0

手动修正流程（最终兜底）

  1. 打开草稿箱
  2. 点击"编辑"进入文章
  3. 手动复制正文到正确位置，修正标题
  4. 点击发布

错误处理

错误 处理
登录过期 提示用户重新扫码，保存新cookie
滑块验证 暂停等待手动完成，设置 --headless false
标题超长 自动截断到20字并警告
图片上传失败 重试3次，每次间隔5秒
网络超时 重试3次，指数退避(5s/15s/45s)
发布频率限制 等待60秒后重试
内容混入标题 保存草稿后手动修正

发布前检查清单

  • 标题 ≤20字，含emoji和关键词
  • 正文 ≥100字（新规要求）
  • 标签 3-8个，#格式
  • 封面图 3:4竖版
  • 无其他平台水印
  • 非AI搬运内容（原创要求）

文件结构

xhs-smart-publisher/
├── SKILL.md
├── scripts/
│   └── xhs_publish.py        # Playwright 自动发布脚本
├── references/
│   └── platform-rules.md     # 完整平台规则（从调研文档提取）
└── templates/
    └── content-template.md   # 排版模板示例
Weekly Installs
1
Repository
aaaaqwq/claude-…e-skills
GitHub Stars
52
First Seen
7 days ago
Security Audits
Gen Agent Trust HubFail
SocketWarn
SnykFail