什么是 OpenCode Browse?

OpenCode Browse 用 MCP Server 加 Chromium 扩展,让编码智能体直接操作你已登录的浏览器:使用你的标签页、抓网络流量,并在登录、两步验证和付款时把控制权交还给你。

用 Apifox,节省研发团队的每一分钟

什么是 OpenCode Browse?

免费使用 Apifox

相关推荐

最新文章

API

一体化协作平台

API 设计

API 文档

API 调试

自动化测试

API Mock

API Hub

立即体验 Apifox
目录

OpenCode Browse 是一个 MCP Server 加一个 Chromium 扩展,让编码智能体直接使用你平时在用的浏览器:你的标签页、你的登录状态、你的扩展。智能体在后台标签组里开页、读页面、点击、输入、截图、录标签页、抓网络流量。遇到必须由人完成的步骤——登录、两步验证、付款——它会把标签页交还给你。

Browse 出自 Anomaly,也就是 OpenCode 背后的团队,并且可与任何 MCP 客户端配合,不限于 OpenCode。首个 0.1.0 版本于 2026 年 11 月 16 日发布,目前最新版本为 0.1.5,源码采用 MIT 许可。

下面依次说明:各组件如何协作、如何安装、交接与允许站点如何工作、它与 Playwright MCP 和 Chrome DevTools MCP 有何区别,以及智能体如何借助 Apifox CLI 把抓到的流量变成经过测试的 API。

AI Coding 交流群

如果你也在用 AI 写代码,或者正在研究 Cursor、Claude Code 这些工具,欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流,还有各种新工具和新玩法。

AI Coding 交流群二维码

什么是 OpenCode Browse?

OpenCode Browse 是一个体量很小的原生 MCP Server(browse CLI)加一个浏览器扩展,让 AI 编码智能体有控制地访问你已经在用的浏览器。智能体在自己的分组标签页里工作,用接近真人的方式操作页面,并在登录、两步验证和付款时暂停下来等你处理。

OpenCode Browse 在后台标签页中打开本地结账页面,并由编码智能体修改校验代码的示意图
项目 详情
开发方 Anomaly(OpenCode 团队)
组成 browse CLI 与 MCP Server,外加 Chrome 应用商店扩展
浏览器 Chrome、Edge、Brave、Arc、Helium、Vivaldi、Opera、Chromium
MCP 客户端 OpenCode、Claude Code、Cursor、Codex、Zed,以及另外 30 多个
许可证 MIT
首个版本 v0.1.0,2026 年 11 月 16 日
最新版本 v0.1.5
价格 产品页未标价

大多数给智能体用的浏览器工具会新开一个空白配置,导致智能体看不到你已登录的任何内容。Browse 反过来:智能体在你自己的配置里工作,你已经登录的后台或管理面板就在眼前,无需交出任何 API Key。

Browse 的工作原理:MCP Server、中继与扩展

Browse 由三个部分组成。

OpenCode Browse 如何把编码智能体连到你的浏览器:智能体通过 stdio 调用 browse mcp,它再与 127.0.0.1:19988 上的本地中继通信,中继经 WebSocket 连到浏览器扩展,并通过 chrome.debugger 驱动你的标签页;遇到登录、两步验证和付款时,再走交接流程把控制权还给你
  1. MCP Server。 智能体启动 browse mcp,这是一个很小的 stdio 进程。
  2. 中继。 它按需启动在 127.0.0.1:19988(若被占用则顺延到 19997 以内下一个空闲端口),保存智能体标签页、交接、录制和网络抓包状态,无人使用后自动退出。
  3. 扩展。 它通过 WebSocket 连接中继,并借助 chrome.debugger 在你的浏览器里执行命令。

标签页就是操作句柄。智能体调用 navigate 时不指定标签页,Browse 会新开一个后台标签页并返回它的 id,后续每次调用都带上这个 id。智能体只能操作自己开的或你借给它的标签页,空闲标签页 10 分钟后自动关闭。

OpenCode 拿到的是普通工具(navigate、snapshot、click、fill、screenshot、network、recording 等)。其他 MCP 客户端拿到的是 execute、status 和 tabs,其中 execute 在沙箱中运行 JavaScript,并提供一个 Playwright 风格的 page 对象,可用于调用所有工具。每个工具同时也是一个 CLI 命令:browse navigate https://example.com 会打印出一个标签页 id。

如何安装 OpenCode Browse

产品页建议先从 Chrome 扩展入手,它会引导你完成其余步骤。从终端安装的话,README 给出的是:

# macOS 和 Linux
curl -fsSL https://opencode.ai/browse/install | bash

# Windows PowerShell
irm https://opencode.ai/browse/install.ps1 | iex

# npm 或 bun
npm install -g @opencode/browse && browse install
bun add -g @opencode/browse && browse install

你也可以直接给智能体一句话:「配置 browse 让你能用我的 Chrome:运行 curl -fsSL https://opencode.ai/browse/install | bash。」Browse 随后会为这个智能体完成自配置。

browse install 做三件事:

  1. 安装 browse 可执行文件并加入 PATH。
  2. 把 MCP Server 加进你的智能体,可以交互选择,也可以直接执行 browse install -a claude codex。
  3. 与扩展完成配对;如果浏览器里还没有安装扩展,会打开 Chrome 应用商店页面。

重启正在运行的智能体,让它加载这个 Server,然后试试「打开 news.ycombinator.com 告诉我头条是什么」。对于安装器不认识的客户端,browse install --agent none 会打印出可手动粘贴的 stdio 配置。如果你还不熟悉这个协议,Model Context Protocol 文档 解释了客户端如何加载 Server。

交接、借出标签页与允许站点

这三项特性决定了你能保留多少控制权。

交接(Handoff)。 智能体遇到登录、两步验证提示或付款时,会调用 handoff。页面上出现一张小卡片显示站点源(origin),徽标显示 WAIT。你完成人工部分,然后点击 Continue。只有真实点击才能结束一次交接,页面无法伪造。

借出标签页。 在任意已打开的标签页上点击 Browse 工具栏按钮,徽标显示 ON:智能体可以用它了。再点一次即可收回,运行中也可以。

允许站点与只读标签页。 智能体开标签页时可以传 allowedOrigins,把导航和弹窗限制在你指定的站点,或标记为 readOnly,拒绝点击、输入、上传和导航。README 明确说这些是护栏而非数据边界:页面自身发出的请求不会被过滤,eval 在只读标签页里仍会执行。如果你不希望智能体读某个页面,就不要把它开在 Browse 里。

README 里提到的其他防护还包括:

  • 中继默认只监听 127.0.0.1,并且需要只有你能读到的令牌。
  • 配对码只能使用一次、10 分钟内有效,每个浏览器有独立的密钥。
  • 网络抓包会对鉴权头、API Key、Cookie 值和名称含密钥的字段做脱敏。但按普通名字命名的密钥仍可能漏出,分享前请自行检查。
  • 清除 Cookie、关闭浏览器、修改站点权限等操作会被拒绝。

OpenCode Browse、Playwright MCP 与 Chrome DevTools MCP 对比

三者都能让智能体通过 MCP 驱动 Chromium 浏览器,但默认设定不同。

OpenCode Browse Playwright MCP Chrome DevTools MCP
默认浏览器 你正在运行的浏览器与配置 它自己启动的浏览器,使用独立持久配置 工具需要时才启动的 Chrome
使用你的登录状态 支持,且是设计初衷 支持,需 --extension 与 Playwright 扩展 支持,需连接正在运行的 Chrome
人工交接 内置 handoff 卡片 README 未提供 README 未提供
网络抓包 支持,凭证已脱敏 支持,请求列表与详情 支持,请求分析
性能追踪 未列为工具 非重点 支持,并附洞察
许可证 MIT Apache-2.0 Apache-2.0

来源:Playwright MCP README 与 Chrome DevTools MCP README,查阅于 2026 年 11 月 17 日。

按任务选:

  • Browse:智能体需要用你已登录的会话,而你希望登录和付款仍在自己的把关之下。
  • Playwright MCP:需要在干净或隔离配置里重复执行的端到端流程。
  • Chrome DevTools MCP:排性能问题、看控制台报错或某条请求为什么慢。

它们彼此独立,同一个智能体可以在一个会话里同时用 Browse 操作已登录的后台,用 Playwright MCP 跑测试。

用 Apifox CLI 把抓到的流量变成经过测试的 API

很多 Web 应用会调用没有公开规范的内部 API。智能体可以在你已登录的浏览器里打开这个应用,用 Browse 抓下流量,再交给 Apifox CLI,由它导入并测试。你只需要写一句提示词。

编码智能体执行五步流水线的示意图:Browse 抓取网络流量,把抓包保存为 HAR 文件,apifox import 以 har 格式生成接口,apifox test-case create 添加断言,最后用 cli 和 junit 报告器执行 apifox run

Browse 的变更日志说明它的网络抓包以 HAR 文件形式提供,而 Apifox CLI 支持用 --format har 导入 HAR。先把 CLI 配好:

npm install -g apifox-cli@latest
apifox auth login --with-token <YOUR_TOKEN>
apifox skill install

或者直接告诉智能体:「读一下 https://apifox.com/apifox-cli-installation-guide.md 并配好 Apifox CLI。」那份指南就是写给智能体看的。

然后给智能体一句提示词:

用 browse 在我的浏览器里打开 https://app.example.com/orders,在你加载订单列表
并打开一个订单的过程中抓取网络流量。把抓包保存为 HAR 文件。导入 Apifox 项目
123456,然后为 GET /api/orders 建一个测试用例,断言状态码为 200 且 items
数组非空,在环境 7890 上运行并汇总失败项。

抓包完成后,智能体执行类似下面的命令:

apifox import --project 123456 --format har --file ./orders.har --overwrite-mode merge
apifox endpoint list --project 123456
apifox cli-schema get test-case-create
apifox cli-schema validate test-case-create --file case.json
apifox test-case create --project 123456 --file case.json
apifox run --test-case <caseId> --project 123456 -e 7890 -r cli,json

智能体从 apifox cli-schema get 读取载荷结构并在写入前校验,因此不必猜 JSON 长什么样。--overwrite-mode merge 会保留你已有的接口。

用例跑通之后,同一条 apifox run 加上 -r junit 就能接入 CI:参见 Apifox CLI CI/CD 指南。在 Claude Code 中使用 Apifox CLI 的流程与此相同;如果你更习惯手动导出 HAR,也可以在 Apifox 中导入 HAR 文件。Apifox 免费版的可用人数请以官网为准。

上手前需要知道的限制

  • 它还很年轻。 首个版本 0.1.0 于 2026 年 11 月 16 日发布,目前最新版本为 0.1.5;代码库始于 2026 年 10 月下旬,默认会自动更新(browse update --mode notify 改为只提醒)。
  • 只支持 Chromium。 不支持 Firefox 和 Safari。
  • 调试状态可见。 智能体附着期间,浏览器会一直显示「已开始调试」提示条。
  • 数据发往智能体所用的模型服务商。 Browse 本身运行在本地,但智能体读到的页面内容会发给它的模型服务商。

常见问题

OpenCode Browse 免费吗?

源码采用 MIT 许可,产品页没有标价。CLI 用脚本或包管理器安装,扩展从 Chrome 应用商店安装。

用 Browse 必须装 OpenCode 吗?

不是必须。安装器可以配置 Claude Code、Codex、Cursor、Zed、VS Code、Gemini CLI 等众多客户端,browse install --agent none 会为其余客户端打印手动配置项。

智能体能看见我的密码吗?

fill 工具会隐藏密码和一次性验证码的值,登录也应该走交接流程由你自己输入。截图和页面文本则按原样返回,所以敏感页面不要开在智能体的标签页里。

智能体跑在另一台机器上时还能用 Browse 吗?

可以。在智能体所在机器上执行 browse install --remote,并把扩展配对到那个地址。Browse 不加密这条链路,请用 Tailscale 或 WireGuard。

Browse 与 Playwright MCP 有什么区别?

Browse 默认驱动你现有的浏览器和配置,并内置交接流程;Playwright MCP 默认启动自己的浏览器,也可以通过扩展模式连到你现有的浏览器上。