GeeTest CAPTCHA Guide — v3, v4, and How to Solve Them

import re
import requests

def get_geetest_v3_params(page_url: str) -> dict:
    """
    Extract GeeTest v3 gt key and challenge from the page.
    Note: challenge is often fetched dynamically via XHR — may need
    to intercept the network request instead.
    """
    headers = {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"}
    html = requests.get(page_url, headers=headers).text

    gt = re.search(r'"gt"\s*:\s*"([0-9a-f]{32})"', html)
    challenge = re.search(r'"challenge"\s*:\s*"([0-9a-f]{32}(?:\.[0-9a-f]+)?)"', html)

    if not gt or not challenge:
        raise ValueError(
            "GeeTest v3 parameters not found in HTML. "
            "The challenge may be fetched via XHR — intercept /captcha/register or similar."
        )
    return {"gt": gt.group(1), "challenge": challenge.group(1)}

from playwright.sync_api import sync_playwright

def get_geetest_v3_via_xhr(page_url: str) -> dict:
    """Intercept the GeeTest challenge XHR to capture gt and challenge."""
    captured = {}

    def handle_response(response):
        if "captcha/register" in response.url or "gt=" in response.url:
            try:
                data = response.json()
                if "gt" in data:
                    captured["gt"] = data["gt"]
                    captured["challenge"] = data["challenge"]
            except Exception:
                pass

    with sync_playwright() as p:
        browser = p.chromium.launch(headless=True)
        page = browser.new_page()
        page.on("response", handle_response)
        page.goto(page_url, wait_until="networkidle")
        browser.close()

    if not captured:
        raise ValueError("Could not capture GeeTest v3 challenge via XHR")
    return captured

import requests
import time

def solve_geetest_v3(
    api_key: str,
    page_url: str,
    gt: str,
    challenge: str,
) -> dict:
    """
    Solve GeeTest v3 using CaptchaAI (2Captcha-compatible API).
    Returns dict with geetest_challenge, geetest_validate, geetest_seccode.
    """
    payload = {
        "key": api_key,
        "method": "geetest",
        "gt": gt,
        "challenge": challenge,
        "pageurl": page_url,
        "json": 1,
    }

    r = requests.post("https://ocr.captchaai.com/in.php", data=payload, timeout=30)
    r.raise_for_status()
    result = r.json()
    if result.get("status") != 1:
        raise RuntimeError(f"Submit failed: {result}")
    task_id = result["request"]

    time.sleep(10)
    for _ in range(24):
        r = requests.get(
            "https://ocr.captchaai.com/res.php",
            params={"key": api_key, "action": "get", "id": task_id, "json": 1},
            timeout=30,
        )
        data = r.json()
        if data.get("status") == 1:
            # Returns pipe-delimited: challenge|validate|seccode
            parts = data["request"].split("|")
            return {
                "geetest_challenge": parts[0],
                "geetest_validate": parts[1],
                "geetest_seccode": parts[2],
            }
        time.sleep(5)

    raise TimeoutError("GeeTest v3 solve timed out")

import json

def submit_geetest_v3_solution(
    form_endpoint: str,
    solution: dict,
    other_fields: dict,
) -> requests.Response:
    """Submit form with GeeTest v3 solution."""
    payload = {**other_fields, **solution}
    r = requests.post(form_endpoint, json=payload, timeout=30)
    return r

def solve_geetest_v4(
    api_key: str,
    page_url: str,
    captcha_id: str,
) -> dict:
    """
    Solve GeeTest v4 using CaptchaAI.
    Returns dict with captcha_id, lot_number, pass_token, gen_time, captcha_output.
    """
    payload = {
        "key": api_key,
        "method": "geetest4",
        "captcha_id": captcha_id,
        "pageurl": page_url,
        "json": 1,
    }

    r = requests.post("https://ocr.captchaai.com/in.php", data=payload, timeout=30)
    r.raise_for_status()
    result = r.json()
    if result.get("status") != 1:
        raise RuntimeError(f"Submit failed: {result}")
    task_id = result["request"]

    time.sleep(10)
    for _ in range(30):
        r = requests.get(
            "https://ocr.captchaai.com/res.php",
            params={"key": api_key, "action": "get", "id": task_id, "json": 1},
            timeout=30,
        )
        data = r.json()
        if data.get("status") == 1:
            # v4 returns JSON string
            return json.loads(data["request"])
        time.sleep(5)

    raise TimeoutError("GeeTest v4 solve timed out")