用途:通过 Browser.cash API 创建云端浏览器会话,用于网页自动化,如抓取、表单填写、测试、截图等原本可能被反爬机制拦截的任务。据资料,该类会话可绕过 Cloudflare、DataDome、PerimeterX 等常见防护,并呈现为真实浏览器指纹。
主要能力:支持创建、查询状态(starting、active、completed、error)、停止和列出会话;可设置国家(两位 ISO 代码)、窗口尺寸、SOCKS5 代理;支持命名配置文件以持久化 Cookie、localStorage 和会话数据;返回 WebSocket CDP URL,可连接 Playwright、Puppeteer 或原生 CDP。
使用方式:密钥保存在 clawdbot 配置 skills.entries.browser-cash.apiKey,可用 clawdbot config get 读取,通过 clawdbot config set 设置。首次使用前检查并安装依赖: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 与 cdpUrl,可用 Playwright 的 chromium.connectOverCDP(cdpUrl) 或 Puppeteer 的 browserWSEndpoint 连接,完成后用 DELETE 停止会话。注意 Clawdbot 原生浏览器工具期望 HTTP 控制服务器而非原始 WebSocket,直连 CDP 需用 exec 方式。
适用场景:需要规避反爬的抓取、需要保持登录态的多会话操作、按国家定向的页面测试等。
限制:会话在长时间不活动后自动终止;应主动停止以避免额外用量;仅支持 SOCKS5 代理;脚本从 ~/clawd/ 运行,npm 依赖需装在该目录;完整页面抓取时应滚动以触发懒加载。其他信息暂未提供。