Cloudflare Turnstile
widget- donde lo ves
- Un widget dentro de una página o formulario
- lo que devuelve
- Una ficha en
cf-turnstile-response - Página de CapMonster
- Esta página: Cloudflare Turnstile Solver
Última actualización:
| CAPTCHA | Precio (USD) |
|---|---|
$ 1.30 1000 tokens |
Un widget Cloudflare Challenge y un Turnstile pueden tener el mismo aspecto. Un Desafío no siempre es una página separada “Solo un momento…”: se le puede diseñar, incrustar en el sitio o hacer que parezca un widget Turnstile normal, por lo que no se pueden distinguir por su apariencia.
cf-turnstile-responsechallenge-form con __cf_chl_f_tk=cf_clearanceLa tabla enumera el precio, el tiempo de resolución y la tasa de éxito de resolución de cuatro servicios de resolución Cloudflare Turnstile.
| Parámetro | CapMonster Cloud | 2Captcha | Anti-Captcha | DeathByCaptcha |
|---|---|---|---|---|
Precio por 1000 soluciones (desde) | $ 1.30 | $1.45 | $2.00 | $2.89 |
hora de resolver | 6.24s* | 16,9 segundos | 20,33 segundos | ~13 segundos |
Tasa de éxito en la resolución | 99%* | 96% | 96% | 96% |
2Captcha, Anti-Captcha y DeathByCaptcha son marcas comerciales de sus respectivos propietarios. CapMonster Cloud no está afiliado a estas entidades. Las métricas de rendimiento y las comparaciones de precios se basan en datos disponibles públicamente y en evaluaciones comparativas internas a partir de 02.10.2026.
Pruebe la estabilidad en sus propios sitios de destino ahora mismo. No garantizamos una tasa de éxito del 100%: los tipos de CAPTCHA y la configuración del sitio de destino pueden cambiar en cualquier momento.
$0.10
Los nuevos usuarios obtienen $0,10 en saldo de prueba para probar CapMonster Cloud.
1. Regístrese en CapMonster Cloud.
2. Envíe mensajes de soporte a través del chat en vivo o support@capmonster.cloud con el correo electrónico vinculado a su cuenta.
Ejecute flujos de registro, pago y formulario en CI/CD con Playwright, Puppeteer o Selenium en páginas que posee o que puede probar.
Compruebe que los formularios y puntos finales protegidos sigan funcionando después de los lanzamientos y los cambios en los widgets.
Recopile datos disponibles públicamente de páginas abiertas que utilizan Cloudflare Turnstile.
Admite flujos de trabajo de asistencia automatizados en sitios que dependen de invisible comprobaciones de bots.
Deje que un agente solicite un token a través de MCP cuando un flujo de trabajo alcance un captcha.
Utilice CapMonster Cloud para datos disponibles públicamente y en sitios de su propiedad o que esté autorizado a realizar pruebas. Está prohibido recopilar datos de terceros detrás de un inicio de sesión o un muro de pago sin permiso.
Cloudflare Turnstile verifica a los visitantes a través de señales del navegador del lado del cliente y evaluación de riesgos en lugar de acertijos de imágenes. Se envía en tres modos de widget: Managed (recomendado), Non-Interactive y Invisible. CapMonster Cloud los maneja todos automáticamente; nunca especificas el modo en la tarea.
Fuentes: Cloudflare documentación — Tipos de widgets · Comenzar · Turnstile en Cloudflare desafíos
Turnstile elige automáticamente entre una marca non-interactive y una casilla de verificación según el nivel de riesgo del visitante. No hay imágenes ni texto para descifrar.
Un widget visible con un control giratorio de carga. La verificación se ejecuta sin ninguna interacción del visitante.
La verificación se ejecuta completamente en segundo plano: no se muestra ningún widget ni indicador de carga.
La página carga el código de inicio del widget; Cloudflare devuelve el JS requerido y el widget se representa.
Según el modo del widget y las señales de riesgo de Cloudflare, el widget decide si muestra un desafío interactivo.
El lado del cliente callback recibe un token de un solo uso, válido por 300 segundos. Si el widget está dentro de <form>, el token también se agrega automáticamente como campo oculto cf-turnstile-response.
La página envía el token al backend con los datos del formulario.
Su servidor llama al Siteverify API de Cloudflare para confirmar el token.
Fuentes: Cloudflare documentación — Incrustar el widget · Validar el token
Un token Turnstile es la cadena que genera el widget después de verificar a un visitante. El widget lo almacena en un campo de formulario oculto llamado cf-turnstile-response y también lo pasa al callback del widget. Luego, el servidor del sitio envía el token a Cloudflare Siteverify API para confirmarlo.
Propiedades del token, según la documentación de Cloudflare:
Válido por 300 segundos (5 minutos) después de la generación.
De un solo uso: validarlo por segunda vez devuelve el error timeout-or-duplicate.
Hasta 2048 caracteres de longitud.
Validado en el servidor mediante el Siteverify API.
CapMonster Cloud acepta parámetros captcha, los procesa en sus servidores y devuelve un token listo para usar. Inserte este token en el formulario para pasar la verificación sin interacción del usuario.
En esta etapa, envía su clave API, el tipo de captcha y sus parámetros. El servicio devuelve un taskId único que puedes utilizar más adelante para obtener el resultado.
Parámetros requeridos
| Parámetro | Descripción |
|---|---|
| tipo | TurnstileTask |
| websiteURL | La URL de la página donde se resuelve el captcha. |
| websiteKey | Turnstile clave del sitio. Formato: 0x4AAAAAAABUYP0XeMJF0xoy |
Parámetros opcionales
| Parámetro | Descripción |
|---|---|
| userAgent | Navegador User-Agent. Recomendado: pase el valor actual soportado por CapMonster Cloud. Puede obtener el valor más reciente en https://capmonster.cloud/api/useragent/actual |
| pageAction | El campo de acción que se encuentra en la función callback cuando se carga el captcha |
| datos | El valor del campo de datos, tomado del parámetro cData |
| tipo de proxy | http — proxy HTTP/HTTPS normal; https: prueba esto si http no funciona (obligatorio para algunos servidores proxy personalizados); socks4 — Proxy SOCKS4; socks5 — Proxy SOCKS5 |
| dirección proxy | Dirección IP del proxy (IPv4/IPv6). No se permiten proxies transparentes ni proxies en máquinas locales. |
| puerto proxy | Puerto proxy |
| proxyIniciar sesión | Nombre de usuario proxy |
| proxyContraseña | Contraseña de proxy |
Se utiliza el mismo tipo TurnstileTask con y sin proxy.
Punto final:
https://api.capmonster.cloud/createTaskSolicitud:
{
"clientKey": "API_KEY",
"task": {
"type": "TurnstileTask",
"websiteURL": "https://yourwebsite.com/page-with-turnstile",
"websiteKey": "your-website-key"
}
}Respuesta:
{
"errorId": 0,
"taskId": 407533072
}Después de crear la tarea, sondee el estado de la solución.
Punto final:
https://api.capmonster.cloud/getTaskResultSolicitud:
{
"clientKey": "API_KEY",
"taskId": 407533072
}Respuesta:
{
"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"
}
}| Propiedad | Tipo | Descripción |
|---|---|---|
| ficha | cuerda | Utilice el token en un campo de entrada o cuando llame a una función callback. |
Inserte el token devuelto en el campo cf-turnstile-response o páselo al callback del widget, luego envíe el formulario dentro de cinco minutos: los tokens Cloudflare caducan después de 300 segundos y solo se pueden validar una vez. Los ejemplos de código para Playwright, Puppeteer y Selenium se encuentran en las Preguntas frecuentes a continuación.
Para crear una tarea Turnstile necesita dos valores de la página donde se ejecuta el widget: la clave del sitio (websiteKey) y, si la página lo establece, el nombre de la acción (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) { /* ... */ }
});Abra el sitio con el captcha.
Haga clic derecho en el elemento captcha y elija Inspect.
Busque la clave del sitio. En la pestaña Elements está el atributo data-sitekey (websiteKey). Una clave de sitio Turnstile se parece a 0x4AAAAAAABUYP0XeMJF0xoy.
Busque la acción: en la llamada de renderizado del widget (la función callback que se ejecuta cuando se carga el captcha) o en el atributo data-action. La clave del sitio también se puede encontrar en esa función callback. Si la página no establece una acción, omita el parámetro.
Para recopilar los valores automáticamente, cargue la página en un navegador sin cabeza como Playwright y léalos desde el widget renderizado. Los ejemplos listos en JavaScript, Python y C# se encuentran en la CapMonster Cloud documentación.
Algunos valores cambian cada vez que se carga la página, así que resuelva la tarea inmediatamente después de recopilarlos.
createTask y recuperar el resultado con getTaskResult utilizando nuestras bibliotecas cliente.Para flujos de trabajo con poco código, utilice el nodo oficial CapMonster Cloud n8n.
websiteURL y websiteKey del mismo renderizado de la página.getTaskResult devolvió el estado ready y que tomaste solution.token antes de insertarlo.Los errores devueltos por Cloudflare Siteverify (timeout-or-duplicate, invalid-input-secret y otros) afectan a los propietarios de sitios; consulte “Siteverify códigos de error” a continuación.
Si ejecuta el sitio web protegido por Turnstile: verifique los tokens y pruebe su configuración
POST https://challenges.cloudflare.com/turnstile/v0/siteverify
secret=YOUR_SECRET_KEY
response=TOKENSi ejecuta el sitio, su servidor valida cada token Turnstile enviando una solicitud POST a https://challenges.cloudflare.com/turnstile/v0/siteverify. El punto final acepta application/x-www-form-urlencoded y JSON y siempre devuelve JSON. Parámetros requeridos: secret (la clave secreta de su widget) y response (el token). Opcional: remoteip y idempotency_key. Marque success y, si los configura, también action y hostname en la respuesta.
Un token es válido durante 300 segundos y solo puede validarse una vez. Lea más en la guía de validación de Cloudflare.
Cloudflare proporciona claves de sitio ficticias y claves secretas para que pueda probar una implementación de Turnstile sin desencadenar desafíos reales. Las claves de sitio de prueba funcionan en cualquier dominio, incluido localhost, y generan el token ficticio XXXX.DUMMY.TOKEN.XXXX. Los tokens ficticios sólo se aceptan mediante claves secretas ficticias y las claves secretas de producción los rechazan.
<div class="cf-turnstile"
data-sitekey="1x…AA">
</div>
cf-turnstile-response:
"XXXX.DUMMY.TOKEN.XXXX"siempre pasa
Siempre falla
siempre pasa
Siempre falla
Fuerza un desafío interactivo
Siempre pasa la validación
Siempre falla la validación
Devuelve el error "token ya gastado" (tiempo de espera o duplicado)
Referencia completa de Cloudflare: Turnstile testing.
Cuando la validación falla, Siteverify API de Cloudflare devuelve una matriz error-codes. La siguiente tabla enumera cada código y lo que significa.
{
"success": false,
"error-codes": [
"timeout-or-duplicate"
]
}No se proporcionó el parámetro secreto.
La clave secreta no es válida o ha caducado
No se proporcionó el parámetro de respuesta (token)
El token no es válido, está mal formado o ha caducado
La solicitud está mal formada.
El token ya ha sido validado o ha caducado
Se produjo un error interno; reintentar la solicitud
Siteverify puede devolver success: true y su servidor aún debería rechazar el token si hostname o action no coinciden con lo que espera.
Respuestas breves sobre cómo resolver Cloudflare Turnstile con CapMonster Cloud: modos, proxies, tokens, pruebas y errores de Siteverify.
Cloudflare Turnstile es una alternativa CAPTCHA de Cloudflare que verifica a los visitantes a través de señales del navegador y evaluación de riesgos en lugar de acertijos de imágenes. Tiene tres modos de widget. Managed (recomendado): Cloudflare elige entre una marca non-interactive y una casilla de verificación según el riesgo del visitante. Non-interactive: un widget visible con un control giratorio de carga que nunca requiere interacción. Invisible: ningún widget. CapMonster Cloud maneja los tres automáticamente, por lo que no especifica el modo en la tarea.
No. TurnstileTask funciona sin proxy y los campos de proxy (proxyType, proxyAddress, proxyPort, proxyLogin, proxyPassword) son opcionales. Un proxy que coincida con la geografía del sitio de destino puede mejorar los resultados en páginas geográficamente sensibles, por lo que vale la pena probar ambas configuraciones. No se permiten proxies transparentes ni proxies en máquinas locales. Sin su propio proxy, CapMonster Cloud resuelve la tarea a través de sus servidores proxy integrados (dirección IP 65.21.190.34).
Abra DevTools, busque el elemento con el atributo data-sitekey (y data-action, si la página establece una acción) y copie los valores; una clave de sitio Turnstile se parece a 0x4AAAAAAABUYP0XeMJF0xoy. Algunos valores cambian cada vez que se carga la página, así que extráigalos justo antes de crear la tarea. Las instrucciones paso a paso se encuentran en la sección anterior.
cf-turnstile-response es el campo de formulario oculto que contiene el token Turnstile. El token es válido por 300 segundos (5 minutos) y sólo puede validarse una vez; después de eso Siteverify devuelve el error timeout-or-duplicate. Envíe el token que recibió de CapMonster Cloud de inmediato y solicite uno nuevo para cada envío.
Para insertar un token Turnstile, busque el campo de respuesta oculto (una entrada llamada cf-turnstile-response) y configúrelo en el token recuperado de CapMonster Cloud. A continuación se explica cómo hacerlo en los tres marcos de automatización.
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()Si el formulario valida el token a través de una función callback (el atributo data-callback del widget), llame a esa función con el token.
Utilice las claves ficticias de Cloudflare. En el cliente, configure la clave del sitio en 1x00000000000000000000AA (siempre pasa), 2x00000000000000000000AB (siempre falla) o 3x00000000000000000000FF (fuerza un desafío interactivo); en el servidor, utilice una clave secreta ficticia como 1x0000000000000000000000000000000AA. Las claves de sitio ficticias funcionan en cualquier dominio, incluido localhost, y producen el token XXXX.DUMMY.TOKEN.XXXX, que solo aceptan claves secretas ficticias. La lista completa se encuentra en la sección de prueba anterior.
Siteverify devuelve success: false cuando el token tiene más de 300 segundos, ya ha sido validado o la clave secreta es incorrecta, y su servidor también puede rechazarlo si el hostname o action devuelto no coincide con lo que espera. Verifique la matriz error-codes en la respuesta y vea la tabla de códigos de error Siteverify. Solicite un nuevo token por cada envío y envíelo inmediatamente después de recibirlo.
* No garantizamos una tasa de éxito del 100 %: los tipos de CAPTCHA y la configuración del sitio de destino pueden cambiar en cualquier momento. CapMonster Cloud ofrece una alta tasa de éxito para resolver Cloudflare Turnstile. Basado en la evaluación comparativa mensual interna del equipo CapMonster Cloud. La velocidad de resolución real y la tasa de éxito varían según el sitio de destino, la carga del servidor y las condiciones de la red.
Cloudflare y Turnstile son marcas comerciales de Cloudflare, Inc. CapMonster Cloud no está afiliada ni respaldada por Cloudflare. El Servicio está destinado a datos disponibles públicamente, pruebas de sitios web propios o autorizados, reconocimiento de imágenes y accesibilidad. Está prohibido recopilar datos de terceros detrás de un inicio de sesión o un muro de pago sin permiso; sus propias cuentas no se ven afectadas. Usted determina la situación jurídica de sus datos antes de comenzar a trabajar.