| name | browser_ai |
| description | Simulate browser navigation metadata, selector extraction, and screenshot paths without network or file writes. Use when testing the Browser AI contract offline. Trigger with simulate browser or browser contract. |
| allowed-tools | Bash(python:*), Bash(oss-lab:*) |
| version | 0.2.0 |
| author | Intent Solutions <jeremy@intentsolutions.io> |
| license | MIT |
| compatibility | Requires Python 3.11+ and an OSS Agent Lab checkout installed with pip install -e .; this prototype does not launch Lightpanda, fetch URLs, parse a DOM, or create PNG files. |
| tags | ["browser","simulation","offline","automation","prototype"] |
| argument-hint | [URL] [--selector CSS] [--format text|html|markdown] |
| model | inherit |
| effort | low |
| display_name | Browser AI Specialist |
| source_repo | lightpanda-io/browser |
| tier | core |
| capabilities | ["browse","web_automation","scrape","screenshot"] |
| allowed_tools | ["navigate","extract_content","take_screenshot"] |
| output_formats | ["python_api","cli","mcp_server","agent_skill","rest_api"] |
Browser AI Specialist
Overview
The Browser AI specialist mirrors part of the lightpanda-io/browser
interface for offline contract tests. It composes synthetic navigation, extraction, and screenshot
metadata through one execute() call or standalone Python functions.
The current implementation is synthetic. It parses the URL string, derives deterministic metadata,
returns synthetic content, and constructs a PNG path without fetching a page or writing a file.
Prerequisites
- Use Python 3.11+ in a local OSS Agent Lab checkout and run
pip install -e ..
- Supply an
http:// or https:// URL; do not expect the target to be contacted.
- Read the runtime contract before interpreting outputs.
Capabilities
- browse: Validate an HTTP(S) URL string and synthesize redirect, status, title, and timing fields.
- web_automation: Exercise the three-stage result contract in one local request.
- scrape: Return format-shaped synthetic content for a small selector allowlist.
- screenshot: Validate a viewport and return an unwritten PNG path plus dimensions.
Tools
| Tool | Description | Parameters | Side Effects |
|---|
navigate | Synthesize URL load metadata | url, wait_for | None |
extract_content | Synthesize selector-shaped content | url, selector, format | None |
take_screenshot | Construct PNG path metadata | url, viewport | None; no file is written |
Tool Parameter Reference
navigate
url: str — fully-qualified URL to load (required)wait_for: str | None — CSS selector or browser event to await before page-ready
(default: , waits for )
