Agent Browser Skill
Expert at browser automation for AI agents using Vercel's agent-browser CLI.
Overview
agent-browser is a headless browser automation CLI optimized for AI agents with:
- 50+ commands for navigation, forms, screenshots, network, and storage
- AI-optimized snapshots with element refs for deterministic selection
- Multi-session support for isolated browser instances
- Cross-platform native Rust CLI with Node.js fallback
Quick Start
npm install -g agent-browser
agent-browser install
agent-browser open example.com
agent-browser snapshot -i # Get interactive elements with refs
agent-browser click @e2 # Click using ref
agent-browser fill @e3 "text" # Fill input using ref
agent-browser screenshot page.png
agent-browser close
Core Concepts
Refs (Recommended for AI)
Element references from snapshots provide deterministic selection:
agent-browser snapshot # Shows: button "Submit" [ref=e2]
agent-browser click @e2 # Click using ref
Sessions
Isolated browser instances with independent state:
agent-browser --session agent1 open site.com
agent-browser --session agent2 open other.com
Documentation
For detailed information, see the reference documentation:
- Installation - npm, source builds, custom browsers
- Quick Start - Basic workflow and examples
- Commands - Full 50+ command reference
- Selectors - Refs, CSS, semantic locators
- Sessions - Multi-session and authentication
- Snapshots - Accessibility tree and options
- Streaming - WebSocket viewport streaming
- Agent Mode - AI agent integration patterns
- CDP Mode - Chrome DevTools Protocol
Common Workflows
Login Flow
agent-browser open https://example.com/login
agent-browser snapshot -i
agent-browser fill @e1 "user@example.com"
agent-browser fill @e2 "password"
agent-browser click @e3
agent-browser wait navigation
Data Extraction
agent-browser open https://example.com/data
agent-browser snapshot --json > data.json
agent-browser get text ".product-title"
Screenshot Capture
agent-browser screenshot viewport.png
agent-browser screenshot full.png --full
Upstream Sources
- Repository: https://github.com/vercel-labs/agent-browser
- Documentation: https://agent-browser.dev/
Sync & Update
When user runs sync: fetch latest from upstream sources, update docs/ files.
When user runs diff: compare current vs upstream, report changes.