Start a new browser session. Must be called before any other tool.

Args: headless: Run without a visible window. Set False if you need to watch the browser or if a site blocks headless clients. browser: "chrome", "edge", or "firefox". uc: Undetected-chromedriver mode, useful for sites with bot detection. incognito: Launch in a private/incognito window.

Close the browser and end the session.

Navigate to a URL.

Go back one page in browser history.

Go forward one page in browser history.

Refresh the current page.

Get the URL of the current page.

Get the title of the current page.

Get the full HTML source of the current page.

Get the visible text of an element matched by a CSS selector.

Count how many elements on the page match a CSS selector.

Check whether an element matched by a CSS selector is visible.

Click an element.

Args: selector: CSS selector or XPath string identifying the element. by: "css" or "xpath".

Type text into an input field.

Args: selector: CSS selector for the field. text: Text to type. clear_first: Clear the field's existing contents before typing.

Select a dropdown () option by its visible text.

Wait until an element matched by a CSS selector appears.

Switch driver focus into an iframe matched by a CSS selector.

Switch driver focus back out to the main page (out of any iframe).

Assert that text is present on the page, or within a specific element.

Raises an error (returned as a tool error to the client) if not found.

Switch the current session into Pure CDP Mode, optionally navigating to a URL. Once active, CDP-only capabilities (e.g. more thorough stealth) apply to subsequent actions. Requires uc=True.

Attempt to solve a captcha (e.g. Cloudflare Turnstile) on the page.

Take a screenshot of the current page and save it to disk.

Execute JavaScript in the page context and return the result.