bowtiedswan Agent Browser Skill
This skill provides access to the agent-browser CLI, a powerful tool for headless browser automation designed for AI agents.
🚀 Usage
The core workflow relies on snapshots and refs. Instead of guessing CSS selectors, you get a snapshot of the page with unique references (like @e1, @e2) for every interactive element.
Basic Workflow
- Navigate:
agent-browser open <url> - Analyze:
agent-browser snapshot -i(Get interactive elements with refs) - Interact:
agent-browser click @e1oragent-browser fill @e2 "text" - Repeat: Take a new snapshot after interactions to see the updated state.
Common Commands
- Open URL:
agent-browser open google.com - Get Snapshot:
agent-browser snapshot -i(Interactive only, recommended) - Click:
agent-browser click @e1 - Type/Fill:
agent-browser fill @e2 "search term" - Press Key:
agent-browser press Enter - Go Back:
agent-browser back - Screenshot:
agent-browser screenshot page.png - Read Text:
agent-browser get text @e1
Advanced
- Sessions:
agent-browser --session my-session open ...(Keep cookies/state separate) - Wait:
agent-browser wait --text "Success" - Help:
agent-browser --help
💡 Tips for Claude
- Always snapshot first: Before clicking or typing, get a fresh snapshot to ensure you have valid refs.
- Use
-iflag:agent-browser snapshot -ifilters for interactive elements, reducing noise. - Check output: The CLI returns JSON or text. Read it to confirm actions succeeded.