它是什么,不是什么
- 它是智能体从 shell 调用的命令行工具:打开页面、获取快照、按引用点击或填写、截图、关闭。上游还列出会话、认证保管库、状态持久化和录屏等功能。
- 它是 Agent Skills 格式的技能,但内容很薄:仓库里的 SKILL.md 只用于让智能体发现这个命令行工具,真正的说明由命令行工具本身提供。
- 它不是 Playwright MCP 服务排行,不是在这里购买的托管浏览器服务,也不是爬虫。请只在你拥有或获准自动化的网站上使用。
第一步:安装命令行工具
以下命令依据提交 5868f7c05020 的上游 README 与 SKILL.md(2026 年 10 月 31 日抓取)。AgentSkillsDir 尚未亲自运行,每一步都是上游文档内容,待我们实测。
npm i -g agent-browser && agent-browser installnpm i -g 会安装原生二进制。随后 agent-browser install 从 Chrome for Testing 下载 Chrome(仅首次);已有的 Chrome、Brave、Playwright 和 Puppeteer 浏览器会被自动识别。macOS 13 以下版本会停止并提示你升级系统或手动安装 Chrome。
如果不想用 npm 全局安装,README 还提供以下方式:
项目依赖(锁定版本)
npm install agent-browser agent-browser installHomebrew(macOS)
brew install agent-browser agent-browser installCargo(Rust)
cargo install agent-browser agent-browser installLinux 系统依赖
agent-browser install --with-deps调用系统包管理器(非 root 时使用 sudo);若有浏览器依赖库装不上,会以非零状态退出。
之后升级
agent-browser upgrade自动识别 npm、Homebrew 或 Cargo,并执行对应的更新命令。
第二步:添加技能
npx skills add vercel-labs/agent-browserREADME 说明它适用于 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 仓库的带日期快照,请查看来源卡片上的最近核验时间。
相关
- 浏览目录中的全部 Claude 技能
- Playwright MCP 服务(微软)
- 同样来自 Vercel Labs 的 Deploy to Vercel 技能
- agent-browser.dev 官方技能文档
- 官方安装文档
