小红书操作指南(Chrome MCP)
适用于 Claude Code + Chrome MCP 扩展,让 Claude 通过浏览器操作小红书。
前置要求
- Claude Code:Anthropic 官方 CLI 工具
- Claude in Chrome 扩展:Chrome Web Store 安装(需 v1.0.36+)
- Chrome MCP 连接:安装扩展后,Claude Code 启动时加
--chrome参数,或在设置中启用 Chrome 集成
安装方式
将本文件夹复制到你的项目 .claude/skills/ 目录下:
你的项目/
├── .claude/
│ └── skills/
│ └── xiaohongshu/
│ ├── SKILL.md ← 本文件
│ └── references/
│ └── js-snippets.md
Claude Code 会自动识别 Skill 并在相关对话中加载。
使用前配置
评论签名
建议在每条评论末尾附上你的标识签名,方便辨认和验证发送是否成功。在 JS 代码片段中搜索 你的签名 替换为你自己的签名。
账号信息
在本文件顶部记录你的小红书账号名和主页 URL,方便 Claude 定位你的个人主页:
- 账号名:你的账号名
- 主页 URL:xiaohongshu.com/user/profile/你的用户ID
⚠️ 安全警告
禁止使用 CLI/API 工具进行互动操作(评论、回复、点赞、收藏)。 直接走 API 调用会被小红书风控系统检测到 AI 托管行为,触发账号违规预警。Chrome MCP 模拟真人浏览器操作,风险低得多。
即使用 Chrome MCP,也不要连续快速回复多条评论,每条之间保持自然间隔。
核心操作流程
第一步:确认登录状态
打开任意小红书页面后,先检查是否已登录。如果出现登录弹窗或跳转登录页,立即停止并告知用户,不要尝试自动登录。
第二步:导航到目标页面
关键机制 —— xsec_token:
小红书帖子 URL 需要 xsec_token 参数才能正常访问。这个 token 由站内的 Vue 应用在用户点击封面时动态生成。直接在地址栏输入帖子 URL(不带 token)会被拦截或跳转到首页。
正确做法:
- 先导航到一个列表页面(点赞页、搜索结果页、通知页、首页推荐)
- 在列表页面中点击帖子封面/标题,让页面自然跳转(会自动带上 xsec_token)
- 页面跳转后即可正常浏览和操作
第三步:阅读帖子内容
省 token 原则:JS 提取 > read_page 定点 > read_page 全扫 > 截图
优先用 JS 读取文字内容(参见 js-snippets.md),只在需要视觉确认(布局、按钮位置、图片内容)时才截图。
⚠️ 严禁用截图 OCR 识别文字内容。 颜文字、特殊符号、相似汉字的 OCR 识别率极低,会产生大量错别字。阅读帖子/评论/通知内容时,必须用 JS 提取文字。截图只用于确认页面布局和按钮位置。
读取文字
使用 js-snippets.md 中的"读取帖子文本"代码片段。
查看图片
很多帖子的核心内容在图片里(对话截图、文字卡片等),必须查看所有图片再评论。
操作方式:点击图片 → 进入图片查看器 → 右上角显示 当前/总数 → 用右箭头键或点击右侧箭头翻页 → 左上角 X 按钮关闭查看器
第四步:发表评论
找到评论输入框
评论框在帖子右侧评论区底部,定位方式(按优先级):
- JS 定位:
document.getElementById('content-textarea')或document.querySelector('[contenteditable="true"]') - 语义搜索:用
find工具搜索"说点什么"或"点击评论"
⚠️ 帖子页的评论框默认是收起状态。必须先物理点击(click())让它展开,展开后才会出现发送按钮。仅用 JS 的 focus() 不会展开评论框。
输入评论内容
聚焦输入框后用 Chrome MCP 的 type 动作打字。
发送评论
用 find 搜索"发送"按钮或 JS 定位发送按钮后点击。不要用 Enter 键发送(可能触发换行而非提交)。
验证评论
发送后等待 2 秒,用 JS 检查评论列表中是否包含你的签名关键字(参见 js-snippets.md 中的验证片段)。如果未找到且多次尝试失败,大概率是权限限制(如"仅好友可评论"),直接放弃该帖子。
第五步:返回列表继续下一篇
关键机制 —— 模态弹窗关闭: 从个人主页(点赞页、收藏页等)点击帖子封面时,帖子以**模态弹窗(overlay)**形式打开。评论完成后:
- 首选:点击弹窗外部区域关闭(推荐)——点击模态弹窗左侧的空白区域,弹窗关闭,滚动位置完美保持
- 备选:
navigate回列表页 URL——会重置滚动到顶部,需要重新滚动 - 不要用浏览器后退——行为不可预测
批量评论工作流
适用于"去点赞页评论 N 篇"这类任务。
帖子追踪(防重复)
用作者名 Set追踪已评论帖子。每完成一篇,将作者名加入 Set。详细代码见 js-snippets.md。
懒加载
点赞页初始只加载约 10 篇帖子,需要物理滚动(computer/scroll 工具)触发加载更多。JS 滚动无效。通常需要 2-4 轮、每轮 5-10 ticks 的滚动。
单帖操作循环
列表页 → 滚动加载 → JS找未评论帖子 → 点击封面(模态弹窗打开)→ 等待加载
→ JS读文本 → 看图片 → 找评论框 → 输入 → 发送 → 验证
→ 点击弹窗外部区域关闭(保持滚动位置)→ 重复
个人主页帖子操作
首选方案:window.__INITIAL_STATE__
小红书前端(Vue 3)把页面数据序列化存在 window.__INITIAL_STATE__ 全局变量中。个人主页的帖子数据在 state.user.notes 里,是一个二维数组(每个标签页一个子数组),无需滚动即可获取全部帖子。
数据需要用 _value 逐层解包 Vue 3 reactive proxy。输出中避免包含图片 URL(Chrome MCP 安全过滤会拦截带 query string 的 URL)。
详细 JS 代码见 js-snippets.md 中的"个人主页帖子提取"章节。
备选方案:DOM 滚动收集(data-index)
当 __INITIAL_STATE__ 不可用时,通过 DOM 渐进式滚动收集。每个 section.note-item 上有 data-index 属性代表真实位置,按此排序而非 DOM 顺序或视觉位置。
详细代码见 js-snippets.md。
通知页操作
通知页 URL:xiaohongshu.com/notification
点击"评论和@"标签查看评论通知。通知按时间倒序(最新在最上面)。
通知结构:每条通知中,对方的回复在上方,下面灰色小字是自己之前的评论(作为上下文)。不要把灰色文字误认为对方的回复。
回复通知的关键技术点
- 定位通知条目:用
.tabs-content-container的直接子元素(container.children[i]),不要用div.info选择器(会匹配到 460+ 个无关元素) - 输入框类型不同:通知页的输入框是
textarea.comment-input(与帖子页的contenteditablediv 不同) - Chrome MCP 的
type动作在通知页 textarea 上无效:value 始终为空。必须用 JS 的nativeInputValueSetter设值 - JS 字符串中直接写原始字符:绝对不要手动转 Unicode 转义码(
\uXXXX),否则会出现错字和乱码
详细代码见 js-snippets.md 的"通知页"章节。
工具对照表
| 操作 | Chrome MCP 工具 |
|---|---|
| 跳转 URL | navigate |
| 点击 | computer (left_click) / find + ref 点击 |
| 截图 | computer (screenshot) |
| 打字 | computer (type) |
| 滚动 | computer (scroll) |
| 执行 JS | javascript_tool |
| 读取 DOM | read_page (无障碍树) |
| 语义搜索元素 | find |
| 提取页面文字 | get_page_text |
| 键盘操作 | computer (key) |
| 标签页管理 | tabs_context_mcp |
| 等待 | computer (wait) |
小红书常见概念速查
评论区常见的概念,了解避免张冠李戴:
- momo:小红书上的匿名/默认用户名,叫 momo 的人非常多。不要通过用户名搜索 momo
- 小克:小红书用户对 Claude 的昵称,来源是"克劳德"的简称
- Clawd:Claude Code 的官方像素风吉祥物,是一只小螃蟹(Claw + d)。不是猫,不是牛
- MCP(Model Context Protocol):Anthropic 推出的协议,让 AI 模型连接外部工具
已知限制
- Toast 弹窗不可见:小红书的系统提示弹窗消失极快,截图无法捕捉。评论多次失败时直接放弃
- xsec_token 必需:直接输入帖子 URL 无法访问,必须从站内点击获取 token
- 评论框延迟渲染:帖子加载完成后评论框才出现,可能需要等待或滚动触发
- 图片上传:可以通过 Chrome MCP 的
file_upload工具上传图片到发帖页面,支持图文笔记发布
反模式(不要这样做)
- 不要自己开新标签页访问帖子 URL。没有 xsec_token 会失败
- 不要在本地创建文件写评论草稿。直接在浏览器评论框里操作
- 不要跳过图片直接评论。很多帖子核心内容在图片里
- 不要依赖截图 OCR 识别文字。用 JS 提取
- 不要在找不到元素时无限重试。截图确认后改用其他定位方式,或告知用户
- 不要用 Enter 键发送评论。找到"发送"按钮点击它
- 不要忽视已打开的页面自己重新导航。先确认当前页面状态
- 不要尝试自动登录。遇到登录页面立即停止并告知用户
- 不要用 CLI/API 工具互动。只用 Chrome MCP 浏览器操作