@ agent-browser-io/ 浏览器

Token 高效代理浏览器 .

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

使用方法:

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

安装

npm install @agent-browser-io/browser

如何添加 MCP

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

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

npx @agent-browser-io/browser mcp

添加到光标

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

{
  "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 财务报告和审定财务报表 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,点击等).

示例

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+。浏览器自动化使用 剧作家 (作为非依赖性列入).

npm install
npm run build

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