一、项目介绍

用 AI 编程工具写网页脚本时，最难受的是“页面一变就失效、点不到元素、抓不到数据”：你想让 Agent 像人一样开浏览器、点按钮、填表单，却卡在浏览器自动化的环境搭建上。
Browser-Harness 是一套面向 AI 智能体的浏览器自动化技能与 MCP 服务。它把“开浏览器、录制操作、生成可复用 helper、回放验证”封装成 Agent 能直接调用的能力，配合 Claude Code、Codex 等客户端，让智能体自己操作真实网页。

二、项目基本信息

信息项详情
项目名称Browser-Harness
GitHub地址https://github.com/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-use
开源协议MIT License
开源状态公开
LanguagesPython
支持平台Windows / macOS / Linux
最后更新2026-10-25

三、核心优势

  • 以技能（skill）+ MCP 双形态接入 AI 客户端
  • 自动录制操作并沉淀为可复用的 helper 脚本
  • 支持本地浏览器录像，便于回放与排错
  • 基于 uvx 一键启动，无需复杂环境
  • 面向真实网页交互，而非纯接口调用

四、适用场景

适合用 AI 编程工具做网页自动化、表单填写、页面抓取与端到端验证的开发者与测试团队。

五、安装教程

当前最新版本 latest。按下方命令安装（如遇网络问题可切换镜像源或代理）：

# 用 uvx 启动 Browser-Harness 的 MCP 服务（需 Python 3.12）
uvx --from browser-harness[mcp] browser-harness-mcp
# 或在支持技能的客户端里注册该技能
browser-harness skill

常见报错：依赖缺失时先升级运行环境（Node、Python、Go、JDK 等）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例：

{
  "mcpServers": {
    "browser-harness": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "browser-harness[mcp]", "browser-harness-mcp"]
    }
  }
}
# 注册后，对客户端说：用 browser-harness 打开某页面，登录并导出数据

七、常见问题

问：必须本地有浏览器吗？答：是的，它驱动你本机浏览器完成真实交互。问：只支持 Claude Code 吗？答：任何兼容 MCP 的客户端均可接入。

八、总结

Browser-Harness 用一个清晰的设计，把把智能体工程能力沉淀成库这件反复劳动变成了可复用、可维护的能力。它不追求大而全，而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。