browser-harness

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

浏览器工具 ♞

浏览器工具让 Claude Code、Codex 或 Cursor 使用你真实的 Chrome 浏览器：打开页面、点击、输入、读取和下载，以你的身份登录。将一个提示粘贴到你的编程代理中即可设置。它通过 DevTools 协议（CDP）与 Chrome 通信，代理在工作时会编写任何缺失的辅助功能，因此工具在每次任务中都会变得更好。开源，MIT 许可证。

在 浏览器使用云 中尝试 browser-harness，或将设置提示粘贴到你的编程代理中。

  ● agent: wants to upload a file
  │
  ● agent-workspace/agent_helpers.py → helper missing
  │
  ● agent writes it                         agent_helpers.py
  │                                                       + custom helper
  ✓ file uploaded

你再也不会使用浏览器了。

看看它的工作情况

任务: “打开我的X个人资料，找到我最近的20个视频帖子，并下载它们。”

设置提示

粘贴到 Claude Code 或 Codex（光标：使用下面的 MCP 配置）：

Install or upgrade browser-harness to the latest stable version with uv using Python 3.12, register the skill from `browser-harness skill`, and connect it to my browser. Ask whether I want local browser recordings enabled; default to no and preserve my existing preference on upgrades. Follow https://github.com/browser-use/browser-harness/blob/main/install.md if setup or connection fails.

代理将打开 chrome://inspect/#remote-debugging。在首次设置时，勾选复选框以便代理可以连接到您的浏览器：

它是如何工作的

• install.md 将代理连接到你的浏览器。
• SKILL.md 教它浏览器的工作流程。
• src/browser_harness/ 在代理在本地工作区编写可重用的辅助工具时保持受保护状态。

与其他浏览器工具比较

在 200 个公共 BU Bench V2.1 任务中的 100 个任务（bu2-001 到 bu2-100；101-200 未运行）上按浏览器使用进行匹配评估。测量日期：2026-10-14。

• 所有工具使用同一个代理：Codex CLI 0.144.6，GPT-6 Luna，中等推理，关闭网页搜索。同一个冻结法官。
• Browser Harness 提供给代理的是它的 CLI 和 SKILL.md，而不是 browser-harness-mcp。Playwright MCP 和 Chrome DevTools MCP 以默认设置作为 MCP 服务器运行。agent-browser 作为它的 CLI 和技能运行。
• 每个工具都驱动了同一个新的浏览器使用云浏览器，覆盖在CDP上。这并不衡量每个工具的默认或本地Chrome模式。
• 每个任务运行一次。代理失败从未重试。运行器、浏览器和评判失败会重跑一次（Browser Harness 3 个任务，Playwright MCP 4 个任务，Chrome DevTools MCP 6 个任务，agent-browser 0 个任务）。

没有工具在得分上获胜：每对对比浏览器工具的差异，其95%的置信区间（不含浏览器工具：agent-browser -4.0，置信区间-10.0至1.8;Playwright MCP -0.4，-6.6至5.7;Chrome DevTools MCP 0.6，-5.6至6.6）。

Browser Harness的中位输入令牌最低（210万对33-6.7M），中位模型成本最低（0.042美元对比0.056-0.097美元）。模型成本不包括浏览器、代理和评判。它比Playwright MCP和Chrome DevTools MCP慢（中位数9.0对8.3和8.7分钟），比代理浏览器快（11.2分钟）。这些为中位数，无置信区间。

第一次代理-浏览器运行被丢弃：我们这边的设置错误让它启动了自己的本地浏览器，而不是共享的云浏览器。该行显示的是修正后的重运行。

仅使用 Codex 测量。Claude Code、Cursor、Playwright CLI 和 Chrome 中的 Claude 未进行测量。方法和每个任务的评分：coding-agent-browser-tools.json。

什么时候该用别的东西

• Playwright（测试、MCP或CLI）：在干净的浏览器中对自己应用进行独立、可重复的CI测试，无需个人登录。
• Chrome DevTools MCP：性能跟踪和 DevTools 调试（网络、控制台、源码映射栈跟踪）。
• Claude in Chrome：你只用 Claude，并且有 Pro、Max、Team 或 Enterprise 套餐。
• Cursor 内置浏览器：代理不需要你登录的 Chrome。它运行在每个工作空间的独立配置文件中。

OpenAI 的 Codex 在其设置中将其浏览器功能标注为“浏览器使用”。它与该仓库背后的公司 Browser Usage 是分开的。

随浏览器使用云扩展

请使用您本地的浏览器进行已登录的个人工作。当您想要同时使用多个浏览器，并具备实时预览、代理、隐身、验证码处理等功能时，请使用 Browser Use Cloud 扩展功能。

MCP 服务器

browser-harness-mcp 通过 stdio 将浏览器控制助手作为 MCP 工具暴露出去，因此任何 MCP 客户端（如 Claude Code、Devin、Cursor 等）都可以驱动浏览器，而无需编写第二个 CDP 层。有关设置和客户端配置，请参阅 docs/MCP.md。

光标

将此添加到您项目中的 .cursor/mcp.json 文件，或添加到 ~/.cursor/mcp.json 以用于所有项目。它需要 uv。

{
  "mcpServers": {
    "browser-harness": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "browser-harness[mcp]", "browser-harness-mcp"]
    }
  }
}

贡献

欢迎提交错误修复、文档改进以及代理生成的领域技能。请参阅 CONTRIBUTING.md。

代理程序的痛苦教训 · 真正学习的网络代理