agent-browser 是面向 AI 智能体的浏览器自动化 CLI,用于让智能体与网站交互,例如导航页面、填写表单、点击按钮、截图和提取数据。
核心工作流:先用 agent-browser open <url> 打开页面,再用 agent-browser snapshot -i 获取带引用(如 @e1、@e2)的交互元素,随后用引用执行 click、fill、select 等操作;页面导航或 DOM 变化后必须重新快照以获取新引用。
主要能力:导航(open、close,别名 goto、navigate);快照(snapshot -i,可用 -s 限定 CSS 选择器);交互(click、fill、type、select、check、press、scroll);信息获取(get text、get url、get title);等待(wait 元素、--load networkidle、--url 模式、毫秒数);捕获(screenshot、--full、pdf)。
常见用法:表单提交按 open、snapshot、fill、select、check、click、wait 顺序执行;认证可用 state save/load 保存并复用登录状态;数据提取可用 get text 或 snapshot --json 输出 JSON;并行会话用 --session 区分;调试可用 --headed、highlight、record start;iOS 模拟器用 -p ios 配合 device list、tap、swipe,需 macOS、Xcode 与 Appium(npm install -g appium && appium driver install xcuitest),真机需预先配置并用 --device "<UDID>"。
限制与注意:引用在页面变化后失效,必须重新快照;引用不可靠时可改用语义定位(find text/label/role/placeholder/testid)。资料未提供安装方式、收费、价格与平台支持范围等细节。