browser-harness 是什么?

Browser Harness 是 browser-use 团队发布的 Python 浏览器控制工具。它通过 Chrome DevTools Protocol 连接真实 Chrome,把少量固定核心与可由代理修改的 helper 工作区分开;v0.1.13 还提供可选的 MCP stdio 服务。

⭐ 18,383 Stars 🍴 1,800 Forks Python MIT 作者: browser-use
来源:github.com/browser-use/browser-harness;https://github.com/browser-use… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

通过本机 CDP 端点控制现有 Chrome 会话,适合需要现有登录状态的任务。受保护的核心包负责连接与调度,代理把可复用辅助函数放进本地工作区。命令行进程把 Python 片段交给常驻 daemon,daemon 连接 Chrome 的 CDP 端点。src/browser_harness 保存核心逻辑,本地配置目录保存认证、运行时 socket、日志、截图和代理工作区;MCP 入口继续调用同一套 helper,不另建 CDP 实现。

来源:github.com/browser-use/browser-harness/blob/main/README.md;https://gi…

核心功能

连接真实 Chrome

通过本机 CDP 端点控制现有 Chrome 会话,适合需要现有登录状态的任务。

来源:github.com/browser-use/browser-harness/blob/main/README.md;https://gi…
可编辑 helper 工作区

受保护的核心包负责连接与调度,代理把可复用辅助函数放进本地工作区。

来源:github.com/browser-use/browser-harness/blob/main/README.md
MCP 接口

browser-harness-mcp 通过 stdio 暴露带 browser_ 前缀的导航、点击、截图、标签页与 CDP 工具,复用同一 helper 层。

来源:github.com/browser-use/browser-harness/blob/main/docs/MCP.md
本地录制由用户选择

安装文档要求默认关闭录制;启用前要说明截图和轨迹可能包含敏感页面内容。

来源:github.com/browser-use/browser-harness/blob/main/install.md

技术架构

命令行进程把 Python 片段交给常驻 daemon,daemon 连接 Chrome 的 CDP 端点。src/browser_harness 保存核心逻辑,本地配置目录保存认证、运行时 socket、日志、截图和代理工作区;MCP 入口继续调用同一套 helper,不另建 CDP 实现。

来源:github.com/browser-use/browser-harness/blob/main/README.md;https://gi…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) cdp-use 1.4.5 fetch-use 0.4.0 Pillow 12.3.0 websockets 15.0.1websockets 15.… mcp 2.1.1(可选)mcp 2.1.1(可选… 连接真实 Chrome 可编辑 helper 工作区 MCP 接口 本地录制由用户选择 browser-harness 项目本体 核心功能 关键依赖

技术栈

语言Python 3.11+;官方快速安装固定 Python 3.12框架CDP daemon、命令行工具、可选 MCP stdio server
cdp-use 1.4.5fetch-use 0.4.0Pillow 12.3.0websockets 15.0.1mcp 2.1.1(可选)
本地 Chrome 远程调试;可选 Browser Use Cloud,本地模式不需要其 API key
来源:github.com/browser-use/browser-harness/blob/main/pyproject.toml;https…

快速上手

先安装 uv 与 Python 3.12,再执行 `uv tool install --python 3.12 --upgrade --force browser-harness`。用 `browser-harness skill` 把官方技能写入代理的 skills 目录,然后仅在测试 Chrome 配置中打开远程调试,运行 `page_info()` 验证连接。录制保持关闭,除非使用者明确接受本地保存截图和操作轨迹。
来源:github.com/browser-use/browser-harness/blob/main/install.md

使用场景

适合让编码代理操作已经登录的本机网页、调试一次性浏览器流程,或通过 MCP 给现有客户端增加 Chrome 控制。涉及生产后台、支付、删除、发帖或个人账号时,应改用低权限测试账号并保留人工确认。

来源:github.com/browser-use/browser-harness/blob/main/README.md;https://gi…

优势与局限

优势

  • 直接复用真实 Chrome 登录状态
  • 核心与代理可编辑工作区分开
  • CLI 与 MCP 共用 helper 层
  • 本地浏览器不强制使用云端 API key

局限

  • 远程调试让代理接触浏览器内的登录态和页面数据
  • 录制可能保存敏感截图与轨迹
  • 只面向 Chrome/CDP 路线,不提供 Playwright 的多浏览器测试矩阵
  • 站点条款、验证码和账号风控不会由工具自动解决
  • 本轮没有安装工具或连接浏览器
来源:github.com/browser-use/browser-harness/blob/main/install.md;https://g…

最新版本

最新正式版为 v0.1.13,发布于 2026-09-04。该版固定 MCP extra 为 mcp 2.1.1,固定构建工具版本,并保留 v0.1.12 的 Chrome 权限与 macOS 辅助功能可靠性修正。官方 Release 报告 251 项单元测试通过。

来源:github.com/browser-use/browser-harness/releases/tag/v0.1.13

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、install.md、pyproject.toml、MCP 文档与 v0.1.13 Release  |  limitations: 未安装包、未打开远程调试、未连接 Chrome、未调用 MCP,也未验证录制、云浏览器或任何真实站点  |  observed_output: pyproject 标注 browser-harness 0.1.13、Python >=3.11;安装文档推荐 uv + Python 3.12,并明确本地 Chrome 无需 Browser Use API key;Release 记录 251 项单元测试通过

来源:github.com/browser-use/browser-harness/blob/main/pyproject.toml;https…

同类项目对比

Playwright 官方定位是跨 Chromium、Firefox、WebKit 的通用自动化与测试框架,提供浏览器上下文隔离、自动等待、断言、追踪和并行测试。Browser Harness 更专注让代理接入真实 Chrome 与现有登录态,并允许在工作区积累 helper。要做可重复的跨浏览器回归测试,Playwright 的边界更清楚;要让代理临时操作个人 Chrome,可评估 Browser Harness。

来源:playwright.dev/;https://playwright.dev/docs/browser-contexts;https://…

总结评价

Browser Harness 适合需要真实 Chrome 登录态的代理实验,但权限范围很大。先用单独浏览器配置和无敏感数据的测试站点验证 page_info、导航与停止行为;确认录制设置、日志目录和人工批准点后,再决定是否接入日常账号。

来源:github.com/browser-use/browser-harness/blob/main/install.md;https://g…

常见问题

Browser Harness v0.1.13 需要哪个 Python 版本?

包元数据要求 Python 3.11 及以上;官方快速安装命令指定 Python 3.12,避免 uv 选到兼容旧 Python 的旧版本。

本地使用 Browser Harness 必须购买 Browser Use Cloud 吗?

不需要。官方安装文档明确写明 Cloud 是可选项,本地 Chrome 不需要 Browser Use API key。

为什么第一次连接 Chrome 需要人工操作?

Chrome 要求用户在 chrome://inspect/#remote-debugging 允许远程调试;macOS 还可能弹出每次连接的授权窗口。这是浏览器权限边界,教程不建议绕过。

Browser Harness 录制会保存什么?

本地录制会保存截图和操作轨迹,可能含有敏感页面内容。官方安装流程要求默认关闭,只有用户明确同意后才启用。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件