反检测浏览器会话

技能简介

browser-cash 提供云端托管的真实浏览器环境，通过 WebSocket CDP 协议连接。会话自动处理 Cloudflare、DataDome 等反机器人检测，适用于需要模拟真实用户行为的网页操作场景。

业务背景

反检测浏览器会话帮助业务人员绕过网站的反爬虫机制，在云端运行真实浏览器环境。无需自建基础设施，即可模拟指定国家、窗口尺寸的真实用户行为，自动处理Cloudflare等防护验证。适用于数据采集、自动化测试等需要稳定网页访问的场景，降低技术团队维护成本。

落地案例：某电商运营团队需定期监控竞品价格与库存。通过创建美国区域的浏览器会话，配合Playwright脚本自动登录目标网站，系统绕过反机器人检测完成页面抓取。Cookie持久化功能让每日任务无需重复登录，运营人员直接获取结构化数据用于定价决策。

能做什么

• 创建指定国家/窗口尺寸的隔离浏览器会话
• 通过 Playwright/Puppeteer 直接控制远程浏览器
• 持久化存储 Cookie 与登录状态供后续复用
• 自动绕过主流反爬虫防护机制

使用说明

1. 安装依赖

# 检查并安装 Node.js 依赖
if [ ! -d ~/clawd/node_modules/playwright ]; then
  cd ~/clawd && npm install playwright puppeteer-core
fi

2. 配置 API 密钥

# 从 https://dash.browser.cash 获取密钥后执行
clawdbot config set skills.entries.browser-cash.apiKey "your_key_here"

3. 读取密钥变量

BROWSER_CASH_KEY=$(clawdbot config get skills.entries.browser-cash.apiKey)

4. 创建并连接会话

# 创建会话
SESSION=$(curl -s -X POST "https://api.browser.cash/v1/browser/session" \
  -H "Authorization: Bearer $BROWSER_CASH_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "US", "windowSize": "1920x1080"}')

CDP_URL=$(echo $SESSION | jq -r '.cdpUrl')

# 使用 Playwright 连接
node -e "
const { chromium } = require('playwright');
(async () => {
  const browser = await chromium.connectOverCDP('$CDP_URL');
  const page = browser.contexts()[0].pages()[0];
  await page.goto('https://example.com');
  console.log(await page.title());
  await browser.close();
})();
"

5. 结束会话

curl -X DELETE "https://api.browser.cash/v1/browser/session?sessionId=$SESSION_ID" \
  -H "Authorization: Bearer $BROWSER_CASH_KEY"

输入与输出

见下方输入与输出表格。

风险提示

• API 密钥需妥善保管，避免泄露导致账户被盗用
• 按量计费服务，长时间运行会话会产生持续费用
• 部分网站可能检测云端 IP 段，建议配合代理使用
• Clawdbot 原生 browser 工具不兼容原始 CDP URL，须通过 exec 调用 Node.js

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/alexander-spring/browser-cash/SKILL.md
来源类型：GitHub 仓库