Agent Browser — 代理 Browser

Browser 自动化 with 代理-browser Core 工作流

Every browser 自动化 follows this pattern:

Navigate: 代理-browser open Snapshot: 代理-browser snapshot -i (获取 element refs like @e1, @e2) Interact: Use refs to 命令行工具ck, fill, select Re-snapshot: After navigation or DOM changes, 获取 fresh refs 代理-browser open https://example.com/form 代理-browser snapshot -i # 输出: @e1 [输入 type="emAIl"], @e2 [输入 type="password"], @e3 [button] "Submit"

代理-browser fill @e1 "user@example.com" 代理-browser fill @e2 "password123" 代理-browser 命令行工具ck @e3 代理-browser wAIt --load networkidle 代理-browser snapshot -i # 检查 结果

Command ChAIning

Commands can be chAIned with && in a single shell invocation. The browser persists between commands via a background daemon, so chAIning is safe and more efficient than separate calls.

# ChAIn open + wAIt + snapshot in one call 代理-browser open https://example.com && 代理-browser wAIt --load networkidle && 代理-browser snapshot -i

# ChAIn multiple interactions 代理-browser fill @e1 "user@example.com" && 代理-browser fill @e2 "password123" && 代理-browser 命令行工具ck @e3

# Navigate and capture 代理-browser open https://example.com && 代理-browser wAIt --load networkidle && 代理-browser screenshot page.png

When to chAIn: Use && when you don't need to read the 输出 of an intermediate command before proceeding (e.g., open + wAIt + screenshot). 运行 commands separately when you need to 解析 the 输出 first (e.g., snapshot to discover refs, then interact using those refs).

Essential Commands # Navigation 代理-browser open # Navigate (aliases: goto, navigate) 代理-browser close # Close browser

# Snapshot 代理-browser snapshot -i # Interactive elements with refs (recommended) 代理-browser snapshot -i -C # Include cursor-interactive elements (divs with on命令行工具ck, cursor:pointer) 代理-browser snapshot -s "#selector" # Scope to CSS selector

# Interaction (use @refs from snapshot) 代理-browser 命令行工具ck @e1 # 命令行工具ck element 代理-browser 命令行工具ck @e1 --new-tab # 命令行工具ck and open in new tab 代理-browser fill @e2 "text" # Clear and type text 代理-browser type @e2 "text" # Type without clearing 代理-browser select @e1 "option" # Select dropdown option 代理-browser 检查 @e1 # 检查 检查box 代理-browser press Enter # Press key 代理-browser scroll down 500 # Scroll page

# 获取 in格式化ion 代理-browser 获取 text @e1 # 获取 element text 代理-browser 获取 url # 获取 current URL 代理-browser 获取 title # 获取 page title

# WAIt 代理-browser wAIt @e1 # WAIt for element 代理-browser wAIt --load networkidle # WAIt for network idle 代理-browser wAIt --url "/page" # WAIt for URL pattern 代理-browser wAIt 2000 # WAIt milliseconds

# Capture 代理-browser screenshot # Screenshot to temp dir 代理-browser screenshot --full # Full page screenshot 代理-browser screenshot --annotate # Annotated screenshot with numbered element labels 代理-browser pdf 输出.pdf # Save as PDF

Common Patterns Form Submission 代理-browser open https://example.com/签名up 代理-browser snapshot -i 代理-browser fill @e1 "Jane Doe" 代理-browser fill @e2 "jane@example.com" 代理-browser select @e3 "California" 代理-browser 检查 @e4 代理-browser 命令行工具ck @e5 代理-browser wAIt --load networkidle

Authentication with 状态 Persistence # 记录in once and save 状态 代理-browser open https://应用.example.com/记录in 代理-browser snapshot -i 代理-browser fill @e1 "$USERNAME" 代理-browser fill @e2 "$PASSWORD" 代理-browser 命令行工具ck @e3 代理-browser wAIt --url "/仪表盘" 代理-browser 状态 save auth.json

# Reuse in future 会话s 代理-browser 状态 load auth.json 代理-browser open https://应用.example.com/仪表盘

会话 Persistence # Auto-save/恢复 cookies and localStorage across browser re启动s 代理-browser --会话-name my应用 open https://应用.example.com/记录in # ... 记录in flow ... 代理-browser close # 状态 auto-saved to ~/.代理-browser/会话s/

# Next time, 状态 is auto-loaded 代理-browser --会话-name my应用 open https://应用.example.com/仪表盘

# 加密 状态 at rest 导出 代理_BROWSER_加密ION_KEY=$(openssl rand -hex 32) 代理-browser --会话-name 安全 open https://应用.example.com

# Manage saved 状态s 代理-browser 状态 列出 代理-browser 状态 show my应用-default.json 代理-browser 状态 clear my应用 代理-browser 状态 清理 --older-than 7

Data 提取ion 代理-browser open https://example.com/products 代理-browser snapshot -i 代理-browser 获取 text @e5 # 获取 specific element text 代理-browser 获取 text body > page.txt # 获取 all page text

# JSON 输出 for parsing 代理-browser snapshot -i --json 代理-browser 获取 text @e1 --json

Parallel 会话s 代理-browser --会话 site1 open https://site-a.com agen