browser-use/browser-harness

Let Claude Code, Codex or Cursor use your real Chrome, logged in as you. One prompt to set up. Open source, MIT.

Browser Harness – 它是什么

Browser Harness 是一个开源桥梁,让大语言模型编码代理(Claude Code、Codex、Cursor 等)能够通过 Chrome DevTools Protocol(CDP)控制真实的 Chrome 浏览器。通过安装 Python 包并向代理提供一行设置提示,代理可以在保持用户浏览器配置文件登录状态的同时,打开页面、点击、输入、读取内容并下载文件。


工作原理

  1. 安装与连接 – 运行提供的 install.md 脚本(或一行提示),该脚本安装 browser-harness Python 包(通过 uv)并注册一个技能(browser-harness skill)。脚本会打开 Chrome 的远程调试页面(chrome://inspect/#remote-debugging),并要求用户启用远程调试。
  2. 技能定义 – SKILL.md 描述了代理应遵循的高级工作流程(打开页面、定位元素、点击等)。
  3. 代理生成的辅助函数 – 当代理需要新的辅助函数时,它会将代码写入自己的工作区(agent_helpers.py)。这些辅助函数在后续任务中可重用,使工具随时间改进。
  4. MCP 服务器 – 可选的 browser-harness-mcp 组件通过 stdio 将浏览器控制命令作为 MCP 工具公开,因此任何兼容 MCP 的客户端(Claude Code、Devin、Cursor 等)都可以无需重新实现 CDP 逻辑来驱动浏览器。
  5. 扩展 – 对于高负载工作,用户可以切换到 Browser Use Cloud,它并行运行大量无头浏览器,并提供代理、隐身模式和验证码解决等额外功能。

你可以用它做什么

  • 自动化个人网页任务 – 例如,在保持登录状态的同时,从 X(Twitter)个人资料下载最新的 20 个视频。
  • 抓取需要认证的数据 – 代理可以浏览需要 cookie 或登录会话的网站,因为它们使用用户实际的 Chrome 配置文件。
  • 生成可重用的自动化辅助函数 – 当代理遇到新模式时,它会编写辅助函数,这些函数成为其工具箱的一部分。
  • 大规模运行 – 通过 Browser Use Cloud 实现并行浏览器,适用于批处理或测试。

适合谁使用

  • 构建 AI 增强自动化的开发者 – 希望 LLM 安全地与实际网页交互。
  • 原型设计网页代理工作流的产品团队 – 快速测试代理如何执行 UI 操作。
  • 研究代理驱动的网页交互的研究人员 – 需要可重现的开源工具。

快速开始(简要)

# 使用 uv(推荐),需要 Python 3.12
uv pip install browser-harness
# 然后将一行设置提示粘贴到你的编码代理中

代理将指导你启用远程调试并注册技能。


许可证

MIT – 免费用于个人、商业或研究用途。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • Dispatch