1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | agent-browser |
| 作者/维护者 | Vercel Labs（Vercel 官方团队） |
| 来源链接 | https://github.com/vercel-labs/agent-browser |
| 许可证 | Apache-2.0 |
| GitHub Stars | 38,421（GitHub API 取数，2026-07-14） |
| Forks | 2,487（GitHub API 取数） |
| 最新版本 | v0.31.2（2026-07-13 发布，累计 93 个版本） |
| 安装方式 | npm / Homebrew / Cargo / 源码编译；另提供 Claude Code 官方插件市场包 |
2. 功能介绍与亮点
agent-browser 是一个用 Rust 原生实现的浏览器自动化 CLI，不依赖 Playwright/Puppeteer，直接通过 Chrome DevTools Protocol 驱动浏览器，核心能力包括：
- 无障碍树（accessibility tree）快照与元素引用（如
@e1），配合 CSS 选择器、文本匹配、语义定位器操作页面 - 截图与 PDF 生成（支持标注）、网络请求拦截与 HAR 录制
- React 组件树检查、Web Vitals 性能指标读取
- 多标签页/多窗口管理、会话状态持久化、鉴权信息保存
- WebSocket 实时预览、MCP Server 集成模式
- 可选云浏览器插件：Browserbase、Browserless、Browser Use、Kernel、AWS Bedrock AgentCore
- 覆盖 Electron 桌面应用、Slack 自动化、QA 探索性测试等扩展场景包
亮点：官方一线机构（Vercel）出品且高频维护（近一天内仍有新版本发布）、原生二进制覆盖 macOS/Linux/Windows 三平台、核心功能完全本地执行无需任何 API Key。
3. 适用场景
所属分类：工程效率与代码质量
适合需要让 Claude Code / Codex 等 Agent 自主编写并执行浏览器自动化脚本的场景：Web 应用端到端测试、探索性 QA、表单自动化、截图级视觉回归、结构化数据抓取。尤其适合不想手写 Playwright 脚本、希望 Agent “看图操作”网页的初中级用户。
4. 跨 Agent 兼容性
- Claude Code：原生支持。仓库自带
.claude-plugin/marketplace.json与skills/agent-browser/SKILL.md，专门打包为 Claude Code 插件与技能。 - Codex：未验证。工具以标准 CLI 形式提供，理论上任何可执行 Shell 命令的 Agent 均可调用，但未见官方针对 Codex 的适配材料。
- OpenClaw：未验证，材料未提及。
- Hermes Agent：未验证，材料未提及。
5. 推荐理由
浏览器自动化是 Agent 落地实际业务（测试、抓取、验证）最高频的需求之一，市面上同类方案大多依赖 Playwright/Puppeteer 封装，agent-browser 是少数用原生 Rust 重写协议层、专为 Agent 设计交互模型（无障碍树 + 元素引用）的方案，性能与响应速度更优；同时由 Vercel 官方维护、迭代极快（93 个版本）、无强制付费依赖，安装门槛低，适合作为 Claude Code 用户的通用浏览器操作技能长期使用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | Vercel Labs 官方一线机构出品，GitHub 38.4k stars，社媒可见独立开发者称赞并替换了原有 Playwright MCP 方案 |
| 可用性 | 9 | npm/brew/cargo 一条命令安装，agent-browser install 自动配置浏览器；SKILL.md/README 文档完整；近一天内仍有新版本发布；核心功能无付费依赖 |
| 安全性 | 8 | 见下表 |
| 综合评分 | 8.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ①Shell 命令执行范围 | 有：eval 可在页面上下文执行 JS，插件系统可通过 stdio 执行外部命令；但作用域限定于浏览器自动化，并提供 --confirm-actions 与动作策略文件限制破坏性操作 |
| ②运行时联网外发 | 浏览器自动化工具必然请求被导航域名；核心功能默认本地执行、文档未提及遥测；仅用户主动配置云浏览器供应商或 AI Gateway 时才会外发数据，且均需显式 API Key |
| ③API Key/凭据存储 | 核心功能免密钥；可选云服务需自备 Key；会话凭据可选 AES-256-GCM 本地加密，未加密时状态文件含明文 token（文档提示需 .gitignore） |
| ④可疑指令/注入迹象 | 抓取的 SKILL.md 与 marketplace.json 均为常规功能说明，未发现越权指令 |
| ⑤作者/组织信誉 | Vercel Labs 官方团队；2026-04 Vercel 内部系统曾因第三方供应链攻击（Context AI 员工设备中招）外泄部分非敏感环境变量，官方联合微软/GitHub/npm/Socket 核实后确认开源项目与 npm 包未受影响，与本 skill 无直接关联，仅作背景披露 |
| ⑥License | Apache-2.0，明确 |
| ⑦最近维护 | 最新版本发布于运行前一天（2026-07-13），维护极活跃 |
7. 跟同类 Skills 相比的优势
本次候选池中同类（浏览器自动化/测试类）落选者对比：
| 名称 | Stars | 维护状态 | 定位差异 |
|---|---|---|---|
| agent-browser（本次推荐） | 38.4k | 极活跃（昨日发版） | 原生 Rust 重写协议层，官方多云供应商插件生态 |
| SawyerHood/dev-browser | 6.4k | 活跃 | 沙盒化 QuickJS 运行时，偏轻量单机开发调试 |
| browserbase/skills | 3.6k | 活跃 | Browserbase 官方技能集，强绑定其云浏览器服务 |
| lackeyjb/playwright-skill | 2.9k | 一般（约 7 个月未更新） | 基于 Playwright 封装，模型即时生成脚本 |
agent-browser 在体量、维护频率、官方背书与功能完整度上均领先，且不强制绑定单一云服务商。
8. 用户评价
本次检索到社媒对该项目的正面评价线索，但专门抓取（含 GitHub Discussions 查询）均未能取得可独立验证的完整内容，故如实说明：本次未收集到足够已验证来源的用户评价。作为替代佐证，仓库 Issue #390 显示已有真实用户在 Windows 环境下反馈并跟进调试（22 条评论），说明项目有活跃的真实使用与响应。
9. 其他补充
项目提供 93 个历史版本的完整变更记录，扩展技能包覆盖 Electron 桌面应用自动化、Slack 自动化、Vercel Sandbox microVM 与 AWS Bedrock AgentCore 云端浏览器等场景，可按需加载。
10. 安装使用方式
# 方式一：npm 全局安装
npm install -g agent-browser
agent-browser install # 首次运行自动下载 Chrome for Testing
# 方式二：Homebrew（macOS）
brew install agent-browser
agent-browser install
# 方式三：Cargo
cargo install agent-browser
agent-browser install
# Linux 额外系统依赖
agent-browser install --with-deps在 Claude Code 中安装为插件：/plugin marketplace add vercel-labs/agent-browser，再 /plugin install agent-browser。安装后无需重启，Claude 会在识别到浏览器操作需求时自动调用该技能；也可运行 agent-browser skills get core 查看核心操作模式。
11. 注意事项
- 远程调试端口会在本机暴露完整浏览器控制权限，官方提示仅限可信设备使用
- 会话状态文件若未加密，含明文 session token，务必加入
.gitignore - Windows 环境下曾有用户反馈守护进程启动失败（Issue #390），使用前建议关注该平台的已知问题
- 云浏览器供应商与 AI Gateway 功能均为可选付费/需申请 Key 的增值能力，非核心必需