skill

red-publisher-skill

Claude Skill that publish on Red/Xiaohongshu/小红书

iamzifei/red-publisher-skillcommunitylistedunreviewednot running here yet

Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below; one-click install arrives with accounts.

README

synced Oct 14, 2026

Xiaohongshu Publisher Skill (小红书发布器)

English

Publish images and notes to Xiaohongshu (小红书) with one command. Uses CDP mode to connect to your existing browser session.

v3.0.0 — Now using agent-browser with CDP mode for seamless browser automation

The Problem

Publishing to Xiaohongshu manually is tedious:

Pain Point	Description
Login Hassle	Must scan QR code every session
Multiple Images	Upload images one by one
Content Formatting	Copy-paste text, add tags manually
Time Consuming	5-10 minutes per post

Time Comparison

Task	Manual	With This Skill
Login	30 sec - 1 min	Login once in browser, reuse session
Image upload (5 images)	2-3 min	30 sec
Title & content	1-2 min	10 sec
Total	5-10 min	1-2 min

5x efficiency improvement

The Solution

This skill uses CDP (Chrome DevTools Protocol) mode to connect to your existing browser:

1. Start Chrome with debug port
2. Login to Xiaohongshu once in browser
3. AI connects to your browser session
4. Automates publishing while you stay logged in

Images/Markdown File
     ↓ Python parsing
Structured Data (title, content, images, tags)
     ↓ agent-browser --cdp 9222
Your Chrome Browser (already logged in)
     ↓
Draft/Published Note

Key Features

🔌 CDP Mode: Connect to your existing browser via --cdp 9222 flag
🔐 Session Persistence: Login once in Chrome, reuse session indefinitely
📤 Multi-Image Upload: Upload up to 18 images at once
📝 Content Parsing: Extract title, content, and tags from Markdown
✅ Safe by Default: Saves as draft unless you specify publish
🛠️ agent-browser CLI: Simple command-line interface, no MCP server needed

What's New in v3.0.0

Feature	v2.x	v3.0
Connection mode	New browser each time	CDP (connect to existing)
Login handling	QR code detection + auth files	Login once in your browser
Session management	Auth state files	Browser's own session
Command format	`npx agent-browser open ...`	`npx agent-browser --cdp 9222 open ...`

Requirements

Requirement	Details
Claude Code	claude.ai/code
Chrome	Launch with `--remote-debugging-port=9222`
Python 3.9+	With dependencies below
macOS	Currently macOS only

## 怎么装（没用过命令行也能跟着做）

> 下面每一步都可以**直接复制粘贴**。不用懂什么是「技能」「仓库」「终端」，照做就行。
> 哪一步卡住了，**把报错原样复制给 AI，让它帮你看**——这是最快的解决办法。

### 方式一：WorkBuddy（推荐，不用敲命令）

1. **下载安装 WorkBuddy**，打开它，登录。
2. 在电脑上**新建一个文件夹**，名字随便，比如 `我的AI技能`，放桌面上就行。记住它在哪。
3. **把本项目下载下来**：
   - 在本页面点绿色的 **Code** 按钮 → **Download ZIP**
   - 下载完**解压**，把解压出来的整个文件夹拖进刚才建的 `我的AI技能` 里
4. 打开 WorkBuddy 的**设置 → 技能（Skills）**，点「添加技能目录」，选中 `我的AI技能` 这个文件夹。
5. **重启 WorkBuddy**。
6. 在对话框里输入 **`/小红书发布 新手`**，回车。

看到它开始介绍它能做什么并给你编号选项，就是装好了。

> 找不到「技能」入口？在设置里搜 `skill`，或者直接问 WorkBuddy：「我要怎么添加本地技能目录？」
> WorkBuddy 的菜单名称可能随版本变化，但「添加技能目录」这一步的意思是一样的。

### 方式二：Claude Code（会用终端的人）

```bash
git clone https://github.com/iamzifei/red-publisher-skill.git

把 clone 下来的文件夹放进 Claude Code 的技能目录（~/.claude/skills/），重启，输入 /小红书发布新手。

方式三：其他支持技能的 AI 工具（Codex、豆包、Trae 等）

这些工具大多会读一个固定的技能目录，常见的是 ~/.agents/skills、~/.codex/skills。把本项目文件夹复制进去，重启工具，输入 /小红书发布新手。

不知道装没装上？

在对话框里输入 /小红书发布新手。它会自己介绍自己、并带你走一遍—— 不用你想好要问什么，也不用准备任何材料。

Install Python dependencies

pip install Pillow pyobjc-framework-Cocoa


### Pre-requisite: Launch Chrome with Debug Port

Before using this skill, start Chrome with remote debugging:

```bash
# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

Tip: Add an alias to your shell config (~/.zshrc or ~/.bashrc):

alias chrome-debug='/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222'

Then login to Xiaohongshu once: https://creator.xiaohongshu.com/publish/publish

Tip: After login, you can minimize the browser to the Dock. It must stay running, but you don't need to see it.

Installation

Method 1: Git Clone (Recommended)

git clone https://github.com/wshuyi/xiaohongshu-publisher-skill.git
cp -r xiaohongshu-publisher-skill/skills/xiaohongshu-publisher ~/.claude/skills/

Method 2: Plugin Marketplace

/plugin marketplace add wshuyi/xiaohongshu-publisher-skill
/plugin install xiaohongshu-publisher@wshuyi/xiaohongshu-publisher-skill

Usage

Natural Language

发布这些图片到小红书: /path/to/photo1.jpg, /path/to/photo2.jpg
标题是"周末探店"

Publish /path/to/note.md to Xiaohongshu

帮我把这篇笔记发到小红书，存草稿就行

Skill Command

/xiaohongshu-publisher /path/to/note.md

Workflow Steps

[1/5] Verify browser connection...
      → Connect to Chrome via CDP (port 9222)
      → Check if already logged in

[2/5] Parse content...
      → Extract title, content, images, tags

[3/5] Upload images...
      → Upload all images (1-18 supported)

[4/5] Fill title and content...
      → Add title, description, tags

[5/5] Save draft...
      → ✅ Review and publish manually
      → (Or publish directly if requested)

Multi-Account Support

With CDP mode, account switching is handled by Chrome profiles:

Use Chrome profiles - Create different Chrome profiles for different accounts
Start Chrome with profile - Launch Chrome with the desired profile before connecting
Or switch accounts in browser - Login/logout in your browser, then use the skill

Content Formats

From Images + Text

发布这些图片到小红书:
- /path/to/photo1.jpg
- /path/to/photo2.jpg
- /path/to/photo3.jpg

标题: 周末好去处
内容: 发现了一家超赞的咖啡店...
标签: 咖啡, 探店, 周末

From Markdown File

# 周末好去处

![](./images/photo1.jpg)
![](./images/photo2.jpg)

发现了一家超赞的咖啡店，环境特别好！

推荐指数：⭐⭐⭐⭐⭐

#咖啡 #探店 #周末

Limits & Best Practices

Item	Limit
Images per note	1-18
Title length	~20 characters recommended
Content length	~1000 characters max
Tags	Up to 5 recommended
Image formats	JPG, PNG, GIF, WebP

Tips

Prepare images first - Have all images ready before running
Keep Xiaohongshu app handy - For quick QR code scanning
Use draft mode - Review before publishing
Compress large images - Faster uploads

FAQ

Q: Why CDP mode? A: CDP mode connects to your existing browser session. Benefits:

No separate browser window
Reuse your existing login
Session persists as long as browser is open
Same agent-browser commands, just add --cdp 9222

Q: Browser not connecting? A: Make sure Chrome is running with debug port:

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

Q: Session expired? A: Just re-login in your Chrome browser. The AI will use your active session.

Q: Windows/Linux support? A: Currently macOS only. PRs welcome for cross-platform support.

Q: Image upload failed? A: Check: valid path, supported format (jpg/png/gif/webp), file size within limits.

Q: Can I publish directly instead of draft? A: Yes, specify "直接发布" or "publish now" in your request.

Project Structure

xiaohongshu-publisher-skill/
├── .claude-plugin/
│   └── plugin.json              # Plugin config
├── skills/
│   └── xiaohongshu-publisher/
│       ├── SKILL.md             # Skill instructions
│       └── scripts/
│           ├── parse_note.py    # Content parser
│           └── copy_to_clipboard.py
├── docs/
│   └── GUIDE.md                 # Detailed guide (中文)
├── README.md                    # This file (bilingual)
└── LICENSE

中文

一键发布图片笔记到小红书。使用 CDP 模式连接到您已有的浏览器会话。

v3.0.0 — 使用 agent-browser + CDP 模式实现无缝浏览器自动化

痛点

手动发布小红书笔记太繁琐：

痛点	描述
登录麻烦	每次都要扫码登录
多图上传	一张一张上传图片
内容格式	复制粘贴文字，手动加标签
耗时长	每篇笔记 5-10 分钟

时间对比

任务	手动	使用本技能
登录	30秒 - 1分钟	浏览器登录一次，复用会话
上传5张图片	2-3 分钟	30 秒
填写标题内容	1-2 分钟	10 秒
总计	5-10 分钟	1-2 分钟

效率提升 5 倍

解决方案

本技能使用 CDP (Chrome DevTools Protocol) 模式 连接到您已有的浏览器：

1. 启动带调试端口的 Chrome
2. 在浏览器中登录小红书（只需一次）
3. AI 连接到您的浏览器会话
4. 自动化发布，保持登录状态

图片/Markdown 文件
     ↓ Python 解析
结构化数据 (标题, 内容, 图片, 标签)
     ↓ agent-browser --cdp 9222
您的 Chrome 浏览器 (已登录)
     ↓
草稿/已发布笔记

核心功能

🔌 CDP 模式：通过 --cdp 9222 参数连接到您已有的浏览器
🔐 会话持久化：浏览器登录一次，会话无限复用
📤 多图上传：一次上传最多 18 张图片
📝 内容解析：从 Markdown 提取标题、内容、标签
✅ 默认存草稿：不会自动发布，除非明确指定
🛠️ agent-browser CLI：简单的命令行界面，无需 MCP 服务器

v3.0.0 更新内容

功能	v2.x	v3.0
连接模式	每次新开浏览器	CDP (连接已有浏览器)
登录处理	二维码检测 + auth 文件	浏览器登录一次即可
会话管理	Auth 状态文件	浏览器自带会话
命令格式	`npx agent-browser open ...`	`npx agent-browser --cdp 9222 open ...`

环境要求

需求	详情
Claude Code	claude.ai/code
Chrome	启动时加 `--remote-debugging-port=9222`
Python 3.9+	需要下列依赖
macOS	目前仅支持 macOS

# 安装 Python 依赖
pip install Pillow pyobjc-framework-Cocoa

前置条件：启动带调试端口的 Chrome

使用本技能前，先启动带远程调试的 Chrome：

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

小贴士：在 shell 配置文件 (~/.zshrc 或 ~/.bashrc) 中添加别名：

alias chrome-debug='/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222'

然后在浏览器中登录小红书：https://creator.xiaohongshu.com/publish/publish

小贴士：登录后可以把浏览器最小化到 Dock。浏览器需要保持运行，但不需要看到它。

安装

方法一：Git Clone（推荐）

git clone https://github.com/wshuyi/xiaohongshu-publisher-skill.git
cp -r xiaohongshu-publisher-skill/skills/xiaohongshu-publisher ~/.claude/skills/

方法二：插件市场

/plugin marketplace add wshuyi/xiaohongshu-publisher-skill
/plugin install xiaohongshu-publisher@wshuyi/xiaohongshu-publisher-skill

使用方法

自然语言

发布这些图片到小红书: /path/to/photo1.jpg, /path/to/photo2.jpg
标题是"周末探店"

帮我把这篇笔记发到小红书，存草稿就行

把 /path/to/note.md 发布到小红书

技能命令

/xiaohongshu-publisher /path/to/note.md

工作流程

[1/5] 验证浏览器连接...
      → 通过 CDP 连接到 Chrome（端口 9222）
      → 检查是否已登录

[2/5] 解析内容...
      → 提取标题、内容、图片、标签

[3/5] 上传图片...
      → 上传所有图片（支持 1-18 张）

[4/5] 填写标题和内容...
      → 添加标题、描述、标签

[5/5] 保存草稿...
      → ✅ 请手动检查后发布
      → （或直接发布，如果用户要求）

多账号支持

使用 CDP 模式时，账号切换通过 Chrome 用户配置文件实现：

使用 Chrome 配置文件 - 为不同账号创建不同的 Chrome 配置文件
指定配置文件启动 - 使用目标配置文件启动 Chrome
或在浏览器中切换 - 在浏览器中登录/登出，然后使用本技能

内容格式

直接提供图片和文字

发布这些图片到小红书:
- /path/to/photo1.jpg
- /path/to/photo2.jpg
- /path/to/photo3.jpg

标题: 周末好去处
内容: 发现了一家超赞的咖啡店...
标签: 咖啡, 探店, 周末

使用 Markdown 文件

# 周末好去处

![](./images/photo1.jpg)
![](./images/photo2.jpg)

发现了一家超赞的咖啡店，环境特别好！

推荐指数：⭐⭐⭐⭐⭐

#咖啡 #探店 #周末

限制与最佳实践

项目	限制
每篇图片数	1-18 张
标题长度	建议 ~20 字符
内容长度	最多 ~1000 字符
标签数量	建议最多 5 个
图片格式	JPG, PNG, GIF, WebP

小贴士

提前准备图片 - 运行前确保所有图片就绪
手机准备好小红书 - 方便快速扫码
使用草稿模式 - 发布前先检查
压缩大图片 - 上传更快

常见问题

Q: 为什么使用 CDP 模式？ A: CDP 模式连接到您已有的浏览器会话。好处：

无需单独的浏览器窗口
复用已有的登录状态
只要浏览器开着，会话就一直有效
同样的 agent-browser 命令，只需加 --cdp 9222

Q: 浏览器连接不上？ A: 确保 Chrome 以调试端口启动：

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

Q: 会话过期了？ A: 直接在 Chrome 浏览器中重新登录即可。AI 会使用您当前的会话。

Q: 支持 Windows/Linux 吗？ A: 目前仅支持 macOS。欢迎提交 PR 支持其他平台。

Q: 图片上传失败？ A: 检查：路径是否正确，格式是否支持（jpg/png/gif/webp），文件大小是否超限。

Q: 可以直接发布而不是存草稿吗？ A: 可以，在请求中说明 "直接发布" 即可。

项目结构

xiaohongshu-publisher-skill/
├── .claude-plugin/
│   └── plugin.json              # 插件配置
├── skills/
│   └── xiaohongshu-publisher/
│       ├── SKILL.md             # 技能说明
│       └── scripts/
│           ├── parse_note.py    # 内容解析
│           └── copy_to_clipboard.py
├── docs/
│   └── GUIDE.md                 # 详细指南
├── README.md                    # 本文件（双语）
└── LICENSE

Changelog / 更新日志

v3.0.0 (2025-01)

CDP Mode / CDP 模式: Connect to existing browser via --cdp 9222 flag / 通过 --cdp 9222 参数连接到已有浏览器
Session Persistence / 会话持久化: Login once in browser, reuse indefinitely / 浏览器登录一次，无限复用
Simpler Setup / 更简单的配置: Just start Chrome with debug port / 只需启动带调试端口的 Chrome
Same CLI / 相同的命令行: Same agent-browser commands, just add --cdp 9222 / 相同的命令，只需加 --cdp 9222

v2.0.0 (2025-01)

Platform switch / 平台切换: Xiaohongshu instead of X (Twitter) / 从 X 改为小红书
agent-browser: Replace Playwright MCP with agent-browser CLI / 用 agent-browser CLI 替代 Playwright MCP
QR code login / 二维码登录: Detect and prompt user for login / 检测并提示用户登录
Multi-account / 多账号: Support multiple accounts with easy switching / 支持多账号管理和切换
Image-centric / 图片笔记: Focus on image notes rather than articles / 专注于图片笔记而非长文

v1.1.0 (2024-12)

Block-index positioning for X Articles
Reverse insertion order
Optimized wait strategy

v1.0.0 (2024-12)

Initial release (X Articles publisher)

License / 许可证

MIT License - see LICENSE

Author / 作者

wshuyi

Contributing / 贡献

Issues: Report bugs or request features / 报告问题或请求功能
PRs: Welcome! Especially for Windows/Linux support / 欢迎！特别是跨平台支持