Selenium Captcha Solver Integration

Installation

Python:

pip install selenium 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 (Python + Selenium), adapted from the official runnable example.

import json
import os
import time

import deathbycaptcha
from selenium import webdriver
from selenium.webdriver.common.by import By

USERNAME = os.getenv('DBC_USERNAME')
PASSWORD = os.getenv('DBC_PASSWORD')
DEMO_URL = 'https://www.google.com/recaptcha/api2/demo'

def solve_recaptcha_v2(driver):
    # 1. extract the challenge parameters from the page
    sitekey = driver.find_element(By.ID, 'recaptcha-demo').get_attribute('data-sitekey')
    token_params = json.dumps({'googlekey': sitekey, 'pageurl': DEMO_URL})

    client = deathbycaptcha.SocketClient(USERNAME, PASSWORD)
    if client.get_balance() <= 0:
        raise SystemExit('No balance - top up before solving.')

    # 2. request the solution token from DBC (type 4 = reCAPTCHA v2 token)
    result = client.decode(type=4, token_params=token_params)
    return result['text'] if result else None

driver = webdriver.Firefox()
driver.get(DEMO_URL)

token = solve_recaptcha_v2(driver)
if not token:
    print('No solution yet - retry with backoff')
    raise SystemExit(1)


# 3. inject the token back into the page
driver.execute_script("document.getElementById('g-recaptcha-response').value = arguments[0]", token)

# 4. submit and wait for the success element
driver.find_element(By.ID, 'recaptcha-demo-submit').click()
time.sleep(2)
print(driver.find_element(By.CLASS_NAME, 'recaptcha-success').text)
driver.quit()

Full runnable version: examples/deathbycaptcha-python-selenium in the official Python client repository

Where Selenium Teams Usually Struggle

• Flaky solves causing intermittent test failures.
• Inconsistent challenge handling across environments.
• Weak retry and timeout strategy under high concurrency.

Selenium Integration Matrix

Supported task notes

Resources and official links

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

Implementation next step

For Selenium captcha solver deployment, confirm stable token flow first, then connect reliability and pricing pages to finalize production planning.