ZJU-REAL/Easel / skills/builtin/skill-xhs-publisher
skill-xhs-publisher
Verified将图文/视频内容发布到小红书(XHS)。基于 Playwright + 持久化登录态,headless 即可运行, 流程与选择器移植自成熟开源实现 xiaohongshu-mcp(含发布成功校验、上传完成等待、话题联想绑定、 新旧发布按钮兼容、反检测)。适用场景:发布图文笔记、发布视频、扫码登录、发布前预检。
| File | Kind | Size |
|---|---|---|
| AGENTS.md | markdown | 1.7 KB |
| EASEL-META.md | markdown | 3.3 KB |
| SKILL.md | skill md | 5.2 KB |
| public/whitedew.jpg | binary | 112.2 KB |
| references/commands.md | markdown | 3.8 KB |
| todo.md | markdown | 813 B |
references/commands.md
View on GitHub# xhs-publisher 命令样例
> 统一走 `skills/shared/scripts/xhs_publish.py`(Playwright,headless 可用)。CWD=项目根。
> 流程/选择器移植自 xpzouying/xiaohongshu-mcp。旧 CDP 脚本已退役删除。
## 环境检查
```bash
python skills/shared/scripts/xhs_publish.py check
# ✅ playwright 已安装 / ✅ chromium 内核 / 登录态目录
```
## 登录(headless:抠二维码成图片扫码)
```bash
python skills/shared/scripts/xhs_publish.py login
# 把登录二维码抠成 PNG → 默认 outputs/_login/xhs-login-qrcode.png(可在 Easel Web UI 的 outputs 查看)
# 用小红书 App 扫这张图 → 脚本轮询到登录成功后持久化 cookie(下次免登)
# --qr-out <path> 自定义二维码输出路径
# --timeout <秒> 等待扫码超时(默认 180)
# --headed 本地有桌面时用窗口内扫
# 登录态存 ~/.easel-browser-profiles/XiaohongshuProfile
```
> ⚠️ **风险 IP 拦截**:小红书会把机房/公司代理出口判为风险 IP(报「安全限制 300012 · IP存在风险」),
> 此时二维码根本不弹。解决:① `--proxy socks5://<干净/家宽IP代理>`;
> ② 在正常网络的机器上 `login` 拿到登录态,再把 `~/.easel-browser-profiles/XiaohongshuProfile`
> 整个目录拷到本机复用(登录态可移植)。本机/代理出口 IP 常被平台判风险,需换干净 IP。
## 发布前预检(dry-run,离线不启浏览器)
```bash
python skills/shared/scripts/xhs_publish.py plan \
--title "500元改造出租屋の神仙好物" \
--content "分享几个平价好物……" \
--images /abs/a.jpg,/abs/b.jpg \
--tags "出租屋改造,好物分享"
# 打印:标题长度校验 / 媒体 / 话题 / 7 步流程
```
## 图文发布
```bash
# dry-run(默认,不加 --exec 不会真发)
python skills/shared/scripts/xhs_publish.py publish \
--title "标题" --content "正文" --images /abs/a.jpg,/abs/b.jpg --tags "AI,教程"
# 真正发布(首次建议 --headed 观察选择器,OK 后去掉转 headless)
python skills/shared/scripts/xhs_publish.py publish --exec --headed \
--title "标题" --content "正文" --images /abs/a.jpg,/abs/b.jpg --tags "AI,教程"
```
## 视频发布
```bash
python skills/shared/scripts/xhs_publish.py publish-video --exec --headed \
--title "标题" --content "正文" --video /abs/clip.mp4 --tags "vlog"
# 视频上传后脚本等发布按钮可点击(最长 10min = 平台处理完成)再提交
```
## 代理与登录态
```bash
--proxy http://host:port # 显式外网代理(默认取 env http(s)_proxy,小红书是外网需代理)
--no-proxy # 禁用代理
--profile-base /path # 登录态根目录(默认 ~/.easel-browser-profiles)
--keep-open # 发布后不关闭浏览器(调试用)
```
## 参数速查
| 参数 | 说明 |
|------|------|
| `--title` | 标题,≤20 全角字(脚本按小红书口径 `calc_title_length` 校验) |
| `--content` | 正文 |
| `--images` | 图片路径,逗号分隔(图文发布;绝对路径) |
| `--video` | 视频路径(视频发布;绝对路径) |
| `--tags` | 话题,逗号分隔(如 `AI,教程`;脚本走话题联想真绑定) |
| `--exec` | 真正发布(缺省为 dry-run) |
| `--headed` | 有头模式(首次校验选择器) |
## 排障
- **未登录**:先 `login` 扫码。
- **步骤超时 / 找不到元素**:小红书改版了——改 `xhs_publish.py` 顶部 `SELECTORS` 字典(单点维护,每条标了参考源),先 `--headed` 观察定位。
- **发布未确认成功**:脚本以「URL 离开 /publish/publish」判成功;若卡在发布页说明平台校验未过(标题/正文超限、内容违规等),按提示排查。
- **自检**:`python skills/shared/scripts/xhs_publish.py selftest`(离线,验选择器字典/标题算法/参数解析)。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |