agent-browser

Original：🇺🇸 English
Translated

Fast headless browser CLI for AI agents. Supports deterministic element selection via accessibility tree snapshots and refs (@e1, @e2).

10.6kinstalls
Sourcesupercent-io/skills-template
Added on

NPX Install

npx skill4agent add supercent-io/skills-template agent-browser

Tags

Translated version includes tags in frontmatter
agent-browserheadless-browserai-automationweb-scrapinge2e-testing

SKILL.md Content

View Translation Comparison →

agent-browser - Headless Browser for AI Agents

When to use this skill

  • Web automation and E2E testing
  • Scraping data from modern web apps
  • Deterministic element interaction using accessibility tree refs
  • Isolated browser sessions for different agent tasks

1. Installation

bash
npx skills add vercel-labs/agent-browser
# or
npm install -g agent-browser
agent-browser install

2. Core Workflow (Deterministic Interaction)

AI agents should use the snapshot + ref workflow for best results:
  1. Navigate: 
    agent-browser open <url>
  2. Snapshot: 
    agent-browser snapshot -i
    (Returns tree with refs like @e1, @e2)
  3. Interact: 
    agent-browser click @e1
    or 
    agent-browser fill @e2 "text"
  4. Repeat: Snapshot again if page changes

3. Key Commands

CommandDescription
open <url>
Navigate to a URL
snapshot
Get accessibility tree with refs
click <sel>
Click element (by ref or CSS)
fill <sel> <text>
Clear and fill input
screenshot [path]
Take page screenshot
close
Quit browser session

4. Advanced Features

  • Isolated Sessions: Use 
    --session <name>
    to isolate cookies/storage.
  • Persistent Profiles: Use 
    --profile <path>
    to persist login sessions.
  • Semantic Locators: 
    find role button click --name "Submit"
  • JavaScript Execution: 
    eval "window.scrollTo(0, 100)"

Quick Reference

bash
# Optimal AI Workflow
agent-browser open example.com
agent-browser snapshot -i --json
# (AI parses refs)
agent-browser click @e2