xiaohongshu-publisher

name	xiaohongshu-publisher
description	Xiaohongshu (RedNote/小红书) automation skill for content publishing and engagement. Publish image-text notes via the xhs API using cookies, and simulate browser interactions (search, browse, comment) via Playwright. 小红书自动发布与互动技能：通过 xhs API 直接发布图文笔记，通过 Playwright 模拟网页搜索、浏览与评论互动。

小红书发布与运营技能

根据用户需求，自动完成小红书的内容发布或运营互动任务。

完整参数文档见 references/params.md
常见错误与处理见 references/troubleshooting.md
工作流规则与约束见 references/runtime-rules.md

---

⬇️ 安装（新环境首次运行必先执行）

venv/ 和 xhs_browser_data/ 不随 skill 迁移，可以即开即用。創建新环境请运行对应安装脚本：

# Linux/macOS（Openclaw 部署环境）
bash setup.sh

# Windows 本地调试
.\setup.ps1

安装完成后再执行后续步骤。

---

先决条件检查

在执行任何任务前，检查：

1. venv/ 虚拟环境是否存在（不存在则先运行 setup.sh）。
2. .env 文件是否包含 XHS_COOKIE（发布任务必须）。
3. xhs_browser_data/ 是否有登录数据（互动任务必须，否则先引导用户登录）。

---

工作流一：发布图文笔记

触发条件：用户提供图片路径、笔记标题和正文，要求发布到小红书。

第一步：验证 Cookie 有效

# Linux/macOS (Openclaw)
venv/bin/python scripts/publish_xhs.py --dry-run --title "验证" --images <任意图片路径>

# Windows
.\venv\Scripts\python.exe scripts\publish_xhs.py --dry-run --title "验证" --images <任意图片路径>

• 成功 → 进入第二步
• 失败 → 提示用户更新 .env 中的 XHS_COOKIE（见 references/params.md）

第二步：执行发布

# Linux/macOS （公开发布）
venv/bin/python scripts/publish_xhs.py \
  --title "笔记标题" \
  --desc "正文内容 #话题标签" \
  --images 封面.png 配图1.png \
  --public

# Windows
.\venv\Scripts\python.exe scripts\publish_xhs.py --title "笔记标题" --desc "正文" --images 封面.png --public

默认仅自己可见，确认效果后再用 --public 公开。

第三步：确认发布结果

• 成功后终端会打印笔记 ID 和链接，汇报给用户。
• 失败则根据 references/troubleshooting.md 排查并上报错误原因。

---

工作流二：搜索与互动（评论）

触发条件：用户要求搜索某关键词、浏览帖子、或回复评论。

第一步：确认浏览器登录态

检查 xhs_browser_data/ 是否存在。若不存在：

# Linux/macOS (Openclaw) - Openclaw 默认有头环境时使用
venv/bin/python scripts/interact_xhs.py --login

# Windows
.\venv\Scripts\python.exe scripts\interact_xhs.py --login

第二步：在 Python 代码中调用互动逻辑

import asyncio
from scripts.interact_xhs import XHSInteractor

async def run():
    async with XHSInteractor() as bot:
        await bot.start(headless=True)
        # 搜索并进入第一个笔记
        await bot.search_and_browse("关键词")
        # 发表评论
        await bot.add_comment("评论内容")

asyncio.run(run())

连续评论建议每次间隔 30 秒以上。

---

技能资源

脚本

• scripts/publish_xhs.py — 图文发布脚本（XHSPublisher 类）
• scripts/interact_xhs.py — 网页互动脚本（XHSInteractor 类）

参考文档

• references/params.md — 所有参数说明与 Cookie 获取方法
• references/runtime-rules.md — 操作规范与风控约束
• references/troubleshooting.md — 常见错误排查
• examples/publish_example.py — 发布调用示例