关于 Browsentic
Browsentic Bridge 可从浏览器侧边栏运行 Agent CLI,并在用户已登录的标签页中执行任务。它面向希望通过现有 Agent CLI 操作浏览器的人,也可选配 MCP 连接以便从终端控制。
主要功能
- 01用于 Agent 任务的浏览器侧边栏
- 02使用已登录的浏览器标签页
- 03本地回环 Bridge
- 04支持多种 Agent CLI
- 05配对和撤销浏览器连接
- 06通过标准输入输出提供 MCP
适用场景
- 01让 Agent 操作已登录的打开标签页
- 02通过终端 MCP 客户端运行浏览器任务
- 03让多个 MCP 客户端共享已配对浏览器
- 04配对或撤销浏览器访问权限
MCP 相关
Browsentic 可通过标准输入输出提供 MCP,使 MCP 客户端控制同一已配对浏览器。一个 Bridge 可让多个客户端共享该浏览器连接。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
51收录的工具列表 · 更新于 1 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| geometry | boolean | 否 | 添加每个元素的文档像素坐标 "bounds"。默认关闭:其他工具通过选择器或可见文本定位目标,因此仅在需要坐标时请求——例如用于 page.trustedClick 或 page.dragElement 的点坐标。 |
| maxPerKind | integer | 否 | 每种类型列出的链接、按钮、字段和表单数量上限 |
详细介绍
browsentic
这是 Browsentic Bridge,也是 Browsentic 在你的电脑上运行的部分。
Browsentic 是浏览器的超能力:一个 Agent 浏览器工具,可在真实且已登录的浏览器侧边栏中运行你已经在使用的 Agent CLI。侧边栏会在当前标签页旁打开;Bridge 在本机回环地址上运行,并在你交给它任务时启动 Agent CLI。它免费且开源,没有托管中继、没有 API 密钥、没有账户,也不使用无头浏览器:Agent 会在你已经登录的标签页中工作。
安装
只需一条命令即可完成所有设置,包括安装扩展程序:
npx browsentic@latest setup
它会启动 Browsentic Bridge,询问你使用哪种浏览器,在该浏览器中打开扩展程序商店页面,并等待浏览器连接。点击 Add to Chrome(Firefox 中为 Add;Edge 会先要求你允许安装其他商店的扩展程序),扩展程序便会自动连接;如果系统要求输入代码,请输入安装程序显示的代码。在 macOS 和 Windows 上,也可以通过窗口中的应用完成相同操作:请参阅 browsentic.com/install。
Chrome、Brave、Arc、Vivaldi 和 Opera 可从 Chrome Web Store 获取扩展程序;Edge 可从 Edge Add-ons 获取;Firefox 则可安装 由 Mozilla 签名的附加组件。 侧边栏运行在你已登录的 Agent CLI 上:Claude Code、Codex 或其他受支持的 CLI。
然后打开侧边栏,输入或说出指令。
之后更新:
npx browsentic@latest update
扩展程序会从商店自动更新,且扩展程序和 Bridge 无需使用相同版本。
要求
- Node.js 20 或更高版本
- Chrome、Edge、Brave、Arc、Vivaldi、Opera 或其他 Chromium 浏览器,或 Firefox 140 或更高版本
PATH中有一个已登录的 Agent CLI:claude、codex、agy、vibe、grok、cursor-agent、qwen、opencode或dsh
命令
browsentic setup | 启动 Bridge,将扩展程序添加到浏览器并完成配对 |
browsentic update | 更新 Bridge 并重新启动 |
browsentic browsers | 查看这台电脑上的浏览器,以及各浏览器获取扩展程序的方式 |
browsentic pair | 生成新的单次使用代码 |
browsentic status | 查看 Bridge、每个已配对的浏览器以及 Agent 的状态 |
browsentic sessions | 列出已配对的浏览器 |
browsentic revoke | 取消与一个或所有浏览器的配对 |
browsentic agent | 选择在侧边栏中运行的 Agent |
browsentic logs | 持续查看 Bridge 日志 |
browsentic mcp | 通过 stdio 提供 MCP 服务 |
browsentic help 会列出其余命令。无法访问商店的浏览器可以从此软件包附带的文件夹加载扩展程序:browsentic setup --unpacked。
在 MCP 客户端中使用
此项为可选配置,侧边栏无需它。将 Browsentic 注册到 MCP 客户端后,该客户端便可通过终端操控同一个浏览器。
npm i -g browsentic
claude mcp add browsentic -- browsentic mcp
任何 MCP 客户端都适用:Claude Code、Codex、Cursor、Zed、Claude Desktop。浏览器连接由一个 Bridge 管理,因此多个客户端可以同时共用同一个已配对的浏览器。
此处建议使用全局安装,而不是 npx。每次客户端启动时,npx 命令都会重新解析依赖,可能会悄悄启动与已配置的不同 Bridge。
文档
完整文档请访问 browsentic.com/docs,其中包括 安全模型、工具参考和架构说明。
源代码:github.com/imshaikot/browsentic · Apache 2.0
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。