browser

name	browser
description	Headless browser automation using agent-browser CLI
metadata	{"zeroclaw":{"emoji":"🌐","requires":{"bins":"[Truncated]"}}}

Browser Skill

Control a headless browser for web automation, scraping, and testing.

Prerequisites

• agent-browser CLI installed globally (npm install -g agent-browser)
• Chrome downloaded (agent-browser install)

Installation

# Install agent-browser CLI
npm install -g agent-browser

# Download Chrome for Testing
agent-browser install --with-deps  # Linux
agent-browser install              # macOS/Windows

Usage

Navigate and snapshot

agent-browser open https://example.com
agent-browser snapshot -i

Interact with elements

agent-browser click @e1           # Click by ref
agent-browser fill @e2 "text"     # Fill input
agent-browser press Enter         # Press key

Extract data

agent-browser get text @e1        # Get text content
agent-browser get url             # Get current URL
agent-browser screenshot page.png # Take screenshot

Session management

agent-browser close               # Close browser

Common Workflows

Login flow

agent-browser open https://site.com/login
agent-browser snapshot -i
agent-browser fill @email "[e-mail]"
agent-browser fill @password "secretpass"
agent-browser click @submit
agent-browser wait --text "Welcome"

Scrape page content

agent-browser open https://news.ycombinator.com
agent-browser snapshot -i
agent-browser get text @e1

Take screenshots

agent-browser open https://google.com
agent-browser screenshot --full page.png

Options

• --json - JSON output for parsing
• --headed - Show browser window (for debugging)
• --session-name <name> - Persist session cookies
• --profile <path> - Use persistent browser profile

Configuration

The browser tool is enabled by default with allowed_domains = ["*"] and backend = "agent_browser". To customize, edit ~/.zeroclaw/config.toml:

[browser]
enabled = true              # default: true
allowed_domains = ["*"]     # default: ["*"] (all public hosts)
backend = "agent_browser"   # default: "agent_browser"
native_headless = true      # default: true

To restrict domains or disable the browser tool:

[browser]
enabled = false                              # disable entirely
# or restrict to specific domains:
allowed_domains = ["example.com", "docs.example.com"]

Full Command Reference

Run agent-browser --help for all available commands.

Related

• agent-browser GitHub
• VNC Setup Guide