browser-use/browser-harness

本页由 AI 翻译，技术细节请以原文为准。查看原文

1.9万 stars 质量 77 趋势 93MIT

浏览器框架 |自愈框架，使大型语言模型能够完成任何任务。

概览

用一个薄的、可编辑的CDP线束，直接将LLM连接到你的真实浏览器。对于你需要的浏览器任务。一个websocket连接到Chrome，中间不连接。代理在执行时写入缺失的内容。线束每次运行都会自我提升。试试浏览器利用浏览器云功能，或者把设置提示粘贴到你的编码代理中。客服会打开 chrome://inspect/#remote-debugging。勾选复选框，让客服能够连接到你的浏览器：当每个附着弹窗出现时点击允许（Chrome 144+）：参见agent-workspace/domain-skills/示例任务。隐形、副特工，或者无头部署。 - 在 cloud.browser-use.com/new-api-key 获取密钥——或者让代理通过 docs.browser-use.com/llms.txt 自己注册（包含设置流程+挑战上下文）。

概述（AI 翻译）

浏览器 Harness 允许 Claude Code、Codex 或 Cursor 使用你的真实 Chrome 浏览器：打开页面，点击，输入，阅读和下载，登录时保持登录状态。将一个提示粘贴到你的编码代理中进行设置。它通过 DevTools 协议（CDP）与 Chrome 通信，代理会在运行时写入缺失的辅助程序，因此 harness 会随着每个任务变得更好。开源，MIT 授权。

试试浏览器利用浏览器云功能，或者把设置提示粘贴到你的编码代理中。

你永远不会再使用浏览器。

看它成功

任务： “打开我的X主页，找到我最新的20个视频帖子，并下载它们。”

设置提示

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

代理将打开chrome://inspect/#remote-debugging。首次设置时，触发代理连接浏览器的复选框：

它是如何运作的

[install.md 将代理连接到你的浏览器。
SKILL.md 教授浏览器工作流程。
src/browser_harness/ 在代理在其本地工作区写入可重用辅助工具时保持保护。

与其他浏览器工具相比

	适用于	它驱动的浏览器	你在自己的 Chrome 中批准的内容

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Browser Harness ♞

Browser Harness lets Claude Code, Codex or Cursor use your real Chrome browser: open pages, click, type, read and download, logged in as you. Paste one prompt into your coding agent to set it up. It talks to Chrome over the DevTools Protocol (CDP), and the agent writes any missing helper as it works, so the harness gets better with each task. Open source, MIT licensed.

Try browser-harness in Browser Use Cloud or paste the setup prompt into your coding agent.

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

You will never use the browser again.

See it work

Task: “Open my X profile, find my latest 20 video posts, and download them.”

Setup prompt

Paste into Claude Code or Codex (Cursor: use the MCP config below):

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.

The agent will open chrome://inspect/#remote-debugging. On first setup, tick the checkbox so the agent can connect to your browser:

How it works

install.md connects the agent to your browser.
SKILL.md teaches it the browser workflow.
src/browser_harness/ stays protected while the agent writes reusable helpers in its local workspace.

Compared with other browser tools

	Works with	Browser it drives	What you approve in your own Chrome
Browser Harness	Claude Code, Codex, Cursor, any MCP client via `browser-harness-mcp`	Your running Chrome, logged in as you	Whole browser: on Chrome 144+, tick remote debugging in `chrome://inspect`, then click Allow
Playwright MCP	Any MCP client (Claude Code, Codex, Cursor, Copilot and more)	Its own browser profile by default. Your Chrome with `--extension` (Playwright Extension) or `--cdp-endpoint`	Chosen tabs (one tab group per client) via the extension, approval skippable with a token; or whole browser via `--cdp-endpoint`

在 GitHub 查看完整 README

安装

npx skillfish add browser-use/browser-harness

新手？先看 mcpskill.org 教程 →