agent-browser

# Browser Automation with agent-browser

Automates browser interactions for web testing, form filling, screenshots, and data extraction. **93% less context** than Playwright MCP through Snapshot + Refs workflow.

## Overview

- Web scraping and data extraction from dynamic/JS-rendered pages
- Form automation and multi-step workflows
- Screenshot capture and visual verification
- E2E test generation and debugging
- Content capture from authenticated pages
- Browser-based automation tasks via CLI

## Installation

```bash
npm install -g agent-browser      # Install CLI
agent-browser install             # Download Chromium
agent-browser install --with-deps # With system dependencies (Linux)
```

## Quick Start

```bash
agent-browser open <url>          # Navigate to page
agent-browser snapshot -i         # Get interactive elements with refs
agent-browser click @e1           # Click element by ref
agent-browser fill @e2 "text"     # Fill input by ref
agent-browser close               # Close browser
```

## Core Workflow

1. **Navigate**: `agent-browser open <url>`
2. **Snapshot**: `agent-browser snapshot -i` (returns elements with refs like @e1, @e2)
3. **Interact** using refs from the snapshot
4. **Re-snapshot** after navigation or significant DOM changes

## Commands

### Navigation

```bash
agent-browser open <url>          # Navigate to URL (aliases: goto, navigate)
agent-browser connect <port>      # Connect to browser via CDP port
agent-browser back                # Go back
agent-browser forward             # Go forward
agent-browser reload              # Reload page
agent-browser close               # Close browser (aliases: quit, exit)
```

### Snapshot (Page Analysis)

```bash
agent-browser snapshot            # Full accessibility tree
agent-browser snapshot -i         # Interactive elements only (recommended)
agent-browser snapshot -c         # Compact output
agent-browser snapshot -d 3       # Limit depth to 3
agent-browser snapshot -s "#main" # Scope to CSS