Pagamento per risoluzione · API
1. Script nascosto
Uno script caricato con la chiave del sito viene eseguito in background su ogni pagina che lo usa. Il visitatore non vede alcuna casella e non deve fare nulla.
Uno script caricato con la chiave del sito viene eseguito in background su ogni pagina che lo usa. Il visitatore non vede alcuna casella e non deve fare nulla.
In base ai dati comportamentali raccolti, Google assegna al visitatore un punteggio che indica quanto è probabile che sia un essere umano. Il proprietario del sito sceglie la soglia.
Il sito confronta il punteggio con la propria soglia. Se è inferiore, il sito può chiedere una verifica aggiuntiva o bloccare la richiesta.
grecaptcha.execute per un’azione.success sia true, che lo score rispetti la soglia e che l’action corrisponda. Un token valido con score basso può comunque essere rifiutato.I punteggi reCAPTCHA v3 vanno da 0.0 (probabile bot) a 1.0 (probabile umano). Google suggerisce una soglia di 0.5. Osservate il traffico reale prima di applicarla o regolarla.
Google supporta 11 livelli di punteggio. Essentials gratuito restituisce 0.1, 0.3, 0.7 e 0.9; con la fatturazione si sbloccano tutti i livelli e i reason code. I punteggi in staging e nella prima settimana possono differire dalla produzione.
Il parametro CapMonster Cloud minScore (0.1–0.9) imposta il punteggio minimo del token. Allineatelo alla soglia del sito; valori alti come 0.9 aumentano i tentativi falliti.
pageAction deve corrispondere all’action in grecaptcha.execute. Usate solo lettere, cifre, slash e underscore. I siti possono rifiutare le discrepanze. Passate sia minScore sia pageAction.
Un test del punteggio richiede un backend: lo score arriva nella risposta siteverify.
1. Su una pagina di test, usate la site key e chiamate grecaptcha.execute con un’action.
2. Inviate token e chiave segreta dal backend a https://www.google.com/recaptcha/api/siteverify.
3. Confrontate lo score restituito con la soglia e verificate l’action.
Provare la nostra pagina demo reCAPTCHA v3 senza creare una pagina di test.
La tabella elenca prezzo, tempo di risposta API e tasso di successo di quattro servizi di risoluzione reCAPTCHA v3.
| Parametro | CapMonster Cloud | 2Captcha | CapSolver | DeathByCaptcha |
|---|---|---|---|---|
Prezzo per 1000 soluzioni (da) | $ 0.90 | $1.45 | $1.00 | $2.89 |
Tempo di risposta API | ≤ 2 s | ≤ 2 s | < 3 s | ≤ 3 s |
Tasso di successo | fino al 99% | ~77–92% | ~95–98% | ~64–90% |
Disclaimer: 2Captcha, CapSolver e DeathByCaptcha sono marchi dei rispettivi proprietari. CapMonster Cloud non è affiliato a queste entità. Le metriche di prestazioni e il confronto dei prezzi si basano su dati pubblici e benchmark interni del 27.09.2026.
$0.10
I nuovi utenti ricevono $0.10 di saldo di prova per provare CapMonster Cloud.
1. Registrati su CapMonster Cloud.
2. Scrivi al supporto tramite live chat o a support@capmonster.cloud indicando l’email del tuo account.
CapMonster Cloud accetta i parametri del captcha, li elabora sui propri server e restituisce un token pronto all’uso. Inserite questo token nel form per superare il controllo senza interazione dell’utente. L’attività RecaptchaV3TaskProxyless viene eseguita sui server proxy di CapMonster Cloud, quindi non passate parametri proxy.
In questa fase invii la tua chiave API, il tipo di captcha e i relativi parametri. Il servizio restituisce un taskId univoco con cui potrai ottenere il risultato in seguito.
Nella richiesta per risolvere reCAPTCHA v3 è necessario specificare i seguenti parametri:
| Parametro | Descrizione |
|---|---|
typestringObbligatorio | RecaptchaV3TaskProxyless |
websiteURLstringObbligatorio | l’indirizzo della pagina in cui viene risolto il captcha |
websiteKeystringObbligatorio | l’identificatore della chiave (sitekey) indicato sulla pagina del tuo sito con il captcha https://www.google.com/recaptcha/api.js?render=SITE_KEY6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob |
isEnterprisebooleanFacoltativo | Per reCAPTCHA v3 Enterprise impostate isEnterprise: true in RecaptchaV3TaskProxyless (true/false o 1/0). CapMonster Cloud lo elabora come RecaptchaV3EnterpriseTask. |
minScoredoubleFacoltativo | può avere un valore da 0.1 a 0.9 |
pageActionstringFacoltativo | il valore del parametro action che viene passato dal widget ReCaptcha in Google. Valore predefinito: verify grecaptcha.execute('site_key', {action: 'login_test'}) |
https://api.capmonster.cloud/createTask{
"clientKey": "API_KEY",
"task": {
"type": "RecaptchaV3TaskProxyless",
"websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
"websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
"minScore": 0.3,
"pageAction": "myverify"
}
}
{
"errorId":0,
"taskId":407533072
}
https://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
}
}
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
"gRecaptchaResponse": "0cAFcWeA5Y3...hF8UWA",
"cookies": {
"nocookies": "true"
}
}
}userAgent. Usa questo UserAgent quando invii il token o confermi la soluzione, anche se differisce da quello del browser o dello script.userAgent. Usa questo UserAgent quando invii il token o confermi la soluzione, anche se differisce da quello del browser o dello script.Un’attività reCAPTCHA v3 richiede la chiave del sito (websiteKey) e il nome dell’azione (pageAction).
1. Fate clic destro sulla pagina e selezionate Inspect.
2. In Elements o Network, trovate api.js?render=SITE_KEY. Il valore dopo render= è websiteKey. reCAPTCHA Enterprise usa enterprise.js?render=SITE_KEY.
3. Trovate grecaptcha.execute('SITE_KEY', {action: 'ACTION'}). ACTION è pageAction. Enterprise usa grecaptcha.enterprise.execute. Se omesso, l’attività usa verify di default.
4. Intercettate grecaptcha.execute in un browser headless come Playwright per raccogliere entrambi i valori. Esempi in JavaScript, Python e C# nella documentazione CapMonster Cloud.
import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV3ProxylessRequest
client_options = ClientOptions(api_key="YOUR_API_KEY") # Specifica la tua chiave API di CapMonster Cloud
cap_monster_client = CapMonsterClient(options=client_options)
# Se necessario puoi controllare il saldo
balance = asyncio.run(cap_monster_client.get_balance())
print("Balance:", balance)
recaptcha_v3_request = RecaptchaV3ProxylessRequest(
websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta", # URL della tua pagina con la captcha
websiteKey="6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob", # Sostituisci con un valore corretto
minScore=0.7, # Soglia minima del punteggio di attendibilità
pageAction="myverify" # Azione sulla pagina
)
async def solve_captcha():
return await cap_monster_client.solve_captcha(recaptcha_v3_request)
responses = asyncio.run(solve_captcha())
print(responses)Eseguite flussi di registrazione, checkout e form in CI/CD con Playwright, Puppeteer o Selenium su pagine di vostra proprietà o autorizzate ai test.
Verificate che form ed endpoint protetti continuino a funzionare dopo release e cambi di soglia.
Raccogliete dati pubblici da pagine aperte con controlli basati sullo score.
Supportate workflow assistivi automatizzati su siti con controlli anti-bot invisibili.
Un agente può richiedere un token tramite MCP quando il flusso arriva a un captcha.
Usate CapMonster Cloud per dati pubblici e su siti di vostra proprietà o autorizzati. Raccogliere dati di terzi dietro login o paywall senza permesso è vietato.
reCAPTCHA Enterprise usa controlli basati sullo score: Essentials restituisce quattro livelli.
Premium ed Enterprise ne restituiscono 11, con ragioni di explainability di base e avanzate.
Per reCAPTCHA v3 Enterprise impostate isEnterprise: true in RecaptchaV3TaskProxyless (true/false o 1/0). CapMonster Cloud lo elabora come RecaptchaV3EnterpriseTask.
POST https://www.google.com/recaptcha/api/siteverify secret=YOUR_SECRET_KEY response=TOKEN
Sul vostro sito, inviate secret e response a https://www.google.com/recaptcha/api/siteverify. I token scadono in 2 minuti e funzionano una sola volta. Controllate success, score e action; Google suggerisce una soglia di 0.5.
Vedete Captcha API (Google reCAPTCHA v3) per esempi Node.js e Python, gestione errori e azioni basate sullo score.
Python SDK
secretSecret keymissing-input-secretManca il parametro secret
secretSecret keyinvalid-input-secretIl parametro secret non è valido o è malformato
responseTokenmissing-input-responseManca il token
responseTokeninvalid-input-responseIl token non è valido o è malformato
requestRequestbad-requestLa richiesta non è valida o è malformata
responseDurata del tokentimeout-or-duplicateIl token è troppo vecchio o è già stato usato
reCAPTCHA v2reCAPTCHA v3· attualereCAPTCHA v2 EnterprisereCAPTCHA v3 Enterprise
GeeTest
Cloudflare TurnstileCloudflare Bot Challenge
DataDome
Tencent CAPTCHA
Amazon Waf
Faucet Pay
Imperva (Incapsula)
Prosopo
Text CAPTCHA
BinanceComplexImageTask Recaptcha
ComplexImageTask RecognitionreCAPTCHA Enterprise (Spotify, Yahoo)
Yidun
MTCaptcha
Altcha
Funcaptcha
TSPD
Hunt
Alibaba
Friendly
Documentazione di reCAPTCHA v3 (EN) →Documentazione di reCAPTCHA v3 Enterprise (EN) →Come risolvere ReCaptcha v3 in Python con Selenium & CapMonster Cloud (EN) →Come risolvere ReCaptcha v3 in JavaScript con Selenium & CapMonster Cloud (EN) →Come risolvere ReCaptcha v3 in C# con Selenium & CapMonster Cloud (EN) →Captcha API (Google reCAPTCHA v3): documentazione e guida all’integrazione per sviluppatori (EN) →Il parametro minScore accetta valori da 0.1 a 0.9 e indica a CapMonster Cloud il punteggio di fiducia minimo che il token restituito deve avere. 0.3 è un punto di partenza ragionevole. Un valore troppo alto (es. 0.9) aumenta la probabilità di errori di risoluzione; uno troppo basso può restituire token con un punteggio che la soglia lato server rifiuterebbe comunque. Regolate il valore in base ai tassi di rifiuto reali nel vostro ambiente di test.
Apra la pagina e cerchi api.js?render=SITE_KEY negli strumenti di ispezione. Il valore dopo render= è il sitekey. L’action è indicata in grecaptcha.execute(siteKey, {action: "..."}). Può acquisire automaticamente la chiamata con Playwright. Alcuni valori cambiano a ogni caricamento: crei l’attività subito dopo averli raccolti. Consulti la procedura completa.
1.0 indica un’interazione molto probabilmente legittima e 0.0 un probabile bot. Google suggerisce 0.5 come soglia predefinita. Il punteggio adeguato dipende dalla soglia del sito. Imposti minScore di conseguenza e lo adatti al traffico reale. Come verificare il punteggio.
Un token ricevuto da reCAPTCHA v3 è valido per circa 2 minuti. La vostra pipeline di automazione deve inviare il token al server entro questa finestra; dopo la scadenza, l'endpoint siteverify di Google restituisce success: false. Eseguite il passo di risoluzione il più vicino possibile all'invio del modulo ed evitate di memorizzare in cache i token tra le richieste.
Ogni token può essere verificato una sola volta. Un token scaduto o già utilizzato causa timeout-or-duplicate. Richieda un nuovo token per ogni invio.
Per iniettare un token reCAPTCHA v3, trovate il campo di risposta nascosto (di solito un textarea o input con ID g-recaptcha-response) e inserite il token ottenuto dal servizio di risoluzione CAPTCHA. Ecco come farlo nei tre framework di automazione.
Playwright / Puppeteer (Node.js)
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.getElementById('g-recaptcha-response').value = t;
}, token);
await page.click('#submit-btn');Selenium (Python)
token = "YOUR_TOKEN"
driver.execute_script(f"document.getElementById('g-recaptcha-response').value = '{token}';")
driver.find_element("id", "submit-btn").click()Alcuni siti usano funzioni callback per validare il token. Se il modulo non viene inviato, trovate il nome della funzione tramite la console (___grecaptcha_cfg.clients) e chiamatela manualmente:
await page.evaluate((t) => {
window.onSuccessCallback(t);
}, token);Una risposta success: true da Google significa solo che il token è valido. Il vostro backend può comunque rifiutare la richiesta se il punteggio del token è inferiore alla soglia configurata.
Un altro problema comune è una mancata corrispondenza dell'action. Il token deve essere verificato con lo stesso valore action usato durante la creazione dell'attività.
Per diagnosticare il problema:
Se success è true, l'array error-codes è di solito vuoto, quindi score e action sono i campi principali da ispezionare.
Sì. Aggiunga isEnterprise: true all’attività reCAPTCHA v3 (valori accettati: true/false o 1/0). Viene elaborata come RecaptchaV3EnterpriseTask. Consulti la sezione precedente e la documentazione API.
Nessuno strumento può garantire un tasso di successo del 100% contro protezioni in evoluzione, ma CapMonster Cloud offre un alto tasso di successo per reCAPTCHA v3. I dati si basano sui test comparativi interni mensili del team CapMonster Cloud. Il tempo di risposta API e il tasso di successo effettivi variano in base al sito di destinazione, al carico del server e alle condizioni di rete.
reCAPTCHA è un marchio di Google LLC. CapMonster Cloud non è affiliato a Google né approvato da Google. Il servizio è destinato a dati pubblicamente disponibili, test su siti propri o autorizzati, riconoscimento di immagini e accessibilità. È vietato raccogliere senza autorizzazione dati di terzi protetti da accesso o pagamento; i propri account non sono interessati. L’utente determina lo stato giuridico dei propri dati prima di iniziare.