Launch a new browser instance with optional configuration (headless, proxy, user agent, etc.)

Close the browser instance

Navigate to a URL

Navigate back in browser history

Navigate forward in browser history

Refresh the current page

Get information about the current page (URL, title)

Enable network event monitoring to capture all HTTP traffic

Disable network event monitoring

Get captured network logs, optionally filtered by URL pattern

Get the response body for a specific request ID

Enable request/response interception

Disable request interception

Set up automatic interception handler with blocking, modification, and mocking rules

Find an element on the page using various selectors

Find multiple elements on the page

Get the text content of an element

Get the outer HTML of an element

Click on an element. IMPORTANT: You SHOULD either call debug_screenshot or view the source after every click to observe the result of the interaction.

Type text into an input element

Scroll the page

Get the full page HTML source

Wait for an element to appear on the page

Execute JavaScript in the browser context

Get console logs from the browser

Extract global JavaScript variables

Get all localStorage data

Get all sessionStorage data

Set a localStorage value

Get all forms on the page with their inputs

Get all links on the page

Get all cookies from the browser

Get a specific cookie by name

Set a cookie in the browser

Delete a cookie by name

Clear all cookies

Export cookies in various formats (json, netscape, header)

Import cookies from JSON string

Make an HTTP request using the browser's session (inherits cookies/auth)

Take a screenshot of the current page. Returns the image directly. MUST be called after every dom_click to observe the result.

Get the current viewport size

Set the viewport size

Get performance metrics from the page

Highlight all elements matching a selector

Enable automatic Cloudflare Turnstile bypass. Uses PyDoll's built-in mechanism to detect and click the Turnstile checkbox. Success depends on IP reputation and browser fingerprint - this is NOT a magic bypass. Use residential proxies for best results.

Disable automatic Turnstile bypass

Detect what type of captcha is present on the current page. Scans for Cloudflare Turnstile, reCAPTCHA, hCaptcha, and image challenge indicators.

Attempt to automatically handle any detected captcha. For Turnstile: uses built-in bypass. For others (ReCAPTCHA v2, hCaptcha, image challenges): returns need for human intervention.

Request human intervention for an unsolvable captcha (e.g., ReCAPTCHA v2 image challenges, hCaptcha puzzles). Creates an intervention request with screenshot. The automation should wait for human to solve.

Get all pending human intervention requests that have not been resolved

Mark an intervention request as resolved after human has solved the captcha. This allows the automation to continue.

Block until a human intervention is resolved or timeout expires. Use this to pause automation while waiting for human to solve captcha.