热门 AI 项目中文文档 / agent-browser

agent-browser 中文文档：安装与快速入门

非官方中文翻译。AI 翻译，未经人工逐项校对。 本页翻译原项目 README 中的安装和快速入门章节；其他章节请查看原文。

agent-browser 是一款面向 AI 智能体的浏览器自动化命令行工具。它可以打开网页、读取页面的无障碍树，并通过 shell 对页面元素执行操作。

• 原始仓库：vercel-labs/agent-browser
• 原文：README.md 的安装与快速入门
• 对应 commit：edc992b1a3ded1433558c8931d5d5f484ae89846
• README 原文 SHA-256：a96587f37a6e624a56ceba9402892f072229b49f50dc6f56b1c128ce9a2126b2
• 翻译章节原文 SHA-256：c666bc457e39ffe1dc12e4f59d5f29e1a2fcaef6d91a976acf74be1d77495ca8
• 翻译及同步时间：2026-11-09 15:31 UTC
• 原项目作者：Vercel Labs；原文标注 Apache License 2.0。本页为翻译后的修改版本。

安装

npm install -g agent-browser
agent-browser install           # download Chrome for Testing (first time only)

• Homebrew： 执行 brew install agent-browser，然后执行 agent-browser install。
• Linux： agent-browser install --with-deps 还会安装浏览器所需的系统库。
• 无需安装： npx agent-browser open example.com。

项目内安装、从源代码构建、upgrade 和 doctor 的说明请参阅安装文档。

快速入门

agent-browser open example.com
agent-browser snapshot -i       # interactive elements, each with a ref
agent-browser click @e1         # act on a ref from that snapshot
agent-browser get url           # check the result
agent-browser close

example.com 的快照：

- link "Learn more" [ref=e1]

• 引用标识描述的是拍摄快照时的页面状态。导航或 DOM 发生变化后，请重新获取快照再使用这些引用。
• 也可以使用 CSS 选择器、文本、XPath 和语义定位器，例如 agent-browser find role button click --name "Submit"。参见选择器文档。
• 当目标被隐藏、禁用、位于视口之外，或者被同意提示等其他元素遮挡时，点击会失败，不会报告成功。请移除遮挡元素、重新获取快照并重试。

完整的操作说明请参阅快速入门。