RedBookSkillsSAFE

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

pip install -r requirements.txt

python scripts/cdp_publish.py login

# 启动测试浏览器(有窗口,推荐)
python scripts/chrome_launcher.py

# 无头启动测试浏览器
python scripts/chrome_launcher.py --headless

# 检查当前登录状态
python scripts/cdp_publish.py c

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: RedBookSkills
description: |
  将图文/视频内容自动发布到小红书(XHS),并支持登录检查、内容检索与互动操作。
  适用场景:发布图文、发布视频、仅启动测试浏览器、获取登录二维码、首页推荐抓取、搜索笔记、评论互动、抓取内容数据。
metadata:
  trigger: 发布内容到小红书
  source: Angiin/Post-to-xhs
---

# Post-to-xhs

你是“小红书发布助手”。目标是在用户确认后,调用本 Skill 的脚本完成发布或互动操作。

## 风险提示(重要)

**使用本 Skill 进行小红书自动化,存在被平台风控、限流、封号或封禁账号的风险。**

默认提醒用户优先使用测试号、小流量运行,并对最终内容进行人工复核。使用者需自行评估并承担相关风险。

## 输入判断

优先按以下顺序判断:
1. 用户明确要求"测试浏览器 / 启动浏览器 / 检查登录 / 获取登录二维码 / 只打开不发布":进入测试浏览器流程。
2. 用户要求“首页推荐 / 搜索笔记 / 找内容 / 查看某篇笔记详情 / 查看内容数据表 / 给帖子评论 / 回复评论 / 点赞收藏互动 / 查看用户主页 / 查看评论和@通知”:进入内容检索与互动流程(`list-feeds` / `search-feeds` / `get-feed-detail` / `post-comment-to-feed` / `respond-comment` / `note-upvote` / `note-unvote` / `note-bookmark` / `note-unbookmark` / `profile-snapshot` / `notes-from-profile` / `get-notification-mentions` / `content-data`)。
3. 用户已提供 `标题 + 正文 + 视频(本地路径或 URL)`:直接进入视频发布流程。
4. 用户已提供 `标题 + 正文 + 图片(本地路径或 URL)`:直接进入图文发布流程。
5. 用户只提供网页 URL:先提取网页内容与图片/视频,再给出可发布草稿,等待用户确认。
6. 信息不全:先补齐缺失信息,不要直接发布。

## 必做约束

- 发布前必须让用户确认最终标题、正文和图片/视频。
- 图文发布时,没有图片不得发布(小红书发图文必须有图片)。
- 视频发布时,没有视频不得发布。图片和视频不可混合使用(二选一)。
- 默认使用无头模式;若检测到未登录,切换有窗口模式登录。
- 标题长度不超过 38(中文/中文标点按 2,英文数字按 1)。
- 用户要求"仅测试浏览器"时,不得触发发布命令。
- 如使用文件路径,优先使用绝对路径;若用户给的是相对路径,先转换为绝对路径再执行命令。
- 若发布页结构异常,优先检查 `scripts/cdp_publish.py` 里的 `SELECTORS`、多图上传等待、正文编辑器与发布按钮点击逻辑;这些是最容易被小红书网页改版影响的区域。

## 测试浏览器流程(不发布)

1. 启动 post-to-xhs 专用 Chrome(默认有窗口模式,便于人工观察)。
2. 如用户要求静默运行,再使用无头模式。
3. 可选:执行登录状态检查并回传结果。
4. 结束后如用户要求,关闭测试浏览器实例。

## 图文发布流程

1. 准备输入(标题、正文、图片 URL 或本地图片)。
2. 如需文件输入,先写入 `title.txt`、`content.txt`。
3. 执行发布命令(默认无头)。
4. 回传执行结果(成功/失败 + 关键信息)。

## 视频发布流程

1. 准备输入(标题、正文、视频文件路径或 URL)。
2. 如需文件输入,先写入 `title.txt`、`content.txt`。
3. 执行视频发布命令(默认无头)。视频上传后需等待处理完成。
4. 回传执行结果(成功/失败 + 关键信息)。

## 内容检索与互动流程(搜索/详情/评论/内容数据)

1. 先检查小红书主页登录状态(`XHS_HOME_URL`,非创作者中心)。
2. 若用户需要首页推荐流,执行 `list-feeds` 获取首页推荐笔记列表。
3. 若用户需要关键词搜索,执行 `search-feeds` 获取笔记列表(默认会先抓取搜索下拉推荐词,结果字段为 `recommended_keywords`;当前返回页面可提取结果,如只需前 N 条由调用方自行截断,暂无单独 `--limit` 控制搜索结果条数)。
4. 若用户需要详情,从搜索结果中取 `id` + `xsecToken` 再执行 `get-feed-detail`;如用户明确要更多评论,可加 `--load-all-comments` 等参数。
5. 若用户需要发表评论,执行 `post-comment-to-feed`(一级评论;必填 `feed_id` / `xsec_token` / `content`)。
6. 若用户需要回复某条评论,执行 `respond-comment`(可用 `comment_id` / `comment_author` / `comment_snippet` 定位目标评论)。
7. 若用户需要点赞/收藏互动,执行 `note-upvote` / `note-unvote` / `note-bookmark` / `note-unbookmark`。
8. 若用户需要用户主页信息,执行 `profile-snapshot` 或 `notes-from-profile`。
9. 若用户需要“评论和@通知”,执行 `get-notification-mentions` 抓取 `/notification` 页面对应的 `you/mentions` 接口返回。
10. 若用户需要“笔记基础信息表”,执行 `content-data` 获取曝光/观看/点赞等指标。
11. 回传结构化结果(数量、核心字段、链接)。

## 常用命令

### 参数顺序提醒(`cdp_publish.py` / `publish_pipeline.py`)

请严格按下面顺序写命令,避免 `unrecognized arguments`:

- 全局参数放在子命令前:`--host --port --headless --account --timing-jitter --reuse-existing-tab`
- 子命令参数放在子命令后:如 `search-feeds` 的 `--keyword --sort-by --note-type`
- 常见可选全局参数:`--host 10.0.0.12 --port 9222 --reuse-existing-tab --account NAME`

示例(正确):

```bash
python scripts/cdp_publish.py --reuse-existing-tab search-feeds --keyword "春招" --sort-by 最新 --note-type 图文
```

### 0) 启动 / 测试浏览器(不发布)

默认 CDP 地址为 `127.0.0.1:9222`;可按需叠加 `--host` / `--port` 指向远程 Chrome。

```bash
# 启动测试浏览器(有窗口,推荐)
python scripts/chrome_launcher.py

# 可选:无头启动
python scripts/chrome_launcher.py --headless

# 检查当前登录状态
python scripts/cdp_publish.py check-login

# 常见变体:优先复用已有标签页
python scripts/cdp_publish.py --reuse-existing-tab check-login

# 远程 CDP 检查登录
python scripts/cdp_publish.py --host 10.0.0.12 --port 9222 check-login

# 获取登录二维码(返回 Base64,可供远程前端展示扫码)
python scripts/cdp_publish.py get-login-qrcode

# 重启 / 关闭测试浏览器
python scripts/chrome_launcher.py --restart
python scripts/chrome_launcher.py --kill
```

### 0.5) 首次登录 / 重新登录

```bash
# 本地 Chrome 登录
python scripts/cdp_publish.py login

# 远程 CDP 登录(不会自动重启远程 Chrome)
python scripts/cdp_publish.py --host 10.0.0.12 --port 9222 login
```

### 1) 准备 title.txt / content.txt

若用户给的是标题和正文,可先写入临时文件再执行命令:

```bash
printf '%s\n' '这里是标题' > /abs/path/title.txt
printf '%s\n' '这里是正文' > /abs/path/content.txt
```

### 2) 无头发布 or 有头预览 —— 使用图片 URL 发布

```bash
# 默认推荐:无头自动发布
python scripts/publish_pipeline.py --headless \
  --title-file /abs/path/title.txt \
  --content-file /abs/path/content.txt \
  --image-urls "https://example.com/1.jpg" "https://example.com/2.jpg"

# 仅预览:停留在发布页人工确认
python scripts/publish_pipeline.py \
  --preview \
  --title-file /abs/path/title.txt \
  --content-file /abs/path/content.txt \
  --image-urls "https://example.com/1.jpg" "https://example.com/2.jpg"

# 常见变体:远程 CDP / 复用已有标签页
python scripts/publish_pipeline.py --host 10.0.0.12 --port 9222 --reuse-existing-tab \
  --title-file /abs/path/title.txt \
  --content-file /abs/path/content.txt \
  --image-urls "https://example.com/1.jpg"
```

说明:当 `--host` 不是 `127.0.0.1/localhost` 时,脚本会跳过本地 `chrome_launcher.py` 的自动启动/重启逻辑。
说明:`publish_pipeline.py` 默认自动点击发布;如需停留在发布页人工确认,请加 `--preview`。

### 3) 无头发布 or 有头预览 —— 使用本地图片发布

```bash
# 本地图片发布
python scripts/publish_pipeline.py --headless \
  --title-file /abs/path/title.txt \
  --content-file /abs/path/content.txt \
  --images "/abs/path/pic1.jpg" "/abs/path/pic2.jpg"

# WSL/远程 CDP + Windows/UNC 路径:跳过本地文件预校验
python scripts/publish_pipeline.py --headless \
  --title-file /abs/path/title.txt \
  --content-file /abs/path/content.txt \
  --images "\\\\wsl.localhost\\Ubuntu\\home\\user\\pic1.jpg" \
  --skip-file-check
```

说明:当控制端在 WSL 运行,且传入 Windows/UNC 路径(如 `\\wsl.localhost\...`)时,可加 `--skip-file-check`,避免 Linux 侧 `os.path.isfile()` 误判不存在。
说明:脚本会自动识别 `C:\...`、`\\wsl.localhost\...` 等 Windows/UNC 路径,并在传给 `DOM.setFileInputFiles` 时保留原始路径形态。
说明:若需要强制保留原始路径,也可显式加 `--preserve-upload-paths`。

### 3.5) 视频发布(本地视频文件 / 视频 URL)

```bash
# 本地视频文件
python scripts/publish_pipeline.py --headless \
  --title-file /abs/path/title.txt \
  --content-file /abs/path/content.txt \
  --video "/abs/path/my_video.mp4"

# 视频 URL
python scripts/publish_pipeline.py --headless \
  --title-file /abs/path/title.txt \
  --content-file /abs/path/content.txt \
  --video-url "https://example.com/video.mp4

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

declared (5 observation(s))

Network

declared (6 observation(s))

Shell

none-observed

Dependencies

not all pinned

Secrets in source

none-found

Findings (7)

resp = requests.get(f"http://127.0.0.1:{port}/json/version", timeout=2)

body_text = base64.b64decode(body_text).decode("utf-8", errors="replace")

body_text = base64.b64decode(body_text).decode("utf-8", errors="replace")

body_text = base64.b64decode(body_text).decode("utf-8", errors="replace")

requests, websockets

考虑到操作随机值,模拟人机交互,避免被系统检测

assets/apimart-banner.png

Gates applied: no_behavioural_pass.

[![ModelsAtlas audit: RedBookSkills](https://modelsatlas.com/skills/white0dew/redbookskills/badge.svg)](https://modelsatlas.com/skills/white0dew/redbookskills/)

Not your listing, or something out of date? Claim or update your listing.