Skip to main content

BrowserTools

Toolkit that gives an agent a headless Chromium browser via Playwright. The agent gets tools for navigation, clicking, filling forms, downloading files, screenshotting, and extracting page content; optional flags add network, console, and WebSocket capture tools.

Parameters

NameDescriptionTypeDefault
urlRestrict navigation to one URL or a list of allowed URLs. None allows any URL. Defaults to None.OptionalNone
listen_networkIf True, capture all HTTP requests made by the page and expose get_network_requests to the agent. Defaults to False.boolFalse
listen_consoleIf True, capture browser console messages and expose get_console_logs to the agent. Defaults to False.boolFalse
debug_modeIf True, print verbose debug output for every browser action (navigation, clicks, fills, etc.). Useful for local development. Defaults to False.boolFalse
allow_close_pageIf True, expose a close_page tool to the agent. Defaults to True.boolTrue
headlessRun Chromium in headless mode. Set to False to see the browser window during local development. Defaults to True.boolTrue
client_certificateOptional mTLS client certificate to present on requests, as a dict with keys origin, pfx_base64, and passphrase. Defaults to None.OptionalNone