# Xhs Interact

> 小红书社交互动——发表评论、回复评论、点赞、取消点赞、关注、取关。camoufox-cli 纯浏览器操作，复用 `xhs-browse` 持久化 session。

- Skill: `teamwiseflow/xhs-interact` (Agent Skill)
- Install (CLI): `npx skillmds@latest add teamwiseflow/xhs-interact`
- Raw SKILL.md: https://api.skillmd.com/api/skills/teamwiseflow/xhs-interact/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: teamwiseflow (https://skillmd.com/u/teamwiseflow)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/teamwiseflow/xhs-interact

---


# xhs-interact — 工具说明

> 本文是 `expert-bd` 专家包内的工具说明书，不独立出现在技能列表中。由相关 Workflow 指引调用。

在小红书上执行互动操作：发表评论、回复评论、点赞 / 取消点赞、关注 / 取关。

**输入**：笔记 URL（含 `feed_id` + `xsec_token`）或用户主页（`user_id`）+ 操作内容（评论 / 回复文本等）。
**输出**：操作结果（以 snapshot 验证状态变化为准）。

通过 **camoufox-cli** 完成（纯浏览器操作）——**复用 `xhs-browse` 持久化 session**（消费者域 `www.xiaohongshu.com`，与 `xhs-content-ops` / `viral-chaser` / `published-track` 共用）。同一 session 一个且只有一个持久化实例，fail-first 队列：同 session 已有命令在跑时新命令直接 fail，浏览器操作串行排队。

**关键边界**：登录态直接复用 `xhs-browse` 持久化 session（登录态 + 指纹冻结在 session profile 里）——**不开独立临时 session、不 import cookie**。登录后导出的 cookie + UA 是给**其他脚本类技能**（`xhs-content-ops` / `viral-chaser` / `published-track` 等）做 raw HTTP 抓取用的，**本工具自身不消费 cookie 文件**。

---

## 如果登录失效：使用 login-manager 重新登录

走 login-manager skill 流程，复用 `xhs-browse` 持久化 session（消费者域 `www.xiaohongshu.com`）：

```bash
camoufox-cli --session xhs-browse --persistent --headed --json open "https://www.xiaohongshu.com/"
# 告知用户在窗口里手动扫码登录，确认后：
login-manager --platform xhs-browse
```

login-manager 一条命令闭环导出+验证+落中央存储（供其他脚本类技能消费，非本工具自用）+ close session。

---

## session 使用约定

互动操作**直接在 `xhs-browse` 持久化 session 上跑**——不开独立 session、不 import cookie（camoufox-cli 浏览器方案严禁 `cookies import` 造会话）。下文所有 `camoufox-cli` 命令统一用 `--session xhs-browse --persistent`，若该 session 正被其他浏览器操作占用（fail-first 拒绝 → 命令报 session 正忙），等其完成再串行接力，**不要**自动 close 正在跑的 session。

```bash
# 全文下方 $SESSION 一律指 xhs-browse 持久化 session
SESSION="xhs-browse"
```

任务结束后**close 该 session**——持久化 session 登录态在磁盘 profile，不留进程占内存；后续用 `--session xhs-browse --persistent` 重起无头即恢复。互动过程中任何时候发现登录已失效则走 login-manager 有头重登流。

---

## 获取 feed_id 和 xsec_token

所有互动操作需要 `feed_id` 和 `xsec_token`，从浏览器地址栏获取（snapshot eval）：

```
笔记 URL 格式：
https://www.xiaohongshu.com/explore/{feed_id}?xsec_token={xsec_token}&xsec_source=pc_feed

示例：
https://www.xiaohongshu.com/explore/64abc123def456?xsec_token=ABxxxxxx&xsec_source=pc_feed
→ feed_id    = 64abc123def456
→ xsec_token = ABxxxxxx
```

camoufox 拿当前 URL：
```bash
camoufox-cli --session "$SESSION" --json eval "window.location.href"
```

## Feed 详情页 URL 格式

```
https://www.xiaohongshu.com/explore/{feed_id}?xsec_token={xsec_token}&xsec_source=pc_feed
```

---

## 必做约束

- 批量操作时每次之间保持 30-60 秒间隔，避免风控。
- 每天评论不超过 20 条。

---

## 操作流程（camoufox-cli 版本）

> 每条操作都用 `camoufox-cli` 的 `snapshot` / `eval` / `click` / `type` 子命令实现，**统一在 `xhs-browse` 持久化 session 上跑**（`$SESSION` = `xhs-browse`，不开独立 session、不 import cookie）。
>
> 找不到元素时**不要**盲试：先 `snapshot` 看 DOM 真实结构，再决定 selector 改写。

### 发表评论

```
1. 导航到 feed 详情页：
   camoufox-cli --session "$SESSION" --persistent open <feed_url>
2. 等待 2-3 秒加载（sleep 3），调 snapshot 看 .access-wrapper / .error-wrapper
   是否出现 → 出现则笔记不可访问，停止并告知用户
3. 找评论输入框 .content-input，触发 input 事件（用 type 子命令）：
   camoufox-cli --session "$SESSION" --json type ".content-input" "评论内容"
4. 触发 input 事件（camoufox type 已隐含触发，确认 snapshot 看到值变化）
5. 找发送按钮并 click：
   camoufox-cli --session "$SESSION" --json click "<send-btn-selector>"
6. 等待 1-2 秒（sleep 2），调 snapshot 确认评论出现在评论区
```

### 回复评论

```
1. 导航到 feed 详情页（camoufox-cli open）
2. 等待 2-3 秒加载，确认页面可访问
3. 滚动到目标评论：
   - 已知 comment_id：eval "document.querySelector('#comment-${comment_id}').scrollIntoView()"
   - 已知 user_id：eval "document.querySelector('[data-user-id=\"${user_id}\"]').scrollIntoView()"
   - 若需滚动加载更多评论：eval 多次 window.scrollBy(0, 800) + sleep 1
     观察 .end-container 出现即到底（最多 7 次）
4. 点击目标评论的回复按钮（.interactions .reply）：
   camoufox-cli --session "$SESSION" --json click ".interactions .reply"
5. 输入回复内容到 .content-input（camoufox type 子命令）
6. 点击发送按钮（camoufox click）
7. sleep 1-2s，snapshot 确认回复已发出
```

### 点赞 / 取消点赞

**选择器**：`.like-wrapper`（推荐）或 `.interact-container .left .like-wrapper`

```
1. 导航到 feed 详情页
2. 等待 2-3 秒加载
3. 检查当前点赞状态（eval）：
   camoufox-cli --session "$SESSION" --json eval \
     "document.querySelector('.like-wrapper').classList.contains('like-active')"
4. 若需点赞，click 点赞按钮（推荐 JS 方式，最稳）：
   camoufox-cli --session "$SESSION" --json eval \
     "document.querySelector('.like-wrapper').click(); 'ok'"
5. sleep 1-2s，eval 验状态：
   camoufox-cli --session "$SESSION" --json eval \
     "document.querySelector('.like-wrapper').classList.contains('like-active')"
6. 若状态未变化，重试一次；仍失败则报告
```

> 若 `click` / `eval` 触发风控：等 60s 后在同一 `xhs-browse` 持久化 session 上重试（不开新 session、不 import cookie）；仍触发则报告用户该平台当日风控未解，转其他笔记或择日再试。

### 关注 / 取关

#### 关注用户

```
1. 导航到用户主页：camoufox-cli ... open "https://www.xiaohongshu.com/user/profile/${user_id}"
2. sleep 3 加载
3. 找关注按钮：snapshot 找文本为"关注"的按钮 / eval ".user-actions .follow-btn"
4. click 关注按钮
5. sleep 1-2s，snapshot 确认按钮变为"已关注"
```

#### 取关用户

```
1. 导航到用户主页
2. 找"已关注"按钮（同上 selector）
3. click 后确认弹出确认框，click"取消关注"
4. sleep 1-2s，确认按钮变为"关注"
```

---

## Pitfalls

### pitfall: xsec_token_required

- **触发**：手拼 `/explore/{feed_id}` 裸路径，没带 `xsec_token`
- **症状**：页面 403 或 redirect 到错误页（`error_code=300017` 或 `300031`）
- **workaround**：feed_id + xsec_token **必须从搜索结果/笔记列表的链接中提取**，不能手拼 URL。如果只有 feed_id，先搜索对应笔记获取 signed URL

### pitfall: like_count_compressed_format

- **触发**：读取点赞数时
- **症状**：显示 `2.1w`、`1.5万`、`1.2k` 等压缩格式而非数字
- **workaround**：解析规则：`w` = 万 = ×10000，`万` = ×10000，`k` = ×1000。例：`2.1w` = 21000，`1.5万` = 15000，`1.2k` = 1200

### pitfall: security_block_on_repeated_access

- **触发**：短时间高频互动（连续点赞/评论多个笔记）
- **症状**：页面显示"安全限制"/"访问链接异常"
- **workaround**：每次操作间隔 30-60 秒；触发后 60s 内不重试

### pitfall: comment_section_lazy_load

- **触发**：需要找到较早的评论
- **症状**：评论未出现在 DOM 中
- **workaround**：逐段向下滚动加载（eval window.scrollBy + sleep），每次滚动后等待 0.5-1 秒；到达 `.end-container` 说明到底部；最多滚动 7 次

### pitfall: creator_center_is_different_host

- **触发**：在主站 `www.xiaohongshu.com` 找发布/草稿入口
- **症状**：主站无完整创作者功能
- **workaround**：创作者相关操作（查看草稿、创作者数据）需访问 `creator.xiaohongshu.com`

### pitfall: session_busy_fail_first

- **触发**：`xhs-browse` 持久化 session 正被其他浏览器操作（`xhs-content-ops` 等）占用，新命令撞 fail-first 队列
- **症状**：命令报「session xhs-browse 正忙」/ 类似 SessionBusy 错误
- **workaround**：这是**预期行为**（单一持久化 session + fail-first 队列）。等当前占用方完成再串行接力，**不要**自动 close 正在跑的 session（close 会 tear down 别人的操作）。

### pitfall: cookie_expired_during_interaction

- **触发**：互动过程中小红书 session 过期
- **症状**：页面突然 redirect 到 login / 互动操作 401
- **workaround**：暂停当前操作 → 重走 login-manager 有头登录流（在同一个 `xhs-browse` 持久化 session 上 `--headed open` + 用户手动扫码 + 导出 cookie+UA 落中央存储给其他脚本技能用）→ 在同一 session 上重试；不要盲 retry、不要开独立 session import cookie

---

## 错误处理

| 情况 | 处理 |
|------|------|
| 页面出现登录墙 | 同上重走 login-manager 登录流 |
| 点赞状态未变化 | 重试一次，仍未变化则报告错误 |
| camoufox click/eval 失败 / 超时 | 改用 `eval` 走 JS 方式（最稳）；再失败 → 等 60s 后在同一 session 上重试（不开新 session、不 import cookie） |
| `xhs-browse` session 正忙（fail-first 拒绝） | 这是预期行为，等当前占用方完成再串行接力，不自动 close 正在跑的 session |
| xsec_token 缺失/无效 | 从搜索结果链接中重新获取 signed URL，不要手拼 |
| 安全限制/访问异常 | 停止操作 60 秒后重试，或换笔记操作 |