Patchright 隐身浏览

要解决什么问题

很多站点的登录、表单与数据页会叠 Cloudflare、Akamai、Datadome 等主动反爬。普通 Playwright/Puppeteer 往往在第一屏就被指纹或挑战页拦住，Agent 既拿不到稳定 DOM，也很难复用登录态。

本技能把 OpenClaw Agent 接到 patchright-mcp 上，用修补过的 Chromium 做「尽量像真人」的浏览与操作。注意：它强依赖 patchright-mcp 已在 OpenClaw 里正确安装、配置并运行；该服务端仓库为私有，需要你有权限与凭证。

核心能力与用法

能力被收敛为四类 MCP 工具：

• patchright_navigation：打开/关闭页面、navigate、取 HTML、截图
• patchright_interaction：点击、输入、选项、滚动、全局按键、wait_for 同步、bulk_fill 批量填表
• patchright_session：读/写/清空 Cookie，便于跨步骤复用登录
• patchright_execution：snapshot 拉取可交互元素与选择器，evaluate 执行页面脚本

推荐流程很固定：先用 navigate 进站 → 用 snapshot 拿选择器再交互 → 多字段表单用 bulk_fill 而不是反复 fill → 动态内容用 wait_for → 关键步骤后 screenshot 自检 → 结束时 close 释放进程。需要模拟设备时，可在 open/navigate 里覆盖 headless、userAgent、viewport、deviceScaleFactor。

适用边界

• 遇到 CAPTCHA/拦截页：先截图确认，交给人工或等待，不要无脑重试导航。
• evaluate 跑在隔离上下文：要在主页面留状态，用 DOM 属性（如 data-state）而不是 window.xxx。
• 点击超时可先 wait_for visible，必要时用 evaluate 触发原生 click()。
• 远程 CDP（如 9222）断开时，服务端可能回退本地子进程；可重试 open 判断是否崩溃。