agent-browser 项目配图

安装 agent-browser CLI + skill

agent-browser 来自 Vercel Labs(vercel-labs/agent-browser,Apache-2.0),是给 AI 智能体用的浏览器自动化命令行工具:一个快速的原生 Rust 二进制,经 CDP 驱动 Chrome,并把带简短 @eN 元素引用的无障碍树快照交给智能体。配套的发现技能会告诉 Claude Code、Codex 或 Cursor 何时调用它。

本页是附来源链接的目录条目,不是 Vercel 官方网站,不是 Playwright MCP 排行,也不是托管浏览器云。AgentSkillsDir 不会替你运行浏览器或自动化任务。

  1. 安装命令行工具和 Chrome

    用 npm 全局安装原生二进制;首次运行 agent-browser install 会下载 Chrome for Testing。

    npm i -g agent-browser && agent-browser install
  2. 添加发现技能

    直接从仓库获取,因此保持最新。不要从 node_modules 拷贝 SKILL.md。

    npx skills add vercel-labs/agent-browser
  3. 之后智能体加载真正的指南

    安装的技能只是存根,它会让智能体运行这条命令。

    agent-browser skills get core
  • npx skills add vercel-labs/agent-browser — 从仓库获取,保持最新
  • node_modules/…/SKILL.md — 手动拷贝会过期
和 Playwright MCP 有何不同?

以上为上游 README 与 SKILL.md 中的命令,AgentSkillsDir 尚未亲自运行。

它是什么,不是什么

  • 它是智能体从 shell 调用的命令行工具:打开页面、获取快照、按引用点击或填写、截图、关闭。上游还列出会话、认证保管库、状态持久化和录屏等功能。
  • 它是 Agent Skills 格式的技能,但内容很薄:仓库里的 SKILL.md 只用于让智能体发现这个命令行工具,真正的说明由命令行工具本身提供。
  • 它不是 Playwright MCP 服务排行,不是在这里购买的托管浏览器服务,也不是爬虫。请只在你拥有或获准自动化的网站上使用。

第一步:安装命令行工具

以下命令依据提交 5868f7c05020 的上游 README 与 SKILL.md(2026 年 10 月 31 日抓取)。AgentSkillsDir 尚未亲自运行,每一步都是上游文档内容,待我们实测。

npm i -g agent-browser && agent-browser install

npm i -g 会安装原生二进制。随后 agent-browser install 从 Chrome for Testing 下载 Chrome(仅首次);已有的 Chrome、Brave、Playwright 和 Puppeteer 浏览器会被自动识别。macOS 13 以下版本会停止并提示你升级系统或手动安装 Chrome。

如果不想用 npm 全局安装,README 还提供以下方式:

  • 项目依赖(锁定版本)

    npm install agent-browser agent-browser install
  • Homebrew(macOS)

    brew install agent-browser agent-browser install
  • Cargo(Rust)

    cargo install agent-browser agent-browser install
  • Linux 系统依赖

    agent-browser install --with-deps

    调用系统包管理器(非 root 时使用 sudo);若有浏览器依赖库装不上,会以非零状态退出。

  • 之后升级

    agent-browser upgrade

    自动识别 npm、Homebrew 或 Cargo,并执行对应的更新命令。

第二步:添加技能

npx skills add vercel-labs/agent-browser

README 说明它适用于 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、Goose、OpenCode、Windsurf。在 Claude Code 中,它会把存根写入 .claude/skills/agent-browser/SKILL.md。AgentSkillsDir 尚未逐一核对每个助手。

不要从 node_modules 拷贝 SKILL.md。上游说明那份副本会过期;npx skills add 会直接从仓库获取技能。

为什么技能只是存根:skills get core

SKILL.md 文件无法随命令行工具的版本更新而变化,所以上游把它保持在最小,由命令行工具输出与已安装版本配套的指南。智能体在第一次执行浏览器命令前会运行:

agent-browser skills get core          # start here
agent-browser skills get core --full   # + full command reference
agent-browser skills list              # what this CLI version ships

存根中列出的专项指南(待我们在当前版本上实测):

core
从这里开始:工作流、常用模式和排错。加 --full 可附带完整命令参考和模板。
electron
Electron 桌面应用,例如 VS Code、Slack、Discord 或 Figma。
slack
Slack 工作区自动化。
dogfood
对自己的应用做探索式测试、QA 和找 bug。
derive-client
录制 HAR,并为站点生成独立的 API 客户端。
vercel-sandbox
在 Vercel Sandbox 微虚拟机中运行 agent-browser。
protected-vercel-deployments
访问受保护的 Vercel 部署。
agentcore
AWS Bedrock AgentCore 云端浏览器。

最小冒烟测试

依据 README 的 Quick Start;AgentSkillsDir 尚未实际运行。

agent-browser open example.com
agent-browser snapshot   # accessibility tree with @eN refs
agent-browser close

快照会输出带 @e2 这类引用的无障碍树;之后智能体对这些引用执行 click @e2 或 fill @e3 "…",页面变化后再重新获取快照。

agent-browser 与 Playwright MCP

两者接入浏览器的路径不同。agent-browser 是原生命令行工具加技能:智能体执行 shell 命令并读取精简快照,守护进程不依赖 Playwright、Puppeteer 或 Node.js。Playwright MCP 是微软的 MCP 服务,客户端把它当作一组浏览器工具来连接。agent-browser 也能提供 MCP 服务(agent-browser mcp),但本页只介绍命令行工具和技能这条路径。如果你想在 shell 里使用 Vercel Labs 的命令行工作流,选 agent-browser;如果你在挑选 MCP 服务,请看我们的 Playwright MCP 条目。

安装前

  • 这是控制真实浏览器的第三方代码,涉及已登录会话和凭据保管库。在交给智能体使用前,请先阅读源代码和 core 指南。
  • 只对你拥有或获准自动化的网站使用,并遵守其使用条款。
  • 收录不等于安全审查。AgentSkillsDir 没有审查过这些代码。

常见问题

agent-browser skill 是什么?

Vercel Labs 的 agent-browser 命令行工具(vercel-labs/agent-browser,Apache-2.0)附带的发现技能。它告诉编程智能体何时通过该命令行工具驱动真实浏览器:工具经 CDP 控制 Chrome,并以无障碍树快照读取页面。它不是 Playwright MCP 排行榜。

如何安装命令行工具和技能?

先运行 npm i -g agent-browser && agent-browser install,再运行 npx skills add vercel-labs/agent-browser。依据 2026 年 10 月 31 日的上游 README;AgentSkillsDir 尚未亲自运行。

为什么安装后的 SKILL.md 这么短?

这是有意为之的发现存根。它只让智能体去运行 agent-browser skills get core,由已安装的命令行工具输出自带的指南,因此说明始终与你的版本一致。

可以直接从 node_modules 拷贝 SKILL.md 吗?

不可以。上游提醒从 node_modules 拷贝的副本会过期。请用 npx skills add 安装存根,用 agent-browser skills get 获取内容。

选 agent-browser 还是 Playwright MCP?

路径不同。agent-browser 是原生命令行工具加技能:智能体执行 shell 命令,不依赖 Playwright 或 Puppeteer。Playwright MCP 是微软的 MCP 服务,向客户端提供浏览器工具。我们的 /mcp/playwright-mcp 条目介绍后者;本站没有单独的对比页。

运行浏览器守护进程需要 Node.js 吗?

上游说明不需要:守护进程是原生 Rust 二进制,不依赖 Playwright 或 Node.js。npm 只是安装方式之一(也可用 Homebrew 和 Cargo);只有从源码构建时才需要 Node.js 24 以上版本。

哪些助手支持 npx skills add?

README 列出 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、Goose、OpenCode 和 Windsurf。AgentSkillsDir 尚未逐一核对。

AgentSkillsDir 会托管浏览器或销售云端自动化吗?

不会。这是附来源链接的目录条目,本页面不会安装或运行任何内容。Vercel Sandbox 和 AWS AgentCore 等选项由上游另行说明。

AgentSkillsDir 审查过代码吗?

没有。收录不等于安全审查。安装前请阅读源代码,并且只对你拥有或获准以此方式使用的网站做自动化。

星标数和版本号是最新的吗?

它们是来自 GitHub API 和 npm 仓库的带日期快照,请查看来源卡片上的最近核验时间。

更正与建议

发现内容过时,或想推荐一个技能?发送更正邮件。若要推荐资源,请提交供人工审核。