---

name: agent-browser description: Browser automation CLI for AI agents. Use this skill to navigate websites, interact with elements, take screenshots, and extract data using a headless browser. triggers:

• "browse the web"
• "open website"
• "check url"
• "take screenshot"
• "agent-browser"
• "use browser"

---

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

1. Navigate: agent-browser open <url>
2. Analyze: agent-browser snapshot -i (Get interactive elements with refs)
3. Interact: agent-browser click @e1 or agent-browser fill @e2 "text"
4. 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

Core Commands

agent-browser open # Navigate to URL (aliases: goto, navigate) agent-browser click # Click element agent-browser dblclick # Double-click element agent-browser focus # Focus element agent-browser type # Type into element agent-browser fill # Clear and fill agent-browser press # Press key (Enter, Tab, Control+a) (alias: key) agent-browser keydown # Hold key down agent-browser keyup # Release key agent-browser hover # Hover element agent-browser select # Select dropdown option agent-browser check # Check checkbox agent-browser uncheck # Uncheck checkbox agent-browser scroll [px] # Scroll (up/down/left/right) agent-browser scrollintoview # Scroll element into view (alias: scrollinto) agent-browser drag # Drag and drop agent-browser upload # Upload files agent-browser screenshot [path] # Take screenshot (--full for full page, base64 png to stdout if no path) agent-browser pdf # Save as PDF agent-browser snapshot # Accessibility tree with refs (best for AI) agent-browser eval # Run JavaScript agent-browser connect # Connect to browser via CDP agent-browser close # Close browser (aliases: quit, exit)

Get Info

agent-browser get text # Get text content agent-browser get html # Get innerHTML agent-browser get value # Get input value agent-browser get attr # Get attribute agent-browser get title # Get page title agent-browser get url # Get current URL agent-browser get count # Count matching elements agent-browser get box # Get bounding box Check State agent-browser is visible # Check if visible agent-browser is enabled # Check if enabled agent-browser is checked # Check if checked Find Elements (Semantic Locators) agent-browser find role [value] # By ARIA role agent-browser find text # By text content agent-browser find label [value] # By label agent-browser find placeholder [value] # By placeholder agent-browser find alt # By alt text agent-browser find title # By title attr agent-browser find testid [value] # By data-testid agent-browser find first [value] # First match agent-browser find last [value] # Last match agent-browser find nth [value] # Nth match Actions: click, fill, check, hover, text

Examples

agent-browser find role button click --name "Submit" agent-browser find text "Sign In" click agent-browser find label "Email" fill "test@test.com" agent-browser find first ".item" click agent-browser find nth 2 "a" text

Wait

agent-browser wait # Wait for element to be visible agent-browser wait # Wait for time (milliseconds) agent-browser wait --text "Welcome" # Wait for text to appear agent-browser wait --url "**/dash" # Wait for URL pattern agent-browser wait --load networkidle # Wait for load state agent-browser wait --fn "window.ready === true" # Wait for JS condition