# @agent-browser-io/browser 中文文档

规范地址：https://npmcn.com/package/%40agent-browser-io/browser/

版本：0\.3\.0
npm 元数据更新时间：2026-02-08T15:34:33.597Z
中文译文更新时间：2026-11-05T19:08:16.437Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agent-browser-io/browser
原文对照：https://npmcn.com/package/%40agent-browser-io/browser/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：240 kB，78 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：3 个
- 首次发布：2026-02-07T18:09:09.348Z
- 最新版本发布：2026-02-08T15:34:33.478Z
- 近 30 天下载量：43076（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

调试高效代理浏览器

## 安装

```sh
npm install @agent-browser-io/browser
```

也可以使用：`pnpm add @agent-browser-io/browser`、`yarn add @agent-browser-io/browser`、`bun add @agent-browser-io/browser`

## README

# @ agent-browser-io/ 浏览器

**Token 高效代理浏览器 .**

这个软件包让AI代理以有符号效率的方式控制一个真实的浏览器(导航,点击,键入,通过ASCII线框交互). 用从 [MCP 磁共振](https://modelcontextprotocol.io/) 客户端(例如光标、 Claude D桌面) 或来自代码 [维塞尔 AI SDK](https://sdk.vercel.ai/)。 。 。 .

**使用方法:**

-   **MCP 磁共振** —— 将包含的 MCP 服务器添加到 Cursor 或其他 MCP 客户端中,以便AI 能够驱动浏览器(参见 [如何添加 MCP](https://npmcn.com/package/%40agent-browser-io/browser/#readme-how-to-add-mcp)) (中文(简体) ).
-   **维塞尔 AI SDK** - 使用 `createBrowserTools(browser)` 与 `generateText({ tools, ... })` 在您的应用程序中( 参见 [维塞尔 AI SDK](https://npmcn.com/package/%40agent-browser-io/browser/#readme-vercel-ai-sdk)) (中文(简体) ).
-   **国 际** ——运行交互式CLI进行人工测试(`npx @agent-browser-io/browser` 或者说 `agent-browser-cli` 在安装后).

## 安装

```bash
npm install @agent-browser-io/browser
```

## 如何添加 MCP

[MCP 磁共振](https://modelcontextprotocol.io/) (Model Control Protocol)让 Cursor 或 Claude桌面中的AI助手在stdio上使用浏览器工具. 您的AI 可以启动浏览器, 打开 URL, 获得线框, 点击, 键入, 滚动, 截图等 .

**运行 MCP 服务器( 用于测试) :**

```bash
npx @agent-browser-io/browser mcp
```

**添加到光标**

1.  打开光标设置 **MCP 磁共振** (或编辑您的 MCP 配置文件,例如 . `~/.cursor/mcp.json` 或项目 `.cursor/mcp.json`) (中文(简体) ).
2.  添加服务器条目 :

```json
{
  "mcpServers": {
    "agent-browser": {
      "command": "npx",
      "args": ["-y", "@agent-browser-io/browser", "mcp"]
    }
  }
}
```

3.  重新启动光标或重新装入MCP,这样它就能取出新的服务器. 这个 **代理浏览器** 工具将出现供AI使用.

**其他MCP客户端(如克洛德桌面)**

在客户端的配置中使用相同的 stdio 命令 :

-   **命令 :** `npx` (或通向 `node`(中文(简体) )
-   **参数 :** `["-y", "@agent-browser-io/browser", "mcp"]` (或 `["path/to/bin/index.cjs", "mcp"]`(中文(简体) )

服务器在stdin/sdout上说出JSON-RPC;不需要额外的env var.

## 维塞尔 AI SDK

您可以使用相同的浏览器自动化 **工具** 与 [维塞尔 AI SDK](https://sdk.vercel.ai/) 财务报告和审定财务报表 `generateText`。软件包暴露 `createBrowserTools(browser)`,返回工具对象 `generateText({ tools, ... })`编辑 `ai` 软件包作为依赖性包含.

**工具 :** `launch`, (中文(简体) ), `navigate`, (中文(简体) ), `getWireframe`, (中文(简体) ), `click`, (中文(简体) ), `type`, (中文(简体) ), `fill`, (中文(简体) ), `dblclick`, (中文(简体) ), `hover`, (中文(简体) ), `press`, (中文(简体) ), `select`, (中文(简体) ), `check`, (中文(简体) ), `uncheck`, (中文(简体) ), `scroll`, (中文(简体) ), `screenshot`, (中文(简体) ), `close`。与 MCP 服务器相同的工具集,所以行为一致.

**重要内容:** 让模特儿打电话来 `launch` 工具先于其他动作(navigate, getWireframe,点击等).

**示例**

```ts
import { createBrowserTools, AgentBrowser, DefaultBrowserBackend } from '@agent-browser-io/browser';
import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';

const browser = new AgentBrowser(new DefaultBrowserBackend());
const tools = createBrowserTools(browser);

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  prompt: 'Go to hackernews visit on top 3 news, and summarize their content.',
});
// Model will call launch, then navigate, then getWireframe, etc.
```

## 发展

要求数 **节点18+**。浏览器自动化使用 **剧作家** (作为非依赖性列入).

```bash
npm install
npm run build
```

构建到 `dist/cjs` (共同JS)和 `dist/esm` (ESM) (英语).

## 常见问题

### @agent-browser-io/browser 是什么？

调试高效代理浏览器

### 如何安装 @agent-browser-io/browser？

在项目目录运行 npm install @agent-browser-io/browser，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-browser-cli，可以用 npx agent-browser-cli 直接运行。

### @agent-browser-io/browser 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agent-browser-io/browser 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @agent-browser-io/browser 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @agent-browser-io/browser 可以商用吗？

@agent-browser-io/browser 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @agent-browser-io/browser 的下载量有多少？

根据 npm 官方下载统计，@agent-browser-io/browser 在 2026/10/05 – 2026/11/03 这 30 天内被下载 43,076 次，日均约 1,436 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agent-browser-io/browser 还在维护吗？

最新版本 0\.3\.0 发布于 2026/02/08（8 个月前）；至今共发布 4 个版本，其中过去 12 个月发布了 4 个；首次发布于 2026/02/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。