Browser Automation with agent-browser
Use agent-browser CLI tool for all browser automation tasks. This is the preferred method for web interactions.
Important: Command Sequence
Always follow this sequence:
agent-browser launch- Start the browser firstagent-browser open <url>- Navigate to a URL- Perform operations (snapshot, click, type, etc.)
agent-browser close- Close when done
Quick Reference
First, run agent-browser without arguments to see full help:
agent-browser
Essential Commands
| Command | Description |
|---|---|
agent-browser launch |
Start browser (required before open) |
agent-browser open <url> |
Navigate to URL |
agent-browser snapshot |
Get page content as text |
agent-browser snapshot -i |
Get page content with element IDs for interaction |
agent-browser screenshot |
Take screenshot |
agent-browser click <selector> |
Click an element |
agent-browser type <selector> <text> |
Type text into input |
agent-browser close |
Close browser |
Common Workflows
View webpage content:
agent-browser launch
agent-browser open https://example.com
agent-browser snapshot
agent-browser close
Take screenshot:
agent-browser launch
agent-browser open https://example.com
agent-browser screenshot
agent-browser close
Fill form and submit:
agent-browser launch
agent-browser open https://example.com/login
agent-browser snapshot -i # Get element IDs
agent-browser type "#username" "myuser"
agent-browser type "#password" "mypass"
agent-browser click "#submit"
agent-browser close
Extract data from page:
agent-browser launch
agent-browser open https://example.com/data
agent-browser snapshot # Returns structured text content
agent-browser close
Tips
- Always launch first:
agent-browser openwill fail if browser isn't launched - Use snapshot -i for interactions: The
-iflag shows element IDs needed for click/type - Check help for more options: Run
agent-browser <command> --helpfor detailed options - Close when done: Always close the browser to free resources
When NOT to Use
- For simple HTTP requests without JavaScript rendering, use
curlorWebFetch - For API calls, use appropriate HTTP tools
- agent-browser is for full browser automation with JavaScript support
Troubleshooting
If agent-browser command not found:
npm install -g agent-browser
agent-browser install
If browser fails to launch on Linux:
agent-browser install --with-deps