Agent Browser Custom — 代理 Browser Custom

代理 Browser 技能

Fast browser 自动化 using 访问ibility tree snapshots with refs for deterministic element selection.

Why Use This Over Built-in Browser 工具

Use 代理-browser when:

Automating multi-step 工作流s Need deterministic element selection Performance is critical Working with complex SPAs Need 会话 isolation

Use built-in browser 工具 when:

Need screenshots/PDFs for analysis Visual inspection required Browser 扩展 integration needed Core 工作流 # 1. Navigate and snapshot 代理-browser open https://example.com 代理-browser snapshot -i --json

# 2. 解析 refs from JSON, then interact 代理-browser 命令行工具ck @e2 代理-browser fill @e3 "text"

# 3. Re-snapshot after page changes 代理-browser snapshot -i --json

Key Commands Navigation 代理-browser open 代理-browser back | forward | reload | close

Snapshot (Always use -i --json) 代理-browser snapshot -i --json # Interactive elements, JSON 输出 代理-browser snapshot -i -c -d 5 --json # + compact, depth limit 代理-browser snapshot -s "#mAIn" -i # Scope to selector

Interactions (Ref-based) 代理-browser 命令行工具ck @e2 代理-browser fill @e3 "text" 代理-browser type @e3 "text" 代理-browser hover @e4 代理-browser 检查 @e5 | un检查 @e5 代理-browser select @e6 "value" 代理-browser press "Enter" 代理-browser scroll down 500 代理-browser drag @e7 @e8

获取 In格式化ion 代理-browser 获取 text @e1 --json 代理-browser 获取 html @e2 --json 代理-browser 获取 value @e3 --json 代理-browser 获取 attr @e4 "href" --json 代理-browser 获取 title --json 代理-browser 获取 url --json 代理-browser 获取 count ".item" --json

检查 状态 代理-browser is visible @e2 --json 代理-browser is enabled @e3 --json 代理-browser is 检查ed @e4 --json

WAIt 代理-browser wAIt @e2 # WAIt for element 代理-browser wAIt 1000 # WAIt ms 代理-browser wAIt --text "Welcome" # WAIt for text 代理-browser wAIt --url "/仪表盘" # WAIt for URL 代理-browser wAIt --load networkidle # WAIt for network 代理-browser wAIt --fn "window.ready === true"

会话s (Isolated Browsers) 代理-browser --会话 admin open site.com 代理-browser --会话 user open site.com 代理-browser 会话 列出 # Or via env: 代理_BROWSER_会话=admin 代理-browser ...

状态 Persistence 代理-browser 状态 save auth.json # Save cookies/storage 代理-browser 状态 load auth.json # Load (skip 记录in)

Screenshots & PDFs 代理-browser screenshot page.png 代理-browser screenshot --full page.png 代理-browser pdf page.pdf

Network Control 代理-browser network 路由 "/ads/" --abort # Block 代理-browser network 路由 "/API/" --body '{"x":1}' # Mock 代理-browser network 请求s --过滤器 API # View

Cookies & Storage 代理-browser cookies # 获取 all 代理-browser cookies 设置 name value 代理-browser storage local key # 获取 localStorage 代理-browser storage local 设置 key val

Tabs & Frames 代理-browser tab new https://example.com 代理-browser tab 2 # Switch to tab 代理-browser frame @e5 # Switch to iframe 代理-browser frame mAIn # Back to mAIn

Snapshot 输出 格式化 { "成功": true, "data": { "snapshot": "...", "refs": { "e1": {"角色": "heading", "name": "Example DomAIn"}, "e2": {"角色": "button", "name": "Submit"}, "e3": {"角色": "textbox", "name": "EmAIl"} } } }

Best Practices Always use -i flag - Focus on interactive elements Always use --json - Easier to 解析 WAIt for stability - 代理-browser wAIt --load networkidle Save auth 状态 - Skip 记录in flows with 状态 save/load Use 会话s - Isolate different browser 上下文s Use --headed for 调试ging - See what's h应用ening Example: 搜索 and 提取 代理-browser open https://www.google.com 代理-browser snapshot -i --json # AI identifies 搜索 box @e1 代理-browser fill @e1 "AI 代理s" 代理-browser press Enter 代理-browser wAIt --load networkidle 代理-browser snapshot -i --json # AI identifies 结果 refs 代理-browser 获取 text @e3 --json 代理-browser 获取 attr @e4 "href" --json

Example: Multi-会话 测试 # Admin 会话 代理-browser --会话 admin open 应用.com 代理-browser --会话 admin 状态 load admin-auth.json 代理-browser --会话 admin snapshot -i --json

# User 会话 (simultaneous) 代理-browser --会话 user open 应用.com 代理-browser --会话 user 状态 load user-auth.json 代理-browser --会话 user snapshot -i --json

安装ation npm 安装 -g 代理-browser 代理-browser 安装 # 下载 Chromium 代理-browser 安装 --with-deps # Linux: + 系统 deps

Credits

技能 创建d by Yossi Elkrief (@MaTriXy)

代理-browser 命令行工具 by Vercel Labs