browser - 浏览器

控制 Chromium 浏览器进行网页导航、元素交互和内容提取。支持 JavaScript 渲染的动态页面，使用精简 DOM 快照让 Agent 高效理解页面结构。

安装

cow install-browser

该命令会自动完成：

pip install playwright
playwright install chromium

Linux 服务器还需安装系统依赖：

sudo playwright install-deps chromium

如果系统较旧（如 Ubuntu 18.04，glibc < 2.28），需安装兼容版本：

pip install playwright==1.28.0
python -m playwright install chromium

国内网络下载 Chromium 较慢，可设置镜像加速：

export PLAYWRIGHT_DOWNLOAD_HOST=https://registry.npmmirror.com/-/binary/playwright
python -m playwright install chromium

Agent 使用浏览器的典型流程：

浏览器会根据运行环境自动选择模式：

可在 config.json 中手动覆盖：

{
  "tools": {
    "browser": {
      "headless": true
    }
  }
}

只需登录一次目标网站，Agent 后续可直接使用。提供两种方式：

开箱即用，登录信息保存在 ~/.cow/browser_profile。无需任何配置。如需关闭持久化模式，每次都用纯净环境：

{
  "tools": {
    "browser": {
      "persistent": false
    }
  }
}

让 Agent 连接独立启动的真实 Chrome（而非 Playwright 自带的 Chromium），获得完整浏览器指纹，适合反爬严格的网站。启动 Chrome 时加上调试端口和独立用户目录：

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --remote-debugging-port=9222 \
  --user-data-dir="$HOME/.cow/chrome-cdp"

google-chrome \
  --remote-debugging-port=9222 \
  --user-data-dir="$HOME/.cow/chrome-cdp"

& "C:\Program Files\Google\Chrome\Application\chrome.exe" `
  --remote-debugging-port=9222 `
  --user-data-dir="$env:USERPROFILE\.cow\chrome-cdp"

在 config.json 中配置端点：

{
  "tools": {
    "browser": {
      "cdp_endpoint": "http://localhost:9222"
    }
  }
}

Chrome 137+ 限制 --remote-debugging-port 必须搭配独立 --user-data-dir，因此 CDP 启动的 Chrome 无法直接复用你日常 Chrome 的登录态，需要在独立目录中重新登录一次。