web-browse

Web Browse

Drive a real headless browser (Chromium) to accomplish web tasks that a plain http_request cannot: pages that render content with JavaScript, multi-step flows, forms, and anything gated behind a click.

The browser is registered only because this skill declares requires.capabilities: [browser]. All navigation is forced through the agent's egress proxy, so it obeys the same allowlist, SSRF, and DNS-rebinding protections as every other web tool. Add the domains you need to egress_domains; a page that redirects off-allowlist is blocked.

Tools

You drive the browser through six tools. You never see raw HTML — every observation is a compact digest: the page title, URL, a numbered list of interactive elements ([3] input(email) "Work email"), and the start of the page text.

• browser_navigate {url, wait_ms?} — load a page, get its digest.
• browser_state {max_elements?, scroll_pages?, scroll_to_index?} — re-read the current page (after it changed on its own, to scroll, or to see more elements). Returns a fresh digest with new indices and generation.
• browser_click {index, generation} — click the element at index from the latest digest. Returns the resulting page digest.
• browser_fill {index, text, generation, submit?} — type into an input (or pick a select option by label). submit: true presses Enter. Password and payment fields are refused unless this skill opts in.
• browser_extract {mode?, selector?, max_chars?, offset?} — pull page content: text (readable markdown, default), links, or html (scoped to a CSS selector). Long content is paginated — pass the offset from the previous call's header to continue.
• browser_screenshot {full_page?, filename?} — capture a PNG for the user (attached to the reply; you will not see the image). Use only when the user wants a visual — read pages with digests and browser_extract.

Workflow

1. browser_navigate to the target URL. Read the digest's [N] elements and note the Generation number.
2. To act, pass that generation to browser_click / browser_fill with the element's index. Every action returns a fresh digest — read it, don't assume the old indices still hold.
3. If you act on a stale generation (the page navigated or changed), the tool returns an error with a fresh digest — retry using the new indices and generation.
4. For long articles or tables, browser_extract with mode: text and paginate via offset. Use mode: links to enumerate links.