Cloudflare Turnstile
widget- Dove lo vedi
- Un widget all'interno di una pagina o di un modulo
- Cosa restituisce
- Un gettone in
cf-turnstile-response - Pagina CapMonster
- Questa pagina: Cloudflare Turnstile Risolutore
Ultimo aggiornamento:
| CAPTCHA | Prezzo (USD) |
|---|---|
$ 1.30 1000 gettoni |
Un widget Cloudflare Challenge e un widget Turnstile possono avere lo stesso aspetto. Una sfida non è sempre una pagina separata "Solo un momento...": può essere stilizzata, incorporata nel sito o fatta assomigliare a un normale widget Turnstile, in modo che non sia possibile distinguerli dall'apparenza.
cf-turnstile-responsechallenge-form con __cf_chl_f_tk=cf_clearanceLa tabella elenca il prezzo, il tempo necessario per risolvere e la percentuale di successo della risoluzione per quattro servizi di risoluzione Cloudflare Turnstile.
| Parametro | CapMonster Cloud | 2Captcha | Anti-Captcha | DeathByCaptcha |
|---|---|---|---|---|
Prezzo per 1000 soluzioni (da) | $ 1.30 | — | — | — |
È ora di risolvere | 6,24 s* | 16,9 secondi | 20:33 | ~13 secondi |
Tasso di successo della risoluzione | 99%* | 96% | 96% | 96% |
2Captcha, Anti-Captcha e DeathByCaptcha sono marchi dei rispettivi proprietari. CapMonster Cloud non è affiliato con queste entità. I parametri di prestazione e i confronti dei prezzi si basano su dati disponibili al pubblico e benchmark interni a partire dal 30.09.2026.
Testa subito la stabilità sui tuoi siti di destinazione. Non garantiamo una percentuale di successo del 100%: i tipi di CAPTCHA e la configurazione del sito di destinazione possono cambiare in qualsiasi momento.
$0.10
I nuovi utenti ricevono $ 0,10 nel saldo di prova per provare CapMonster Cloud.
1. Registrati al CapMonster Cloud.
2. Invia un messaggio al supporto tramite live chat o support@capmonster.cloud con l'e-mail collegata al tuo account.
Esegui i flussi di registrazione, pagamento e moduli in CI/CD con Playwright, Puppeteer o Selenium sulle pagine di tua proprietà o che sei autorizzato a testare.
Verifica che i moduli e gli endpoint protetti continuino a funzionare dopo i rilasci e le modifiche dei widget.
Raccogli dati disponibili pubblicamente da pagine aperte che utilizzano Cloudflare Turnstile.
Supporta flussi di lavoro assistivi automatizzati su siti che si basano su controlli bot invisible.
Consenti a un agente di richiedere un token tramite MCP quando un flusso di lavoro raggiunge un captcha.
Utilizza CapMonster Cloud per i dati disponibili pubblicamente e sui siti di tua proprietà o che sei autorizzato a testare. È vietato raccogliere dati di terze parti dietro un login o un paywall senza autorizzazione.
Cloudflare Turnstile verifica i visitatori tramite segnali del browser lato client e valutazione del rischio anziché puzzle di immagini. Viene fornito in tre modalità widget: Managed (consigliato), Non-Interactive e Invisible. CapMonster Cloud li gestisce tutti automaticamente: non specifichi mai la modalità nell'attività.
Fonti: Cloudflare documentazione — Tipi di widget · Inizia · Turnstile in Cloudflare sfide
Turnstile sceglie automaticamente tra un segno di spunta non-interactive e una casella di controllo in base al livello di rischio del visitatore. Nessuna immagine o testo da decifrare.
Un widget visibile con uno spinner di caricamento. Il controllo viene eseguito senza alcuna interazione da parte del visitatore.
Il controllo viene eseguito completamente in background: non vengono visualizzati alcun widget e nessun indicatore di caricamento.
La pagina carica il codice iniziale del widget; Cloudflare restituisce il JS richiesto e il widget viene visualizzato.
In base alla modalità del widget e ai segnali di rischio di Cloudflare, il widget decide se mostrare una sfida interattiva.
Il lato client callback riceve un token monouso, valido per 300 secondi. Se il widget si trova all'interno di un <form>, anche il token viene aggiunto automaticamente come campo nascosto cf-turnstile-response.
La pagina invia il token al backend con i dati del modulo.
Il tuo server chiama Siteverify API di Cloudflare per confermare il token.
Fonti: documentazione Cloudflare — Incorpora il widget · Convalida il token
Un token Turnstile è la stringa generata dal widget dopo aver verificato un visitatore. Il widget lo memorizza in un campo modulo nascosto denominato cf-turnstile-response e lo passa anche al callback del widget. Il server del sito invia quindi il token a Siteverify API di Cloudflare per confermarlo.
Proprietà del token, secondo la documentazione di Cloudflare:
Valido per 300 secondi (5 minuti) dopo la generazione.
Monouso: validandolo una seconda volta restituisce l'errore timeout-or-duplicate.
Fino a 2048 caratteri di lunghezza.
Convalidato sul server tramite Siteverify API.
CapMonster Cloud accetta i parametri captcha, li elabora sui suoi server e restituisce un token pronto per l'uso. Inserisci questo token nel modulo per superare il controllo senza l'interazione dell'utente.
A questo punto, invii la chiave API, il tipo captcha e i relativi parametri. Il servizio restituisce un taskId univoco che puoi utilizzare in seguito per ottenere il risultato.
Parametri richiesti
| Parametro | Descrizione |
|---|---|
| tipo | TurnstileTask |
| websiteURL | L'URL della pagina in cui viene risolto il captcha |
| websiteKey | Turnstile chiave del sito. Formato: 0x4AAAAAAABUYP0XeMJF0xoy |
Parametri opzionali
| Parametro | Descrizione |
|---|---|
| userAgent | Navigatore User-Agent. Consigliato: passa il valore corrente supportato da CapMonster Cloud. Puoi ottenere il valore più recente a https://capmonster.cloud/api/useragent/actual |
| pageAction | Il campo azione trovato nella funzione callback quando viene caricato il captcha |
| dati | Il valore del campo dati, preso dal parametro cData |
| proxyType | http — proxy HTTP/HTTPS regolare; https: prova questo se http non funziona (richiesto per alcuni proxy personalizzati); socks4 — proxy SOCKS4; socks5 — Proxy SOCKS5 |
| indirizzoproxy | Indirizzo IP del proxy (IPv4/IPv6). Non sono consentiti proxy trasparenti e proxy su macchine locali |
| proxyPort | Porta proxy |
| proxyLogin | Nome utente proxy |
| proxyPassword | Password proxy |
Lo stesso tipo TurnstileTask viene utilizzato con e senza proxy.
Punto finale:
https://api.capmonster.cloud/createTaskRichiesta:
{
"clientKey": "API_KEY",
"task": {
"type": "TurnstileTask",
"websiteURL": "https://yourwebsite.com/page-with-turnstile",
"websiteKey": "your-website-key"
}
}Risposta:
{
"errorId": 0,
"taskId": 407533072
}Dopo aver creato l'attività, esegui il polling sullo stato della soluzione.
Punto finale:
https://api.capmonster.cloud/getTaskResultRichiesta:
{
"clientKey": "API_KEY",
"taskId": 407533072
}Risposta:
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36",
"token": "0.iGX3xsyFCkbGePM3jP4P4khLo6TrLukt8ZzBvwuQOvbC...f61f3082"
}
}| Proprietà | Digitare | Descrizione |
|---|---|---|
| gettone | Stringa | Utilizza il token in un campo di input o quando chiami una funzione callback. |
Inserisci il token restituito nel campo cf-turnstile-response o passalo al callback del widget, quindi invia il modulo entro cinque minuti: i token Cloudflare scadono dopo 300 secondi e possono essere convalidati una sola volta. Esempi di codici per Playwright, Puppeteer e Selenium si trovano nelle FAQ sotto.
Per creare un'attività Turnstile sono necessari due valori dalla pagina in cui viene eseguito il widget: la chiave del sito (websiteKey) e, se la pagina lo imposta, il nome dell'azione (pageAction).
<div class="cf-turnstile" data-sitekey="SITE_KEY"← websiteKey
data-action="ACTION"></div>← pageActionturnstile.render('#container', {
sitekey: 'SITE_KEY',← websiteKey
action: 'ACTION',← pageAction
callback: function (token) { /* ... */ }
});Apri il sito con il captcha.
Fai clic con il pulsante destro del mouse sull'elemento captcha e scegli Inspect.
Trova la chiave del sito. Nella scheda Elements è l'attributo data-sitekey (websiteKey). Una chiave del sito Turnstile assomiglia a 0x4AAAAAAABUYP0XeMJF0xoy.
Trova l'azione: nella chiamata di rendering del widget (la funzione callback che viene eseguita quando viene caricato il captcha) o nell'attributo data-action. La chiave del sito può essere trovata anche nella funzione callback. Se la pagina non imposta un'azione, lascia fuori il parametro.
Per raccogliere i valori automaticamente, carica la pagina in un browser headless come Playwright e leggili dal widget renderizzato. Esempi pronti in JavaScript, Python e C# si trovano nella documentazione CapMonster Cloud .
Alcuni valori cambiano ogni volta che la pagina viene caricata, quindi risolvi l'attività subito dopo averli raccolti.
createTask e recuperare il risultato con getTaskResult utilizzando le nostre librerie client.Per flussi di lavoro low-code, utilizzare il nodo ufficiale CapMonster Cloud n8n node.
websiteURL e websiteKey dallo stesso rendering della pagina.getTaskResult abbia restituito lo stato ready e di aver preso solution.token prima di inserirlo.Gli errori restituiti da Cloudflare Siteverify (timeout-or-duplicate, invalid-input-secret e altri) riguardano i proprietari dei siti: vedere “Siteverify codici di errore” di seguito.
Se esegui il sito Web protetto da Turnstile: verifica i token e testa la tua configurazione
POST https://challenges.cloudflare.com/turnstile/v0/siteverify
secret=YOUR_SECRET_KEY
response=TOKENSe esegui il sito, il tuo server convalida ogni token Turnstile inviando una richiesta POST a https://challenges.cloudflare.com/turnstile/v0/siteverify. L'endpoint accetta application/x-www-form-urlencoded e JSON e restituisce sempre JSON. Parametri richiesti: secret (la chiave segreta del tuo widget) e response (il token). Facoltativo: remoteip e idempotency_key. Seleziona success e, se li imposti, anche action e hostname nella risposta.
Un token è valido per 300 secondi e può essere convalidato solo una volta. Maggiori informazioni nella guida alla convalida di Cloudflare.
Cloudflare fornisce chiavi sito fittizie e chiavi segrete in modo da poter testare un'implementazione Turnstile senza innescare sfide reali. Testa le chiavi del sito che funzionano su qualsiasi dominio, incluso localhost, e genera il token fittizio XXXX.DUMMY.TOKEN.XXXX. I token fittizi sono accettati solo dalle chiavi segrete fittizie e le chiavi segrete di produzione li rifiutano.
<div class="cf-turnstile"
data-sitekey="1x…AA">
</div>
cf-turnstile-response:
"XXXX.DUMMY.TOKEN.XXXX"Passa sempre
Fallisce sempre
Passa sempre
Fallisce sempre
Forza una sfida interattiva
Supera sempre la convalida
Fallisce sempre la convalida
Restituisce l'errore "token già speso" (timeout-o-duplicato)
Riferimento completo di Cloudflare: Turnstile testing.
Quando la convalida fallisce, Siteverify API di Cloudflare restituisce un array error-codes. La tabella seguente elenca ciascun codice e il suo significato.
{
"success": false,
"error-codes": [
"timeout-or-duplicate"
]
}Il parametro segreto non è stato fornito
La chiave segreta non è valida o è scaduta
Il parametro di risposta (token) non è stato fornito
Il token non è valido, non ha un formato corretto o è scaduto
La richiesta non è valida
Il token è già stato convalidato o è scaduto
Si è verificato un errore interno; riprovare la richiesta
Siteverify può restituire success: true e il tuo server dovrebbe comunque rifiutare il token se hostname o action non corrispondono a ciò che ti aspetti.
Risposte brevi sulla risoluzione di Cloudflare Turnstile con CapMonster Cloud: modalità, proxy, token, test ed errori Siteverify.
Cloudflare Turnstile è un'alternativa CAPTCHA di Cloudflare che verifica i visitatori tramite segnali del browser e valutazione del rischio invece di puzzle di immagini. Ha tre modalità widget. Managed (consigliato): Cloudflare sceglie tra un segno di spunta non-interactive e una casella di controllo in base al rischio visitatore. Non-interactive: un widget visibile con uno spinner di caricamento che non richiede mai interazione. Invisible: nessun widget. CapMonster Cloud gestisce tutti e tre automaticamente, quindi non specifichi la modalità nell'attività.
No. TurnstileTask funziona senza proxy e i campi proxy (proxyType, proxyAddress, proxyPort, proxyLogin, proxyPassword) sono facoltativi. Un proxy che corrisponde alla geografia del sito di destinazione può migliorare i risultati sulle pagine geosensibili, quindi vale la pena testare entrambe le configurazioni. Non sono consentiti proxy trasparenti e proxy su macchine locali. Senza il tuo proxy, CapMonster Cloud risolve il compito tramite i suoi proxy integrati (indirizzo IP 65.21.190.34).
Apri DevTools, trova l'elemento con l'attributo data-sitekey (e data-action, se la pagina imposta un'azione) e copia i valori; una chiave del sito Turnstile assomiglia a 0x4AAAAAAABUYP0XeMJF0xoy. Alcuni valori cambiano ogni volta che la pagina viene caricata, quindi estraili subito prima di creare l'attività. Le istruzioni dettagliate si trovano nella sezione sopra.
cf-turnstile-response è il campo del modulo nascosto che contiene il token Turnstile. Il token è valido per 300 secondi (5 minuti) e può essere convalidato una sola volta; dopodiché Siteverify restituisce l'errore timeout-or-duplicate. Invia subito il token che hai ricevuto da CapMonster Cloud e richiedine uno nuovo per ogni invio.
Per inserire un token Turnstile, trova il campo di risposta nascosto (un input denominato cf-turnstile-response) e impostalo sul token recuperato da CapMonster Cloud. Ecco come farlo nei tre framework di automazione.
Playwright / Puppeteer (Node.js):
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.querySelector('[name="cf-turnstile-response"]').value = t;
}, token);
await page.click('#submit-btn');Selenium (Python):
token = "YOUR_TOKEN"
driver.execute_script("document.querySelector('[name=\"cf-turnstile-response\"]').value = arguments[0];", token)
driver.find_element("id", "submit-btn").click()Se il modulo convalida il token tramite una funzione callback (l'attributo data-callback del widget), chiama invece quella funzione con il token.
Usa le chiavi fittizie di Cloudflare. Sul client, imposta la chiave del sito su 1x00000000000000000000AA (passa sempre), 2x00000000000000000000AB (fallisce sempre) o 3x00000000000000000000FF (forza una sfida interattiva); sul server, utilizzare una chiave segreta fittizia come 1x0000000000000000000000000000000AA. Le chiavi sito fittizie funzionano su qualsiasi dominio, incluso localhost, e producono il token XXXX.DUMMY.TOKEN.XXXX, che solo le chiavi segrete fittizie accettano. L'elenco completo si trova nella sezione test sopra.
Siteverify restituisce success: false quando il token è più vecchio di 300 secondi, è già stato convalidato o la chiave segreta è errata e il tuo server potrebbe anche rifiutarlo se hostname o action restituito non corrisponde a ciò che ti aspetti. Controlla l'array error-codes nella risposta e guarda la tabella dei codici di errore Siteverify. Richiedi un nuovo token per ogni invio e invialo subito dopo averlo ricevuto.
* Non garantiamo una percentuale di successo del 100%: i tipi di CAPTCHA e la configurazione del sito di destinazione possono cambiare in qualsiasi momento. CapMonster Cloud offre un alto tasso di successo per la risoluzione di Cloudflare Turnstile. Basato sul benchmark mensile interno del CapMonster Cloud Team. La velocità effettiva di risoluzione e la percentuale di successo variano a seconda del sito di destinazione, del carico del server e delle condizioni della rete.
Cloudflare e Turnstile sono marchi di Cloudflare, Inc. CapMonster Cloud non è affiliato o approvato da Cloudflare. Il Servizio è destinato ai dati disponibili al pubblico, al test dei siti Web propri o autorizzati, al riconoscimento delle immagini e all'accessibilità. È vietato raccogliere dati di terze parti dietro un login o un paywall senza autorizzazione; i tuoi account non sono interessati. Determina lo stato legale dei tuoi dati prima di iniziare il lavoro.