browser

name	browser
description	Headless browser automation via agent-browser (Playwright/Chromium) - navigate, snapshot, click, type, screenshot, eval, console
activation_keywords	["browser","web","url","page","navigate","click","type","screenshot","chromium","playwright"]
execution_mode	server

Browser Skill

Provides server-side headless browser automation using agent-browser CLI (Playwright/Chromium backend):

• Navigate to URLs (with auto-snapshot and bot detection)
• Snapshot accessibility tree with element references (e.g., @e5)
• Click elements by reference
• Type text into input fields
• Scroll up/down
• Navigate back in history
• Press keyboard keys
• Take full-page screenshots (base64 PNG)
• Execute JavaScript in page context
• Read console messages and JS errors
• Session isolation per task_id

Use builtin_browser tool with fields:

• operation: one of "navigate", "snapshot", "click", "type", "scroll", "back", "press", "screenshot", "eval", "console", "close"
• url: URL to navigate to (required for navigate)
• ref: Element reference from snapshot (e.g., @e5) for click/type
• text: Text to type (for type) or key to press (for press)
• js: JavaScript expression to evaluate (required for eval)
• task_id: Session identifier (default: "default"); each task_id gets its own browser session
• direction: Scroll direction "up" or "down" (default: "down")
• full: Full page screenshot "true"/"false" (default: "false")
• clear: Clear console/errors after reading "true"/"false"

Response format:

• Always return the result in a single message. When taking a screenshot, embed the base64 PNG inline in your reply via ![alt](data:image/png;base64,...) — do not split into multiple messages.

Notes:

• Requires agent-browser CLI installed: npx agent-browser install --with-deps
• Each task_id maintains an isolated browser session with persistent state
• Sessions auto-clean after 5 minutes of inactivity
• Element references from snapshot (e.g., @e5) are used for click/type — not CSS selectors
• For simple HTTP fetches, prefer builtin_http_client (faster, lighter)