ByteNoteByteNote

字节笔记本

2026年5月3日

agent-browser - Vercel 原生 Rust 浏览器自动化 CLI 工具

API中转
¥120

Vercel 推出的 agent-browser 是一个专为 AI Agent 设计的浏览器自动化 CLI 工具,完全用 Rust 编写,底层全部是原生 Rust 实现,支持 macOS、Linux、Windows 三大平台。相比传统的浏览器自动化方案,agent-browser 在 Token 消耗上有着显著优势,特别适合在 Claude Code、Cursor、Gemini CLI 等 AI 编程工具中使用。

核心特性

  • AI Agent 原生设计:专为大语言模型 Agent 设计的浏览器交互方案,输出结构化快照而非完整 DOM
  • 原生 Rust 实现:纯 Rust 编写,性能优越,无 Node.js 依赖
  • 跨平台支持:macOS、Linux、Windows 全平台兼容
  • 低 Token 消耗:快照输出仅 200-400 token,相比 Playwright MCP 的 15,000+ token 大幅缩减
  • 多 AI 工具兼容:适配 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot 等主流 AI 编程工具
  • Skill 集成:通过 npx skills add agent-browser 即可接入,保持自动更新

技术栈

  • Rust - 核心语言,全原生实现
  • Chrome for Testing - 内置专用浏览器引擎
  • DevTools Protocol - 通过 CDP 与浏览器通信

安装指南

前置要求

  • Node.js >= 16(使用 npm/npx 安装方式时)
  • Rust 工具链(使用 Cargo 从源码编译时)

安装步骤

提供四种安装方式,可根据实际环境选择:

方式一:npm 安装(推荐)

bash
npm install -g agent-browser
agent-browser install

首次运行 agent-browser install 会自动下载 Chrome for Testing 作为浏览器引擎。

方式二:npx 一键运行

bash
npx agent-browser install
npx agent-browser open example.com

无需全局安装,适合临时使用场景。

方式三:Homebrew(macOS)

bash
brew install agent-browser
agent-browser install

方式四:Cargo 编译安装

bash
cargo install agent-browser
agent-browser install

验证安装

bash
# 全面诊断
agent-browser doctor

# 快速检查(不走网络)
agent-browser doctor --quick

# 自动修复(含重装 Chrome 等破坏性操作)
agent-browser doctor --fix

使用指南

核心工作流

agent-browser 的工作流非常简洁:打开页面 → 获取快照 → 通过 ref 交互:

bash
# 打开页面
agent-browser open example.com

# 获取可交互快照(输出元素引用)
agent-browser snapshot -i
# - heading "Example Domain" [ref=e1]
# - link "More information..." [ref=e2]

# 通过 ref 点击元素
agent-browser click @e2

# 截图保存
agent-browser screenshot page.png

# 关闭浏览器
agent-browser close

与 Claude Code 集成

bash
npx skills add agent-browser

Skill 文件通过 npx skills add 拉取,保持自动更新,不要从 node_modules 复制 SKILL.md

为什么比 Playwright MCP 更省 Token

方案单次操作 Token 消耗
Playwright MCP(截图)15,000+ token
完整 DOM 输出3,000-5,000 token
agent-browser snapshot200-400 token

agent-browser 通过结构化快照而非完整 DOM 或截图来与 AI 交互,大幅减少了 Token 消耗,使其特别适合在 AI Agent 循环中高频使用。

兼容平台

  • Claude Code
  • Codex
  • Cursor
  • Gemini CLI
  • GitHub Copilot
  • Goose
  • OpenCode
  • Windsurf

项目链接

分享: