ERROR_WRONG_GOOGLEKEY : Guide complet de diagnostic et de réparation

ERROR_WRONG_GOOGLEKEY signifie que le paramètre googlekey n'est pas valide ou ne correspond pas à la page cible. Ce guide couvre toutes les causes et solutions.

Quelles sont les causes de cette erreur

Comment trouver la bonne clé de site

Méthode 1 : recherche de source de page

import re
import requests


def extract_sitekey(page_url):
    """Extract reCAPTCHA sitekey from page source."""
    resp = requests.get(page_url, timeout=15)
    html = resp.text

    # Pattern 1: data-sitekey attribute
    match = re.search(r'data-sitekey="([^"]+)"', html)
    if match:
        return match.group(1)

    # Pattern 2: grecaptcha.render call
    match = re.search(r"grecaptcha\.render\([^,]+,\s*\{[^}]*sitekey['\"]?\s*:\s*['\"]([^'\"]+)", html)
    if match:
        return match.group(1)

    # Pattern 3: grecaptcha.execute call
    match = re.search(r"grecaptcha\.execute\(['\"]([^'\"]+)", html)
    if match:
        return match.group(1)

    # Pattern 4: reCAPTCHA script src
    match = re.search(r"recaptcha/api\.js\?render=([^&\"]+)", html)
    if match:
        return match.group(1)

    return None


sitekey = extract_sitekey("https://example.com/login")
print(f"Sitekey: {sitekey}")

Méthode 2 : outils de développement du navigateur

1. Ouvrir la page cible dans Chrome
2. Appuyez sur l'onglet F12 → Éléments.
3. Appuyez sur Ctrl+F et recherchez sitekey.
4. Rechercher l'attribut data-sitekey="..."
5. Copiez la valeur (chaîne alphanumérique de 40 caractères)

Méthode 3 : onglet Réseau

1. Ouvrez l'onglet F12 → Réseau.
2. Filtrer par recaptcha
3. Rechercher des demandes à google.com/recaptcha/api2/anchor
4. Recherchez le paramètre k= dans l'URL — c'est la clé du site

Validation avant soumission

import re


def validate_sitekey(sitekey):
    """Validate sitekey format before API call."""
    if not sitekey:
        raise ValueError("Sitekey is empty")

    # Standard format: 40 alphanumeric + hyphens/underscores
    if not re.match(r'^[a-zA-Z0-9_-]{20,60}$', sitekey):
        raise ValueError(f"Invalid sitekey format: {sitekey}")

    return True


# Use before solving
sitekey = extract_sitekey("https://example.com/login")
validate_sitekey(sitekey)

Gestion de reCAPTCHA Entreprise

Les clés de site d'entreprise se ressemblent mais nécessitent le paramètre enterprise :

import requests

# Standard reCAPTCHA — loads via recaptcha/api.js
# Enterprise reCAPTCHA — loads via recaptcha/enterprise.js

def detect_enterprise(page_url):
    """Detect if page uses reCAPTCHA Enterprise."""
    resp = requests.get(page_url, timeout=15)
    return "recaptcha/enterprise.js" in resp.text


# Submit with enterprise flag
is_enterprise = detect_enterprise("https://example.com")

data = {
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": sitekey,
    "pageurl": "https://example.com",
    "json": 1,
}

if is_enterprise:
    data["enterprise"] = 1

resp = requests.post("https://ocr.captchaai.com/in.php", data=data)

Gestion du reCAPTCHA invisible

def detect_invisible(html):
    """Detect invisible reCAPTCHA."""
    indicators = [
        'data-size="invisible"',
        "grecaptcha.execute(",
        "recaptcha/api.js?render=",
    ]
    return any(i in html for i in indicators)


# Submit with invisible flag
data = {
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": sitekey,
    "pageurl": "https://example.com",
    "invisible": 1,
    "json": 1,
}

Extraction dynamique de clé de site

Certains sites chargent les clés de site via JavaScript. Utilisez un navigateur pour les extraire :

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


def extract_dynamic_sitekey(url):
    """Extract sitekey from JavaScript-rendered page."""
    driver = webdriver.Chrome()
    driver.get(url)

    # Wait for reCAPTCHA to load
    import time
    time.sleep(3)

    # Try data-sitekey attribute
    elements = driver.find_elements(By.CSS_SELECTOR, "[data-sitekey]")
    if elements:
        sitekey = elements[0].get_attribute("data-sitekey")
        driver.quit()
        return sitekey

    # Try iframe src parameter
    iframes = driver.find_elements(By.CSS_SELECTOR, "iframe[src*='recaptcha']")
    for iframe in iframes:
        src = iframe.get_attribute("src")
        import re
        match = re.search(r'[?&]k=([^&]+)', src)
        if match:
            driver.quit()
            return match.group(1)

    driver.quit()
    return None

Dépannage

FAQ

À quoi ressemble une clé de site valide ?

Une clé de site reCAPTCHA comprend généralement 40 caractères alphanumériques plus des tirets. Exemple : 6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-.

La même clé de site peut-elle fonctionner pour la version 2 et la version 3 ?

Les versions 2 et 3 utilisent des clés de site différentes. Vérifiez la source du script reCAPTCHA pour déterminer la version.

Dois-je mettre en cache la clé du site ?

Cache pour de courtes périodes (minutes à heures). Certains sites effectuent une rotation des clés. Si la résolution échoue, ré-extrayez la clé de site.

Guides connexes

• BAD_PARAMETERS Validation de la demande
• Arbre de décision de gestion des erreurs API

Obtenez la bonne clé de site –résoudre avec CaptchaAI.