Resolución de captchas para
agentes de n8n
Un agente que se encuentra con un desafío no tiene nada en su conjunto de herramientas que pueda responderlo, así que se atasca o alucina para sortearlo. Dale un solucionador como herramienta y el bloqueo se convierte en una llamada más.
HTTP Request node
Method: POST
URL: https://api.captchano.com/v1/solve?wait=60
Authentication: Header Auth
Name: Authorization
Value: Bearer cn-YOUR_API_KEY
Send Body: JSON
Body:
{
"type": "turnstile",
"sitekey": "{{ $json.sitekey }}",
"url": "{{ $json.pageUrl }}"
}
The node outputs { status, solution: { token, userAgent }, cost } —
pass {{ $json.solution.token }} to the next step.Por qué los agentes necesitan esto en concreto
Un scraper que se encuentra con un desafío falla de forma visible y lo arreglas. Un agente falla en silencio: razona sobre la página bloqueada, inventa un siguiente paso verosímil e informa de un progreso que nunca hizo. El fallo es peor porque es silencioso. Una herramienta de resolución tipada convierte un callejón sin salida ambiguo en un resultado determinista sobre el que el agente puede ramificar.
Qué devuelve la herramienta
- Un token o una cookie, según el tipo de desafío. Los sistemas que evalúan la sesión devuelven una cookie junto con el conjunto de encabezados usado para obtenerla.
- El user agent usado, para que el agente pueda reutilizarlo al enviar.
- El costo de la resolución, para que un agente que opera con un presupuesto pueda tenerlo en cuenta en lugar de gastar a ciegas.
Mantener el bucle acotado
Dale al agente un presupuesto de resoluciones por ejecución. Cada respuesta indica su costo, así que un supervisor puede cortar el bucle cuando el gasto supera un umbral en lugar de descubrirlo en la factura. A $0.00598 por resolución, una ejecución típica de un agente cuesta unos pocos centavos o menos, pero un bucle de reintentos sin límite sigue siendo un bucle de reintentos sin límite.
Mantén la llamada a la herramienta bloqueante
Los ejemplos llaman a ?wait=60, así que la herramienta devuelve un token terminado en un solo paso. Eso importa más en los agentes que en los scripts: una herramienta que devuelve "todavía resolviendo" obliga al modelo a razonar sobre el sondeo, algo que hace mal. Si necesitas un límite mayor, sube wait hasta 120 segundos. Las estructuras de solicitud de cada tipo de desafío están en la referencia de la API.
Cómo encaja la resolución en n8n
El nodo AI Agent de n8n puede llamar a una herramienta HTTP Request. Apúntala al endpoint de resolución y el agente podrá superar un captcha a mitad del workflow.
- 01Añade un nodo AI Agent
Conecta un modelo de chat y memoria como de costumbre.
- 02Añade una herramienta HTTP Request
Envía un POST a la API con ?wait=60 y credenciales Header Auth.
- 03Describe la herramienta
Indica al agente que la llame con type, sitekey y url cuando una página muestre un captcha.
- 04Usa el token
El agente pasa el token a la herramienta que envía el formulario.
Cómo introducir el token en la página
El agente recibe el token de la herramienta y se lo pasa al siguiente nodo o herramienta que hace el envío.
Dónde suelen fallar las integraciones
Sube el timeout de la herramienta por encima del valor de wait.
Usa las credenciales de n8n para que la clave nunca aparezca en el prompt ni en la exportación del workflow.
Preguntas frecuentes sobre captchas en n8n
¿Hay un community node?
No, y no hace falta. La herramienta HTTP Request cubre toda la API.
¿Puedo usarlo sin un agente?
Sí. Consulta la guía de integración con n8n para ver un workflow sencillo con un solo nodo HTTP Request.
¿Funciona en n8n cloud?
Sí. Es una petición HTTPS saliente normal.
¿Cómo veo lo que ha gastado el agente?
Cada resultado incluye el costo, y el panel muestra todas las resoluciones.
Guías útiles
¿Listo para construir?
Empieza con una prueba gratuita de 3 días y luego paga por cada resolución exitosa a medida que crece tu tráfico. No necesitas tarjeta para la prueba.