File contents XHS Auto Publisher Cloud
这个 Skill 是云端执行版,不是本机版替代品。
它主要解决四件事:
在 Linux 云服务器上跑浏览器自动化
把登录二维码交给人扫码
把登录状态缓存起来
把执行结果留痕
默认链路
当前项目只保留一条默认链路:
Agent 打开小红书登录页
Agent 截出二维码图片
项目生成 login_qr.payload.json
龙虾读取 payload
龙虾把二维码图片直接发到飞书群
用户扫码
Agent 继续执行
不依赖公网二维码链接,不依赖 XHS_PUBLIC_RUNTIME_BASE_URL。
适用场景
适合:
在云服务器上跑小红书图文草稿/发布
需要人工扫码接管登录
需要持久化浏览器 profile
需要截图、日志、DOM 快照
需要把标准化部署交给龙虾执行
不适合:
绕过验证码、滑块、人机验证
批量互动、批量点赞、批量评论
操作未授权账号
项目结构
config/:平台配置与选择器
src/:发布逻辑、登录检测、通知模块
scripts/:CLI 入口
deploy/:部署脚本与 systemd 示例
docs/:部署说明和龙虾执行文档
runtime/:浏览器 profile、截图、运行结果
部署分层
系统级
这部分影响整台机器:
python3
python3-venv
python3-pip
xvfb
浏览器运行依赖
项目级
这部分只属于当前目录:
.venv
Python 依赖
Playwright Chromium
runtime/
推荐目录
~/projects/xhs-auto-publisher
~/projects/xhs-auto-publisher/runtime
~/projects/xhs-auto-publisher/runtime/browser-profile
~/projects/xhs-auto-publisher/runtime/runs
~/projects/xhs-auto-publisher/runtime/lobster-notify
输入格式
发布内容使用 JSON 文件,例如:
{
"title": "OpenClaw 能帮业务团队做什么?",
"body": "很多团队不是缺 AI 聊天工具,而是缺一个能把业务流程真正跑起来的数字员工。",
"topics": ["OpenClaw", "AI工具", "浏览器自动化"],
"images": ["assets/cover.jpg"],
"mode": "publish"
}
环境变量
当前只保留最常用的两个:
MODE=publish
LOGIN_TIMEOUT=300
运行方式
手动运行:
cd ~/projects/xhs-auto-publisher
bash deploy/run_with_xvfb.sh
执行流程
校验内容和图片
检查重复发布保护
启动持久化 Chromium profile
读取登录缓存,默认 12 小时
检查是否已登录
如未登录,生成二维码截图并写出龙虾通知 payload
龙虾把二维码图片发到飞书群
用户扫码后继续
上传图片、填写内容、触发发布
保存截图、日志、DOM 快照和结果 JSON
运行产物
每次执行都会写入:
runtime/runs/<timestamp>/
包含:
actions.jsonl
result.json
content.normalized.json
screenshots/*.png
dom/*.html
通知文件会写入:
runtime/lobster-notify/<run_id>/login_qr.payload.json
文档入口
当前定位
这不是并发平台,而是一套稳妥的单机顺序执行方案:
单机
单浏览器
单任务
人工扫码接管
有留痕
可复跑
1 --- 2 name: xhs-auto-publisher 3 description: 面向云服务器的小红书图文自动发布 Skill。适用于需要在 Linux 云服务器上,通过 Playwright/CDP、二维码人工接管、登录缓存、龙虾代发飞书群图片消息、截图留痕与审计日志来完成小红书草稿或发布流程的场景。 4 --- 5 6 # XHS Auto Publisher Cloud 7 8 这个 Skill 是云端执行版,不是本机版替代品。 9 10 它主要解决四件事: 11 12 - 在 Linux 云服务器上跑浏览器自动化 13 - 把登录二维码交给人扫码 14 - 把登录状态缓存起来 15 - 把执行结果留痕 16 17 ## 默认链路 18 19 当前项目只保留一条默认链路: 20 21 1. Agent 打开小红书登录页 22 2. Agent 截出二维码图片 23 3. 项目生成 `login_qr.payload.json` 24 4. 龙虾读取 payload 25 5. 龙虾把二维码图片直接发到飞书群 26 6. 用户扫码 27 7. Agent 继续执行 28 29 不依赖公网二维码链接,不依赖 `XHS_PUBLIC_RUNTIME_BASE_URL`。 30 31 ## 适用场景 32 33 适合: 34 35 - 在云服务器上跑小红书图文草稿/发布 36 - 需要人工扫码接管登录 37 - 需要持久化浏览器 profile 38 - 需要截图、日志、DOM 快照 39 - 需要把标准化部署交给龙虾执行 40 41 不适合: 42 43 - 绕过验证码、滑块、人机验证 44 - 批量互动、批量点赞、批量评论 45 - 操作未授权账号 46 47 ## 项目结构 48 49 - `config/`:平台配置与选择器 50 - `src/`:发布逻辑、登录检测、通知模块 51 - `scripts/`:CLI 入口 52 - `deploy/`:部署脚本与 systemd 示例 53 - `docs/`:部署说明和龙虾执行文档 54 - `runtime/`:浏览器 profile、截图、运行结果 55 56 ## 部署分层 57 58 ### 系统级 59 60 这部分影响整台机器: 61 62 - `python3` 63 - `python3-venv` 64 - `python3-pip` 65 - `xvfb` 66 - 浏览器运行依赖 67 68 ### 项目级 69 70 这部分只属于当前目录: 71 72 - `.venv` 73 - Python 依赖 74 - Playwright Chromium 75 - `runtime/` 76 77 ## 推荐目录 78 79 ```text 80 ~/projects/xhs-auto-publisher 81 ~/projects/xhs-auto-publisher/runtime 82 ~/projects/xhs-auto-publisher/runtime/browser-profile 83 ~/projects/xhs-auto-publisher/runtime/runs 84 ~/projects/xhs-auto-publisher/runtime/lobster-notify 85 ``` 86 87 ## 输入格式 88 89 发布内容使用 JSON 文件,例如: 90 91 ```json 92 { 93 "title": "OpenClaw 能帮业务团队做什么?", 94 "body": "很多团队不是缺 AI 聊天工具,而是缺一个能把业务流程真正跑起来的数字员工。", 95 "topics": ["OpenClaw", "AI工具", "浏览器自动化"], 96 "images": ["assets/cover.jpg"], 97 "mode": "publish" 98 } 99 ``` 100 101 ## 环境变量 102 103 当前只保留最常用的两个: 104 105 ```env 106 MODE=publish 107 LOGIN_TIMEOUT=300 108 ``` 109 110 ## 运行方式 111 112 手动运行: 113 114 ```bash 115 cd ~/projects/xhs-auto-publisher 116 bash deploy/run_with_xvfb.sh 117 ``` 118 119 ## 执行流程 120 121 1. 校验内容和图片 122 2. 检查重复发布保护 123 3. 启动持久化 Chromium profile 124 4. 读取登录缓存,默认 12 小时 125 5. 检查是否已登录 126 6. 如未登录,生成二维码截图并写出龙虾通知 payload 127 7. 龙虾把二维码图片发到飞书群 128 8. 用户扫码后继续 129 9. 上传图片、填写内容、触发发布 130 10. 保存截图、日志、DOM 快照和结果 JSON 131 132 ## 运行产物 133 134 每次执行都会写入: 135 136 ```text 137 runtime/runs/<timestamp>/ 138 ``` 139 140 包含: 141 142 - `actions.jsonl` 143 - `result.json` 144 - `content.normalized.json` 145 - `screenshots/*.png` 146 - `dom/*.html` 147 148 通知文件会写入: 149 150 ```text 151 runtime/lobster-notify/<run_id>/login_qr.payload.json 152 ``` 153 154 ## 文档入口 155 156 - [docs/cloud_deploy.md](./docs/cloud_deploy.md) 157 - [docs/DEPLOY_TODO.md](./docs/DEPLOY_TODO.md) 158 - [docs/LOBSTER_NOTIFY_PROTOCOL.md](./docs/LOBSTER_NOTIFY_PROTOCOL.md) 159 160 ## 当前定位 161 162 这不是并发平台,而是一套稳妥的单机顺序执行方案: 163 164 - 单机 165 - 单浏览器 166 - 单任务 167 - 人工扫码接管 168 - 有留痕 169 - 可复跑
djangopeng/agentic-ai commit de4cd62714
Frequently asked questions How do I install the Xhs Auto Publisher skill? Run npx get-skill add djangopeng/xhs-auto-publisher in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Xhs Auto Publisher skill do? 面向云服务器的小红书图文自动发布 Skill。适用于需要在 Linux 云服务器上,通过 Playwright/CDP、二维码人工接管、登录缓存、龙虾代发飞书群图片消息、截图留痕与审计日志来完成小红书草稿或发布流程的场景。 It is listed under Coding & Dev Tools on SkillMD.
Is Xhs Auto Publisher safe to use? SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Xhs Auto Publisher? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Xhs Auto Publisher free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Xhs Auto Publisher? djangopeng (@djangopeng) published this skill. Their other Agent Skills are listed on their SkillMD profile.