hCaptcha solver for Playwright Python

Runnable example

from playwright.async_api import async_playwright
from captchasonic import CaptchaSonic

async with async_playwright() as p:
    browser = await p.chromium.launch()
    page = await browser.new_page()
    await page.goto('https://accounts.hcaptcha.com/demo')

    sonic = CaptchaSonic('YOUR_API_KEY')
    result = sonic.solve(
        type='HCaptchaTaskProxyless',
        website_url=page.url,
        website_key='10000000-ffff-ffff-ffff-000000000001',
    )

    await page.evaluate(
        '(t) => { document.querySelector("[name=h-captcha-response]").value = t; '
        'document.querySelector("[name=g-recaptcha-response]").value = t }',
        result.token,
    )
    await page.click('form button[type=submit]')

Replace YOUR_API_KEY with a real key from your dashboard. The token is good for one form submission.

FAQ

Can Playwright + Sonic clear hCaptcha Enterprise?

Yes. Pass the rqdata value (find it in the widget's bootstrap JS) and Sonic returns an Enterprise-valid token.

Why set both response fields?

hCaptcha is a drop-in replacement for reCAPTCHA. Backends that integrated reCAPTCHA before may still read g-recaptcha-response; new ones read h-captcha-response. Setting both covers either case.

Does this work headless?

Yes. Token injection lives in DOM, not in browser interaction history. Headless and headed Playwright sessions produce the same outcome.

Other hCaptcha stacks

• hCaptcha · Puppeteer · Node.jsBypass hCaptcha in Puppeteer Node.js scripts with a Sonic-issued token. Drop-in replacement for the manual click flow.
• Cloudflare Turnstile · Playwright · PythonPass Cloudflare Turnstile from Playwright Python. Sonic returns the cf-turnstile-response token in under 7 seconds, ready to drop into the page.
• hCaptcha · Selenium · PythonBypass hCaptcha from a Selenium Python script. Drop the Sonic token into the form's hidden field; no clicking the widget.
• DataDome · Playwright · PythonSolve DataDome from a Playwright Python scraper. Sonic returns the validated datadome cookie ready to inject before navigation.
• reCAPTCHA Enterprise · Playwright · PythonPass reCAPTCHA Enterprise from Playwright Python. Sonic returns an action-bound Enterprise token with high confidence scores.