Image CAPTCHA

The image solver sends an image to the configured CapMonster provider and returns recognized text. Your script must enter the text and submit the form.

Before you start

Enable anti_captcha.enabled, configure a CapMonster key through your account, and create a page-level CDP session with the CAPTCHA setup. The image URL must be reachable by the solver’s HTTP client. It is fetched separately from the browser, so browser cookies and headers are not automatically attached. A URL that works only in your logged-in tab may fail here.

Manual solving

After navigating, obtain the absolute image URL from your page. Replace the selectors with those the site uses:

image_url = await page.locator("img.captcha").evaluate("img => img.src")
result = await cdp.send("Captcha.solve", {
    "type": "image",
    "timeout": 60000,
    "options": {"image_url": image_url},
})
if result.get("status") != "success" or not result.get("solution"):
    raise RuntimeError(result)
await cdp.send("Human.click", {"selector": "input[name='captcha']"})
await cdp.send("Human.type", {"text": result["solution"]})
await cdp.send("Human.click", {"selector": "button[type='submit']"})

const imageUrl = await page.locator("img.captcha").evaluate(img => img.src);
const result = await cdp.send("Captcha.solve", {
  type: "image",
  timeout: 60000,
  options: { image_url: imageUrl },
});
if (result.status !== "success" || !result.solution) {
  throw new Error(JSON.stringify(result));
}
await cdp.send("Human.click", { selector: "input[name='captcha']" });
await cdp.send("Human.type", { text: result.solution });
await cdp.send("Human.click", { selector: "button[type='submit']" });

Automatic mode is not supported for image. Supply an HTTP or HTTPS image URL; the current solver fetches it as a URL and does not accept a Base64 image body.

Check the result

The response contains status, type: "image", and solution on success. Recognition can succeed while the website rejects the answer. Wait for the site’s submission result and check whether the image refreshed before the answer was entered. If the solver fails, check the image URL’s accessibility, the provider configuration, and balance. Keep the same page open so the image and form belong to the same challenge attempt. See CAPTCHA troubleshooting.

Get started

Connect your tools

Browser sessions

Browser actions

CAPTCHA guides

Debugging

Performance and limits

About Surfsky

Before you start

Manual solving

Check the result

​Before you start

​Manual solving

​Check the result

Before you start

Manual solving

Check the result