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）：

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。

# 全文下方 $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：

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

错误处理