Publish to Xiaohongshu (Little Red Book) via remote Browserless CDP. Cookie-based login, auto-publish, supports multi-image posts. No local browser needed.
基于 Browserless 远程浏览器自动化发布小红书笔记，无需本地浏览器。
# 复制环境变量模板
cp .env.example .env
# 编辑 .env 文件，填写你的 Browserless 服务器地址
# vim .env 或 nano .env
# 1. 浏览器登录 https://www.xiaohongshu.com
# 2. F12 → Application → Cookies → xiaohongshu.com
# 3. 全选 → 复制
# 4. 粘贴到 cookies.txt (参考 cookies.txt.example)
python3 ${SKILL_DIR}/xhs_login.py --file
python3 ${SKILL_DIR}/scripts/xhs_publish.py \
--title "标题" \
--content "内容" \
--image /path/to/image.png \
--submit
python3 ${SKILL_DIR}/xhs_login.py --file # 使用 cookies.txt 登录
python3 ${SKILL_DIR}/scripts/xhs_publish.py --title "标题" --content "内容" --image 图片.png --submit
| 参数 | 说明 |
|---|---|
--title <text> | 标题（必需） |
--content <text> | 内容（必需） |
--image <path> | 图片文件路径（必需） |
--submit | 实际发布（默认预览） |
python3 ${SKILL_DIR}/scripts/xhs_publish.py \
--title "今日穿搭分享 👗" \
--content "今天分享一套超级好看的春日穿搭！\n\n#OOTD #春日穿搭 #时尚分享" \
--image ./outfit.png \
--submit
| 变量 | 说明 | 必需 |
|---|---|---|
XHS_WS_URL | Browserless WebSocket URL | ✅ 是 |
XHS_STATE_FILE | 登录状态文件路径 | 否 |
XHS_COOKIE_FILE | Cookie 文件路径 | 否 |
XHS_SCREENSHOTS | 启用截图调试 (设为 1) | 否 |
示例 .env 文件：
# Browserless 服务器地址 (必需)
XHS_WS_URL=ws://your-browserless-server:10086?token=your-token
# 状态文件路径 (可选)
# XHS_STATE_FILE=/path/to/xhs_browser_state.json
# Cookie 文件路径 (可选)
# XHS_COOKIE_FILE=/path/to/cookies.txt
# 启用截图调试 (可选)
# XHS_SCREENSHOTS=1
cookies.txt (参考 cookies.txt.example)cookies.txt┌─────────────────────────────────────────────────────┐
│ 1. 复制 .env.example 为 .env 并配置服务器地址 │
│ 2. 浏览器复制 Cookie → cookies.txt │
│ 3. python3 xhs_login.py --file (保存登录状态) │
│ 4. python3 xhs_publish.py --title "xxx" --content │
│ "xxx" --image photo.png --submit (远程发布) │
└─────────────────────────────────────────────────────┘
# 1. 浏览器复制新 Cookie
# 2. 粘贴到 cookies.txt
# 3. 重新登录
python3 ${SKILL_DIR}/xhs_login.py --file
| 项目 | 要求 |
|---|---|
| 格式 | JPG, PNG, WebP |
| 数量 | 1-9 张 |
| 尺寸 | 小于 10MB/张 |
| 比例 | 推荐 3:4 (竖图) |
| 问题 | 解决方案 |
|---|---|
| 未登录 | 运行 python3 xhs_login.py --file |
| Cookie 过期 | 浏览器重新获取 Cookie 更新 cookies.txt |
| 连接失败 | 检查 .env 中的 Browserless 服务器地址 |
| 发布失败 | 设置 XHS_SCREENSHOTS=1 查看截图 |
w0x7ce-xhs-browserless/
├── .env.example # 环境变量模板
├── .gitignore # Git 忽略文件
├── xhs_login.py # 登录脚本
├── cookies.txt.example # Cookie 模板
├── scripts/
│ ├── xhs_publish.py # 发布脚本 (Python)
│ └── publish.ts # 发布脚本 (TypeScript)
├── SKILL.md # 本文件
└── README.md # 详细文档