用途:通过 Browser.cash 启动未被封锁的浏览器会话,用于网页自动化,包括抓取、表单填写、测试和截图。会话以真实浏览器指纹呈现,自动处理机器人检测,可绕过 Cloudflare、DataDome、PerimeterX 等防护。
主要能力:创建、查询、列出和停止浏览器会话;支持指定国家(2 位 ISO 代码)、窗口尺寸、SOCKS5 代理;支持命名浏览器配置文件以持久化 Cookie、localStorage 和会话数据,便于保持登录状态。会话返回 WebSocket CDP 地址,可配合 Playwright、Puppeteer 或原生 CDP 使用。
使用方式:API Key 存于 clawdbot 配置 skills.entries.browser-cash.apiKey,可用 clawdbot config set skills.entries.browser-cash.apiKey "your_key_here" 设置,用 clawdbot config get 读取。首次使用前检查并安装依赖:if [ ! -d ~/clawd/node_modules/playwright ]; then cd ~/clawd && npm install playwright puppeteer-core; fi。创建会话:curl -X POST "https://api.browser.cash/v1/browser/session" -H "Authorization: Bearer $BROWSER_CASH_KEY" -H "Content-Type: application/json" -d '{}'。返回 sessionId、status、cdpUrl 等。用 Playwright 连接:chromium.connectOverCDP(cdpUrl);Puppeteer 用 puppeteer.connect({ browserWSEndpoint: cdpUrl })。完成后停止会话:curl -X DELETE "https://api.browser.cash/v1/browser/session?sessionId=$SESSION_ID" -H "Authorization: Bearer $BROWSER_CASH_KEY"。
适用场景:需要绕过反爬保护的抓取、自动化测试、截图、表单填写等。抓取懒加载或无限滚动页面时,应滚动到底部触发内容加载,等待 networkidle,使用 waitForSelector,并在操作间加延迟。
限制:会话在长时间不活动后自动终止;SOCKS5 是唯一支持的代理类型;Clawdbot 原生浏览器工具需要 HTTP 控制服务器 URL,不直接支持原始 WebSocket CDP,需用 exec 方式;脚本从 ~/clawd/ 运行,npm 依赖需安装在该目录。API Key 需从 https://dash.browser.cash 获取。