logo
bars
Pago por resolución · API

Resolver reCAPTCHA v3

CapMonster Cloud es un servicio de resolución automática de reCAPTCHA v3 mediante API. Especifica la puntuación mínima (minScore), recibe un token listo para usar y continúa tu automatización sin acciones manuales.
Pruébalo gratis: saldo de prueba de $0.10 ↓
Tiempo de respuesta de la API
≤ 2 s
Tasa de éxito
hasta 99%
por 1000 tokens
$ 0.90

Precios del servicio para resolver reCAPTCHA v3

CAPTCHA
Precio (USD)
$ 0.90
1000 tokens

Qué es Google reCAPTCHA v3

reCAPTCHA v3 es una protección invisible de Google que distingue a los usuarios reales de los bots sin necesidad de marcar la casilla “No soy un robot”. En la página se ejecuta un script oculto que analiza el comportamiento del visitante y devuelve una puntuación de confianza (score) de 0,0 a 1,0. El desarrollador define un umbral por debajo del cual se puede exigir una verificación adicional o incluso un bloqueo, proporcionando seguridad sin acciones extra por parte del usuario.

1. Script oculto

Un script cargado con la clave del sitio se ejecuta en segundo plano en cada página que lo usa. El visitante no ve ninguna casilla y no realiza ninguna acción.

2. Puntuación de confianza

Según los datos de comportamiento recogidos, Google asigna al visitante una puntuación que indica qué tan probable es que sea humano. El propietario del sitio elige el umbral.

3. Umbral del servidor

El sitio compara la puntuación con su propio umbral. Por debajo de él, el sitio puede pedir una verificación adicional o bloquear la solicitud.

Flujo de verificación de reCAPTCHA v3

Paso 1. Carga del script
La página carga el script de reCAPTCHA v3 con la clave del sitio y llama a grecaptcha.execute para una acción.
Paso 2. Token emitido
Google devuelve un token para esa acción.
Paso 3. Token al backend
La página envía el token al servidor con los datos del formulario. El token es válido durante unos 2 minutos.
Paso 4. Siteverify
El servidor envía la clave secreta y el token al endpoint siteverify de Google.
Paso 5. Comprobación de score y action
El servidor comprueba que success sea true, que el score cumpla el umbral y que la action coincida. Un token válido con score bajo aún puede rechazarse.

Puntuación de reCAPTCHA v3: qué significa y cómo configurar minScore

Las puntuaciones de reCAPTCHA v3 van de 0.0 (probable bot) a 1.0 (probable humano). Google sugiere un umbral de 0.5. Observe el tráfico real antes de aplicarlo o ajustarlo.

Google admite 11 niveles de puntuación. Essentials gratuito devuelve 0.1, 0.3, 0.7 y 0.9; al activar la facturación se desbloquean todos los niveles y los códigos de motivo. Las puntuaciones en staging y la primera semana pueden diferir de producción.

El parámetro minScore de CapMonster Cloud (0.1–0.9) fija la puntuación mínima del token. Alineelo con el umbral del sitio; valores altos como 0.9 aumentan los intentos fallidos.

pageAction debe coincidir con la action en grecaptcha.execute. Use solo letras, dígitos, barras y guiones bajos. Los sitios pueden rechazar discrepancias. Pase tanto minScore como pageAction.

Rango de puntuación
0.0–1.0
Umbral predeterminado
0.5
minScore
0.1–0.9

Prueba de puntuación reCAPTCHA v3: cómo comprobar el score

Una prueba de puntuación requiere backend: el score llega en la respuesta de siteverify.

  1. 1. En una página de prueba, use su site key y llame a grecaptcha.execute con una action.

  2. 2. Envíe el token y la clave secreta desde su backend a https://www.google.com/recaptcha/api/siteverify.

  3. 3. Compare el score devuelto con su umbral y verifique la action.

Pruebe nuestra página demo de reCAPTCHA v3 sin crear una página de prueba.

Comparación de resolutores de reCAPTCHA v3

La tabla muestra precio, tiempo de respuesta de la API y tasa de éxito de cuatro servicios de resolución de reCAPTCHA v3.

ParámetroCapMonster Cloud2CaptchaCapSolverDeathByCaptcha
Precio por 1000 resoluciones (desde)
$ 0.90$1.45$1.00$2.89
Tiempo de respuesta de la API
≤ 2 s≤ 2 s< 3 s≤ 3 s
Tasa de éxito de resolución
hasta 99%~77–92%~95–98%~64–90%

Aviso: 2Captcha, CapSolver y DeathByCaptcha son marcas de sus respectivos propietarios. CapMonster Cloud no está afiliado a estas entidades. Las métricas de rendimiento y la comparación de precios se basan en datos públicos y pruebas internas realizadas el 28.09.2026.

Pruébalo gratis

$0.10

Los nuevos usuarios reciben $0.10 de saldo de prueba para probar CapMonster Cloud.

  1. 1. Regístrate en CapMonster Cloud.

  2. 2. Escribe a soporte por el chat en vivo o a support@capmonster.cloud con el email de tu cuenta.

Cómo resolver reCAPTCHA v3 a través de CapMonster Cloud

CapMonster Cloud acepta los parámetros del captcha, los procesa en sus servidores y devuelve un token listo para usar. Inserte este token en el formulario para superar la verificación sin interacción del usuario. La tarea RecaptchaV3TaskProxyless se ejecuta en los servidores proxy propios de CapMonster Cloud, por lo que no pasa parámetros de proxy.

Creación de la tarea

En esta etapa envías tu clave de API, el tipo de captcha y sus parámetros. El servicio devuelve un taskId único con el que podrás obtener el resultado más adelante.

Enviar una solicitud API

En la solicitud para resolver reCAPTCHA v3 debe indicar los siguientes parámetros:

ParámetroDescripción
type
stringObligatorio
RecaptchaV3TaskProxyless
websiteURL
stringObligatorio
la dirección de la página en la que se resuelve el captcha
websiteKey
stringObligatorio
el identificador de clave (sitekey) que se indica en la página de su sitio con el captcha
https://www.google.com/recaptcha/api.js?render=SITE_KEY
6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob
isEnterprise
booleanOpcional
Para reCAPTCHA v3 Enterprise, establezca isEnterprise: true en RecaptchaV3TaskProxyless (true/false o 1/0). CapMonster Cloud lo procesa como RecaptchaV3EnterpriseTask.
minScore
doubleOpcional
puede tener un valor de 0.1 a 0.9
pageAction
stringOpcional
el valor del parámetro action que envía el widget de ReCaptcha en Google. Valor predeterminado: verify
grecaptcha.execute('site_key', {action: 'login_test'})
Consulta más detalles sobre los parámetros y cómo recopilarlos automáticamente antes de enviar una tarea en la documentación de CapMonster Cloud.
Endpoint para enviar la tarea:
text
https://api.capmonster.cloud/createTask
Ejemplo de solicitud:
json
{
  "clientKey": "API_KEY",
  "task": {
    "type": "RecaptchaV3TaskProxyless",
    "websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
    "websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
    "minScore": 0.3,
    "pageAction": "myverify"
  }
}
Respuesta:
json
{
  "errorId":0,
  "taskId":407533072
}

Recepción del resultado

Tras crear la tarea, consulta periódicamente el estado de la solución.
Dirección para recibir el resultado:
text
https://api.capmonster.cloud/getTaskResult
Ejemplo de solicitud:
json
{
  "clientKey":"API_KEY",
  "taskId": 407533072
}
Respuesta:
json
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
  }
}
Respuesta con userAgent
json
{
  "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"
    }
  }
}
IMPORTANTE
En algunos sitios, la solución también contiene userAgent. Utilice ese UserAgent al enviar el token o confirmar la solución, aunque difiera del de su navegador o script.

Colocar el token en la página

El token obtenido (valor de "gRecaptchaResponse") puede insertarse en un campo oculto del formulario o usarse para llamar a una función JS en el sitio y confirmar la solución. Después de esto, el servidor aceptará el formulario como correctamente completado. Para automatizar y hacer pruebas, es muy cómodo utilizar Puppeteer, Selenium o Playwright, que permiten emular las acciones del usuario, insertar tokens y enviar formularios.
En algunos sitios, la solución también contiene userAgent. Utilice ese UserAgent al enviar el token o confirmar la solución, aunque difiera del de su navegador o script.
Probar en la página de demostración

Cómo encontrar el sitekey y pageAction

Una tarea reCAPTCHA v3 necesita la clave del sitio (websiteKey) y el nombre de la acción (pageAction).

  1. 1. Haga clic derecho en la página y seleccione Inspect.

  2. 2. En Elements o Network, busque api.js?render=SITE_KEY. El valor tras render= es websiteKey. reCAPTCHA Enterprise usa enterprise.js?render=SITE_KEY.

  3. 3. Busque grecaptcha.execute('SITE_KEY', {action: 'ACTION'}). ACTION es pageAction. Enterprise usa grecaptcha.enterprise.execute. Si se omite, la tarea usa verify por defecto.

  4. 4. Capture grecaptcha.execute en un navegador headless como Playwright para obtener ambos valores. Vea ejemplos en JavaScript, Python y C# en la documentación de CapMonster Cloud.

SDK para resolver reCAPTCHA v3: Python, Node.js, C#

El servicio CapMonster Cloud proporciona bibliotecas listas para trabajar cómodamente con Python, JavaScript (Node.js) y C#.
Python
JavaScript
C#
python
import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV3ProxylessRequest
client_options = ClientOptions(api_key="YOUR_API_KEY")  # Indica tu clave de API de CapMonster Cloud
cap_monster_client = CapMonsterClient(options=client_options)
# Si es necesario, puedes comprobar el 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 de tu página con el captcha
    websiteKey="6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",  # Sustituye por un valor correcto
    minScore=0.7,  # Umbral mínimo de la puntuación de confianza
    pageAction="myverify"  # Acción en la página
)
async def solve_captcha():
    return await cap_monster_client.solve_captcha(recaptcha_v3_request)
responses = asyncio.run(solve_captcha())
print(responses)

Para qué usan los equipos un solver de reCAPTCHA v3

QA y pruebas end-to-end

Ejecute flujos de registro, checkout y formularios en CI/CD con Playwright, Puppeteer o Selenium en páginas propias o autorizadas para pruebas.

Monitorización

Compruebe que formularios y endpoints protegidos siguen funcionando tras releases y cambios de umbral.

Datos de acceso público

Recopile datos públicos de páginas abiertas con comprobaciones basadas en score.

Accesibilidad

Apoye flujos asistivos automatizados en sitios con comprobaciones invisibles de bots.

Agentes de IA

Permita que un agente solicite un token mediante MCP cuando el flujo llega a un captcha.

Solo uso legítimo

Use CapMonster Cloud para datos públicos y en sitios propios o autorizados. Recopilar datos de terceros tras login o paywall sin permiso está prohibido.

reCAPTCHA v3 y reCAPTCHA v3 Enterprise

Essentials4 niveles
0.1 · 0.3 · 0.7 · 0.9

reCAPTCHA Enterprise usa comprobaciones basadas en score: Essentials devuelve cuatro niveles.

Premium · Enterprise11 niveles
Motivos de la puntuación de riesgo asignada

Premium y Enterprise devuelven 11, con razones de explicabilidad básicas y avanzadas respectivamente.

RecaptchaV3TaskProxylessisEnterprise: true

Para reCAPTCHA v3 Enterprise, establezca isEnterprise: true en RecaptchaV3TaskProxyless (true/false o 1/0). CapMonster Cloud lo procesa como RecaptchaV3EnterpriseTask.

Verificar un token reCAPTCHA v3 en su propio sitio

POST https://www.google.com/recaptcha/api/siteverify

secret=YOUR_SECRET_KEY
response=TOKEN

En su propio sitio, envíe secret y response a https://www.google.com/recaptcha/api/siteverify. Los tokens caducan en 2 minutos y sirven una vez. Compruebe success, score y action; Google sugiere un umbral de 0.5.

Consulte Captcha API (Google reCAPTCHA v3) para ejemplos en Node.js y Python, manejo de errores y acciones basadas en score.

Background

Errores de reCAPTCHA v3 y cómo solucionarlos

Bug Icon

Sitio o clave incorrectos

El captcha no se carga o devuelve invalid-input-secret.
Bug Icon

Tiempo de resolución agotado

El servidor no recibió la respuesta a tiempo, aumenta el tiempo de espera.
Bug Icon

Token vacío

Error al enviar el resultado a la página.
Bug Icon

Respuesta success=false

El token ha expirado, se ha reutilizado o ha sido manipulado. Para diagnosticarlo, activa el registro (logging) de las solicitudes y revisa el campo error-codes en la respuesta de Google.
Bug Icon

Score bajo (por ejemplo, <0.5)

Puede provocar un rechazo incluso con success=true, ya que Google evalúa la confianza en el usuario basándose en el score.
Bug Icon

Revisa el campo action

Para asegurarte de que el token está destinado a una acción concreta en la página

Códigos de error de Google siteverify

secretSecret key
missing-input-secret

Falta el parámetro secret

secretSecret key
invalid-input-secret

El parámetro secret no es válido o está mal formado

responseToken
missing-input-response

Falta el token

responseToken
invalid-input-response

El token no es válido o está mal formado

requestRequest
bad-request

La solicitud no es válida o está mal formada

responseVida útil del token
timeout-or-duplicate

El token es demasiado antiguo o ya se ha usado

Otros captchas que resuelve CapMonster Cloud

Preguntas frecuentes sobre reCAPTCHA v3

¿Qué valor de minScore debo establecer para una tarea de reCAPTCHA v3?

El parámetro minScore acepta valores de 0.1 a 0.9 e indica a CapMonster Cloud la puntuación de confianza mínima que debe tener el token devuelto. 0.3 es un punto de partida razonable. Un valor demasiado alto (p. ej. 0.9) aumenta la probabilidad de fallos en la resolución; uno demasiado bajo puede devolver tokens con una puntuación que su umbral del servidor debería rechazar de todos modos. Ajuste el valor según las tasas de rechazo reales en su entorno de prueba.

¿Cómo encuentro el sitekey y la action para una tarea reCAPTCHA v3?

Abra la página y busque api.js?render=SITE_KEY con el inspector. El valor después de render= es el sitekey. La action se encuentra en grecaptcha.execute(siteKey, {action: "..."}). Puede capturar la llamada automáticamente con Playwright. Algunos valores cambian al cargar la página; cree la tarea justo después de obtenerlos. Consulte los pasos completos.

¿Qué puntuación de reCAPTCHA v3 se considera buena?

1.0 indica una interacción probablemente legítima y 0.0 indica un probable bot. Google recomienda 0.5 como umbral predeterminado. El valor adecuado depende del umbral del sitio. Configure minScore según ese umbral y ajuste el valor al tráfico real. Cómo comprobar la puntuación.

¿Cuánto tiempo es válido un token de reCAPTCHA v3 después de emitirse?

Un token recibido de reCAPTCHA v3 es válido aproximadamente 2 minutos. Su pipeline de automatización debe enviar el token al servidor dentro de ese plazo; después de expirar, el endpoint siteverify de Google devuelve success: false. Mantenga el paso de resolución lo más cerca posible del envío del formulario y evite almacenar en caché tokens entre solicitudes.

Cada token solo se puede verificar una vez. Un token caducado o ya utilizado genera timeout-or-duplicate. Solicite un token nuevo para cada envío.

¿Cómo inyectar un token de reCAPTCHA v3 con Playwright, Puppeteer o Selenium?

Para inyectar un token de reCAPTCHA v3, encuentre el campo de respuesta oculto (normalmente un textarea o input con el ID g-recaptcha-response) e inserte el token obtenido de su servicio de resolución CAPTCHA. Así se hace en los tres frameworks de automatización.

Playwright / Puppeteer (Node.js)

javascript
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
  document.getElementById('g-recaptcha-response').value = t;
}, token);
await page.click('#submit-btn');

Selenium (Python)

python
token = "YOUR_TOKEN"
driver.execute_script(f"document.getElementById('g-recaptcha-response').value = '{token}';")
driver.find_element("id", "submit-btn").click()

Algunos sitios usan funciones callback para validar el token. Si el formulario no se envía, encuentre el nombre de la función en la consola (___grecaptcha_cfg.clients) y llámela manualmente:

javascript
await page.evaluate((t) => {
  window.onSuccessCallback(t);
}, token);

¿Por qué reCAPTCHA v3 devuelve success=true pero sigue rechazando mi solicitud?

Una respuesta success: true de Google solo significa que el token es válido. Su backend aún puede rechazar la solicitud si la puntuación del token está por debajo de su umbral configurado.

Otro problema común es una discrepancia de action. El token debe verificarse con el mismo valor action que se usó al crear la tarea.

Para diagnosticar el problema:

  • compruebe el campo score en la respuesta siteverify;
  • verifique que el valor action coincida;
  • inspeccione error-codes cuando success sea false.

Si success es true, el array error-codes suele estar vacío, por lo que score y action son los campos principales a revisar.

¿CapMonster Cloud resuelve reCAPTCHA v3 Enterprise?

Sí. Incluya isEnterprise: true en la tarea reCAPTCHA v3 (valores admitidos: true/false o 1/0). Se procesa igual que RecaptchaV3EnterpriseTask. Consulte la sección anterior y la documentación de la API.

CapMonster Cloud

Ninguna herramienta puede garantizar un 100 % de éxito frente a protecciones que evolucionan, pero CapMonster Cloud ofrece una alta tasa de éxito al resolver reCAPTCHA v3. Estos datos se basan en pruebas comparativas internas mensuales del equipo de CapMonster Cloud. El tiempo de respuesta de la API y la tasa de éxito reales varían según el sitio de destino, la carga del servidor y las condiciones de la red.

reCAPTCHA es una marca de Google LLC. CapMonster Cloud no está afiliado a Google ni cuenta con su respaldo. El servicio está destinado a datos disponibles públicamente, pruebas de sitios propios o autorizados, reconocimiento de imágenes y accesibilidad. Está prohibido recopilar datos de terceros protegidos por 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.