Browser Use

Browser Use 是一个面向 AI 代理的开源浏览器自动化项目，已获得 超过 100,000 GitHub stars，同时提供托管的 Cloud 浏览器服务。在本地浏览器不可用的环境（如 serverless 和 CI 环境）中运行 agent-browser 时，Browser Use Cloud 非常有用。

设置¶

export BROWSER_USE_API_KEY="your-api-key"
agent-browser -p browseruse open https://example.com

或者为 CI/脚本使用环境变量：

export AGENT_BROWSER_PROVIDER=browseruse
export BROWSER_USE_API_KEY="your-api-key"
agent-browser open https://example.com

-p 标志优先于 AGENT_BROWSER_PROVIDER。

浏览器设置¶

export BROWSER_USE_PROFILE_ID="your-profile-uuid"
export BROWSER_USE_PROXY_COUNTRY="de"
export BROWSER_USE_ENABLE_RECORDING="true"
agent-browser -p browseruse open https://example.com

启用后，agent-browser 会创建 Browser Use Cloud V4 会话并连接到其 CDP 端点。Browser Use 设置阶段限制为 18 秒，如果设置超时，最多还有 4 秒用于清理。在设置过程中，创建等待最多 10 秒，CDP 连接等待最多 8 秒；每个停止请求等待最多 4 秒。导航及其他页面命令保持原有超时时间。如果在返回浏览器 id 之前创建失败，结果是未知的；在重试之前请检查 Browser Use Cloud 仪表盘，因为浏览器可能仍已被创建。

Cloud 浏览器会在命令之间保持活动状态。任务完成后运行 agent-browser close。守护进程也会在退出时尝试清理，包括其默认的一小时空闲超时；停止操作失败可能导致 Cloud 浏览器继续运行。

关闭与恢复¶

如果停止操作持续返回 404，请在 Browser Use Cloud 中验证浏览器状态。在确认其已停止后，使用新的 --session 名称继续；agent-browser 不会将 404 视为成功停止的证据。

只有在 Browser Use 确认浏览器已停止后，close 才会成功。如果停止失败，close 会返回错误并保留会话 id，因此再次运行 agent-browser close 会重试同一个浏览器，并且在待处理的浏览器被释放之前，新的启动会被阻止。

如果在停止成功之前守护进程退出，请检查 Browser Use Cloud 仪表盘并在那里停止浏览器。

从 Browser Use Cloud Dashboard 获取你的 API 密钥。