reCAPTCHA

Use Captcha.autoSolve for reCAPTCHA. This type is handled by the external provider integration; sending it to Captcha.solve returns an error.

Before you start

Enable the solver when starting the browser:

{
  "anti_captcha": {
    "enabled": true,
    "disable_external_providers": false,
    "auto_captcha_types": ["recaptcha"]
  }
}

Your account needs the corresponding external provider configuration. Check solver balance and provider settings if solving does not begin.

Auto solving

Use the Playwright or Puppeteer lifecycle, adding the settings above to the start request. Create a page-level CDP session and attach listeners before enabling automatic mode:

cdp = await page.context.new_cdp_session(page)
cdp.on("Captcha.solveCompleted", lambda event: print("Completed:", event))
cdp.on("Captcha.solveFailed", lambda event: print("Failed:", event))
await cdp.send("Captcha.autoSolve", {"type": "recaptcha"})
await page.goto(target_url, wait_until="domcontentloaded")

const cdp = await page.context().newCDPSession(page);
cdp.on("Captcha.solveCompleted", event => console.log("Completed:", event));
cdp.on("Captcha.solveFailed", event => console.error("Failed:", event));
await cdp.send("Captcha.autoSolve", { type: "recaptcha" });
await page.goto(targetUrl, { waitUntil: "domcontentloaded" });

Replace the target URL with your page. Add a bounded wait for the form result or protected content after navigation. {"status": "started"} only confirms that automatic mode started.

Check the page result

reCAPTCHA v2, v3, and Enterprise can behave differently. A v2 challenge may display a widget, while v3 relies on a score and can require no visible interaction. Verify the form submission or protected response for the version the site uses; Surfsky does not promise a particular score. Keep the CDP connection open while solving. Avoid running a second solver against the same challenge. If verification completes but the page is still blocked, inspect the next network response or form validation error.

Troubleshooting

If nothing happens, confirm that the external integration was loaded, "recaptcha" is allowed in auto_captcha_types, and the challenge is present. Observe failure events and check provider availability before retrying. See CAPTCHA troubleshooting for shared errors and DevTools to inspect a running attempt. Stop the browser after the job completes.

Get started

Connect your tools

Browser sessions

Browser actions

CAPTCHA guides

Debugging

Performance and limits

About Surfsky

Before you start

Auto solving

Check the page result

Troubleshooting

​Before you start

​Auto solving

​Check the page result

​Troubleshooting

Before you start

Auto solving

Check the page result

Troubleshooting