用途：agent-browser 是面向 AI 智能体的浏览器自动化命令行工具，通过 CDP 直接控制 Chrome/Chromium，用于需要与网站交互的任务，如导航页面、填表单、点按钮、截图、下载和提取页面数据。
安装与准备：可通过 npm i -g agent-browser、brew install agent-browser 或 cargo install agent-browser 安装；运行 agent-browser install 下载 Chrome，agent-browser upgrade 更新到最新版。
核心工作流：通常按“导航—快照—交互—重新快照”进行。用 agent-browser open <url> 打开页面，agent-browser snapshot -i 获取带引用（如 @e1、@e2）的可交互元素，再据此执行 click、fill、select、check 等操作；导航或 DOM 变化后需重新快照获取新引用。命令可用 && 链式执行，后台守护进程使浏览器在命令间保持状态。不需要读取中间输出时可链式执行，需要先解析快照引用时则分开执行。
主要能力：包括导航与关闭、快照（含 CSS 选择器范围、包含光标可交互元素）、点击/输入/选择/按键/滚动、获取文本/URL/标题、多种等待条件、下载、网络请求查看与阻断、HAR 录制、视口与设备模拟、截图与 PDF、剪贴板、页面状态 diff、批量执行、iframe 内元素直接交互、并行会话、连接已有 Chrome、颜色方案设置、可视调试、本地文件（file://）、以及通过 iOS 模拟器驱动移动 Safari。
认证用法（资料列出多种方式）：可从用户浏览器导入认证状态（--auto-connect state save）、使用持久化 profile（--profile）、会话名称自动保存/恢复（--session-name）、加密的认证保管库（auth save/auth login，密码可经 stdin 传入，LLM 无需看到密码）、以及手动 state save/load。状态文件以明文包含会话令牌，应加入 .gitignore 并及时删除，可设置 AGENT_BROWSER_ENCRYPTION_KEY 进行静态加密。
安全（均为可选启用）：--content-boundaries 用标记包裹页面来源输出，帮助 LLM 区分工具输出与不可信页面内容；AGENT_BROWSER_ALLOWED_DOMAINS 限制可导航域名，并阻断非允许域名的子资源、WebSocket 与 EventSource 连接；AGENT_BROWSER_ACTION_POLICY 用策略文件限制破坏性操作。默认不限制导航、操作或输出。
限制：iOS 模拟器方式要求 macOS 与 Xcode，并需安装 Appium（npm install -g appium && appium driver install xcuitest）；真实设备需预先配置。资料未提供收费、价格、平台支持范围或效果数据，相关细节暂未提供。