或在 ~/.zshrc 或 ~/.bashrc 中创建别名：

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

然后只需运行：chrome-debug

2. 登录小红书

在 Chrome 浏览器（调试端口已启用）中，导航至：

https://creator.xiaohongshu.com/publish/publish

使用小红书 App 扫码登录。这只需要做一次 - 会话会在浏览器中保持。

注意：登录后，您可以将浏览器窗口最小化到 Dock。浏览器必须保持运行（不能关闭）才能使 CDP 工作，但您无需看到它。

3. Python 依赖项

pip install Pillow pyobjc-framework-Cocoa

agent-browser CDP 命令参考

所有命令都使用 --cdp 9222 标志连接到现有的 Chrome 浏览器：

# 导航
npx agent-browser --cdp 9222 open <url>          # 导航到 URL
npx agent-browser --cdp 9222 snapshot -i         # 获取带有元素引用的页面快照

# 元素交互
npx agent-browser --cdp 9222 click @e5           # 通过引用点击元素
npx agent-browser --cdp 9222 fill @e2 "text"     # 填充输入字段
npx agent-browser --cdp 9222 type @e3 "text"     # 在元素中输入文本
npx agent-browser --cdp 9222 upload @e4 "/path/to/file.jpg"  # 上传文件

# 键盘与等待
npx agent-browser --cdp 9222 press Enter         # 按键
npx agent-browser --cdp 9222 wait 2000           # 等待毫秒数
npx agent-browser --cdp 9222 wait --text "发布"  # 等待文本出现

# 截图
npx agent-browser --cdp 9222 screenshot          # 截图

重要提示：

• 元素引用（如 @e5）来自 snapshot -i 的输出。在交互前始终获取快照。
• --cdp 9222 标志连接到浏览器的调试端口，而不是启动新浏览器。
• 请不要使用 close 命令，因为它会关闭用户的浏览器！

脚本

位于 ~/.claude/skills/xiaohongshu-publisher/scripts/：

parse_note.py

解析 Markdown 并提取小红书笔记的结构化数据：

python parse_note.py <markdown_file> [--output json]

返回包含以下内容的 JSON：title, content, images（路径列表）, tags

copy_to_clipboard.py

将图像复制到系统剪贴板以便粘贴：

python copy_to_clipboard.py image /path/to/image.jpg [--quality 80]

工作流程

阶段 0：验证浏览器连接

关键：首先验证 CDP 浏览器正在运行且已连接。

1. 检查浏览器是否可访问：

   npx agent-browser --cdp 9222 snapshot -i

   • 如果连接失败，告诉用户："请先启动带调试端口的 Chrome 浏览器"

2. 如果需要，提供启动命令：

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

阶段 1：检查登录状态

1. 导航到创作者页面（如果尚未在此页面）：

   npx agent-browser --cdp 9222 open "https://creator.xiaohongshu.com/publish/publish"

2. 获取快照以检查登录状态：

   npx agent-browser --cdp 9222 snapshot -i

   • 寻找"上传图片"按钮 = 已登录
   • 寻找二维码或登录表单 = 需要登录

3. 如果需要登录：

   • 告诉用户："请在浏览器中扫码登录小红书，登录后告诉我"
   • 等待用户确认
   • 获取新快照以验证登录成功

阶段 2：解析内容

如果用户提供了 markdown 文件，则解析它：

python ~/.claude/skills/xiaohongshu-publisher/scripts/parse_note.py /path/to/note.md

输出 JSON：

{
  "title": "Note Title",
  "content": "Note description/content text...",
  "images": ["/path/to/img1.jpg", "/path/to/img2.jpg"],
  "tags": ["tag1", "tag2"]
}

阶段 3：上传图片

1. 获取快照以获取当前元素引用：

   npx agent-browser --cdp 9222 snapshot -i

2. 找到上传输入元素（寻找文件输入或"上传图片"区域）

3. 上传图片：

   单张图片

npx agent-browser --cdp 9222 upload @e<ref> "/path/to/image1.jpg"

# 多张图片（逗号分隔）
npx agent-browser --cdp 9222 upload @e<ref> "/path/to/img1.jpg,/path/to/img2.jpg,/path/to/img3.jpg"

4. 等待上传完成：

    npx agent-browser --cdp 9222 wait 3000

5. 上传完成后获取新快照

阶段 4：填写标题和内容

1. 从快照中找到标题输入字段（占位符通常包含"标题"）

2. 填写标题：

   npx agent-browser --cdp 9222 fill @e<title_ref> "Your Note Title"

   • 标题限制：建议约 20 个字符

3. 找到内容/描述字段（占位符通常包含"描述"或"正文"）

4. 填写内容：

   npx agent-browser --cdp 9222 fill @e<content_ref> "Your note content here..."

   • 内容限制：最多约 1000 个字符

阶段 5：添加标签（可选）

如果提供了标签：

1. 从快照中找到标签输入区域

2. 添加每个标签：

   npx agent-browser --cdp 9222 click @e<add_tag_ref> npx agent-browser --cdp 9222 fill @e<tag_input_ref> "tag1" npx agent-browser --cdp 9222 press Enter

   • 对每个标签重复（建议最多 5 个）

阶段 6：保存为草稿（默认）或发布

默认操作：保存为草稿

1. 从快照中找到"存草稿"按钮

2. 点击草稿按钮：

   npx agent-browser --cdp 9222 click @e<draft_button_ref>

3. 验证成功 - 获取快照或等待确认

仅当用户明确要求发布时

仅当用户说"直接发布"、"立即发布"或"publish now"时：

1. 从快照中找到"发布"按钮

2. 点击发布按钮：

   npx agent-browser --cdp 9222 click @e<publish_button_ref>

如有疑问，始终保存为草稿。

阶段 7：验证并报告

1. 获取最终快照以验证成功：

   npx agent-browser --cdp 9222 snapshot -i

2. 向用户报告：

   • 草稿已保存："草稿已保存！请在小红书 App 中预览和发布。"
   • 已发布："笔记已发布成功！"

示例流程

示例 1：基本图片发布

用户："发布这些图片到小红书: /path/to/photo1.jpg, /path/to/photo2.jpg, 标题是'周末好去处'"

# 1. 验证连接并检查登录状态
npx agent-browser --cdp 9222 snapshot -i

# 2. 导航到发布页面（如果需要）
npx agent-browser --cdp 9222 open "https://creator.xiaohongshu.com/publish/publish"

# 3. 获取快照，验证"上传图片"可见
npx agent-browser --cdp 9222 snapshot -i

# 4. 上传图片
npx agent-browser --cdp 9222 upload @e<ref> "/path/to/photo1.jpg,/path/to/photo2.jpg"
npx agent-browser --cdp 9222 wait 3000

# 5. 获取新快照，填写标题
npx agent-browser --cdp 9222 snapshot -i
npx agent-browser --cdp 9222 fill @e<title_ref> "周末好去处"

# 6. 保存为草稿
npx agent-browser --cdp 9222 click @e<draft_ref>

示例 2：Markdown 文件发布

用户："把这个 markdown 发到小红书: /path/to/note.md"

# 1. 解析 markdown
python ~/.claude/skills/xiaohongshu-publisher/scripts/parse_note.py /path/to/note.md

# 2. 从 JSON 输出中提取：title, content, images, tags

# 3. 验证连接
npx agent-browser --cdp 9222 snapshot -i

# 4. 上传解析结果中的所有图片
npx agent-browser --cdp 9222 upload @e<ref> "/path/to/img1.jpg,/path/to/img2.jpg"

# 5. 填写标题和内容
npx agent-browser --cdp 9222 fill @e<title_ref> "parsed title"
npx agent-browser --cdp 9222 fill @e<content_ref> "parsed content"

# 6. 如果存在则添加标签
npx agent-browser --cdp 9222 fill @e<tag_ref> "tag1"
npx agent-browser --cdp 9222 press Enter

# 7. 保存为草稿
npx agent-browser --cdp 9222 click @e<draft_ref>

示例 3：直接发布

用户："直接发布这些图到小红书，不用草稿"

# [与上面相同，直到第 6 步]

# 找到并点击"发布"按钮（不是 存草稿）
npx agent-browser --cdp 9222 click @e<publish_ref>

关键规则

1. 🚨 绝不自动发布 - 默认始终保存为草稿
2. 🔌 始终使用 --cdp 9222 - 每个命令都必须包含此标志
3. ❌ 绝不使用 close 命令 - 这会关闭用户的浏览器！
4. 📸 频繁获取快照 - 页面状态会变化，始终获取新的引用
5. ⏳ 上传后等待 - 给图片处理留出时间
6. 🔄 优雅处理登录 - 如果需要，引导用户在浏览器中登录
7. 📝 遵守内容限制 - 标题约 20 字符，内容约 1000 字符
8. 🖼️ 图片限制 - 每篇笔记 1-18 张图片

故障排除

CDP 连接失败

如果 snapshot 连接失败：

1. 验证 Chrome 是否正在使用调试端口运行：

   lsof -i :9222

2. 如果未运行，启动 Chrome：

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

3. 检查端口冲突 - 可能有其他进程正在使用 9222

会话过期

如果之前已登录但现在看到登录页面：

1. 告诉用户在浏览器中重新登录："您的登录状态已过期，请在浏览器中重新扫码登录"

2. 等待用户确认

3. 获取新快照进行验证

上传失败

• 检查图像文件是否存在且格式有效（jpg, png, gif, webp）

• 检查文件大小（小红书有限制）

• 尝试一次上传一张

• 截图查看实际错误：

  npx agent-browser --cdp 9222 screenshot error.png
  

找不到元素

• 页面结构可能已更改
• 在交互前始终获取新的快照
• 寻找具有不同引用的类似元素

为什么使用 agent-browser 的 CDP 模式？

优势：

1. 无需每次会话扫码 - 登录状态在浏览器中保持
2. 用户自己的浏览器 - 现有的 Cookie 和偏好设置
3. 简单的 CLI - 相同的 agent-browser 命令，只需添加 --cdp 9222
4. 无需 MCP 服务器 - 直接 CLI 调用
5. 可靠的认证 - 浏览器处理会话管理

权衡：

1. 需要浏览器运行 - 用户必须使用调试端口启动 Chrome
2. 单个浏览器实例 - 一次一个会话
3. 首次手动登录 - 用户在浏览器中进行初始扫码

支持的内容

每周安装量

100

仓库

iamzifei/red-pu…er-skill

GitHub 星标数

7

首次出现

2026年2月13日

安全审计

Gen Agent Trust HubPassSocketPassSnykWarn

安装于

gemini-cli97

github-copilot97

codex97

opencode97

kimi-cli96

amp96