Playwright Captcha Solver Integration

Installation

Node.js:

npm install playwright deathbycaptcha-lib

Python:

pip install deathbycaptcha-official

Use your DBC account credentials in the client. Create an account and check pricing and balance before running the flow.

Code sample: reCAPTCHA v2 token flow (Node.js), adapted from the official runnable example.

const { chromium } = require('playwright');
const { HttpClient } = require('deathbycaptcha-lib');

const client = new HttpClient(process.env.DBC_USERNAME, process.env.DBC_PASSWORD);
const DEMO_URL = 'https://www.google.com/recaptcha/api2/demo';

async function solveRecaptchaV2(pageUrl, sitekey) {
  const balance = await new Promise((resolve, reject) =>
    client.get_balance((b) => (b ? resolve(b) : reject(new Error('Could not read balance')))));
  if (balance <= 0) throw new Error('No balance - top up before solving.');

  return new Promise((resolve, reject) =>
    client.decode(
      { extra: { type: 4, token_params: JSON.stringify({ googlekey: sitekey, pageurl: pageUrl }) } },
      (solution) => (solution && solution.text ? resolve(solution.text) : reject(new Error('No solution yet - retry')))
    ));
}

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.goto(DEMO_URL, { timeout: 60000 });

  // 1. extract the challenge parameters
  const sitekey = await page.getAttribute('#recaptcha-demo', 'data-sitekey');

  // 2. request the solution token from DBC (type 4 = reCAPTCHA v2 token)
  const token = await solveRecaptchaV2(DEMO_URL, sitekey);

  // 3. inject the token and trigger the page callback
  await page.evaluate((t) => {
    const el = document.getElementById('g-recaptcha-response');
    if (!el) return;
    el.style.display = 'block';
    el.value = t;
    el.dispatchEvent(new Event('input', { bubbles: true }));
    el.dispatchEvent(new Event('change', { bubbles: true }));
    const cfg = window.___grecaptcha_cfg;
    if (!cfg || !cfg.clients) return;
    for (const k of Object.keys(cfg.clients)) {
      const c = cfg.clients[k];
      for (const key of Object.keys(c)) {
        const item = c[key];
        if (item && typeof item.callback === 'function') return item.callback(t);
        if (item && item.W && typeof item.W.callback === 'function') return item.W.callback(t);
      }
    }
  }, token);

  // 4. submit and wait for success
  await page.click('#recaptcha-demo-submit');
  await page.waitForSelector('.recaptcha-success', { timeout: 15000 });

  console.log('solved');
  await browser.close();
})();

Full runnable version: examples/playwright in the official Node.js client repository

Typical Playwright Workflow

1. Detect challenge type in your browser automation flow.
2. Submit challenge parameters through the API.
3. Inject returned token/solution into the target flow.
4. Handle retries and failure routing with explicit timeout policy.

Supported task notes

Integration Considerations

Resources and official links

• API documentation
• Support and contact
• Pricing and balance
• Create an account
• Official Node.js client with runnable Playwright example
• Browser extension for Chrome (no-code path)
• Browser extension for Firefox (no-code path)

Implementation next step

For Playwright captcha solver rollout, validate one captcha type first, then expand coverage with reliability and pricing checks for production scale.