Solucionador de captchas
para agentes de IA
Un agente que se encuentra con un desafío se atasca sin avisar. Expón la resolución como herramienta y el bloqueo se convierte en una llamada determinista más.
Pega esto en tu agente de programación
Claude Code, Cursor, Codex, Copilot o Windsurf: el prompt te pide tu clave de API, añade el servidor MCP, integra un helper de resolución en tu proyecto y lo comprueba de principio a fin.
Configura CaptchaNo (https://captchano.com) en este proyecto para que los captchas dejen de bloquear nuestra automatización del navegador. Primero lee la guía de configuración completa y síguela: https://captchano.com/agents/setup.md En resumen: 1. Pídeme una clave de API de CaptchaNo (empieza por "cn-"; puedo crear una en https://captchano.com/dashboard/keys). Nunca la escribas en el código, la imprimas, la registres en logs ni la incluyas en un commit. Guárdala como CAPTCHANO_API_KEY en el .env del proyecto ignorado por git o en el almacén de secretos. 2. Si admites MCP, añade el servidor MCP de CaptchaNo para ti: comando "npx -y captchano-mcp", env CAPTCHANO_API_KEY y CAPTCHANO_MAX_SPEND_USD=1.00 (en Claude Code: claude mcp add captchano -e CAPTCHANO_API_KEY=<key> -e CAPTCHANO_MAX_SPEND_USD=1.00 -- npx -y captchano-mcp). 3. Si este código controla un navegador o un cliente HTTP (Playwright, Puppeteer, Selenium, Scrapy, requests...), añade un pequeño helper solveCaptcha que llame a POST https://api.captchano.com/v1/solve?wait=60 con la clave bearer, e inyecta el token devuelto como muestra la guía. Reutiliza el cliente HTTP y el estilo que ya tiene el proyecto. 4. Verifica: comprueba el saldo (herramienta get_balance o GET /v1/balance) y luego haz la prueba de extremo a extremo con una sola resolución que describe la guía (resuelve el reCAPTCHA de https://captchano.com/tools/captcha-demo y confirma que Google acepta el token). Compatibles: reCAPTCHA v2/v3/Enterprise, Cloudflare Turnstile, DataDome (necesita nuestro propio proxy) y captchas de imagen. Las resoluciones fallidas no se cobran. Automatiza solo sitios que sean nuestros o que tengamos permiso para automatizar. Cuando termines, dime qué cambiaste.
Guía completa que sigue el agente: captchano.com/agents/setup.md
Configuración, respuestas tipadas y visibilidad del costo por resolución.
Configuración, respuestas tipadas y visibilidad del costo por resolución.
Configuración, respuestas tipadas y visibilidad del costo por resolución.
Configuración, respuestas tipadas y visibilidad del costo por resolución.
Configuración, respuestas tipadas y visibilidad del costo por resolución.
Configuración, respuestas tipadas y visibilidad del costo por resolución.
Por qué los agentes se atascan con los captchas
Un script falla de forma visible cuando se encuentra con un desafío. Un agente falla en silencio, y eso es peor.
Nada en el conjunto de herramientas habitual de un agente puede resolver una cuadrícula de imágenes o un desafío que evalúa la sesión, así que el agente se queda atascado en la página.
Los modelos inventan un siguiente paso verosímil e informan de un progreso que nunca hicieron. El fallo es silencioso.
Un agente que recarga una y otra vez una página con desafío gasta tokens y tiempo sin acercarse al objetivo.
Dale al agente una herramienta de resolución
- 01Envuelve la API como herramienta
Una función que recibe el tipo, la sitekey y la URL y llama a /v1/solve?wait=60.
- 02Mantén la clave fuera del prompt
Léela del entorno dentro de la herramienta, para que el modelo nunca la vea.
- 03Devuelve un resultado tipado
El token, el user agent usado y el costo, para que el agente pueda enviarlo y llevar la cuenta del gasto.
- 04Acota el bucle
Limita las resoluciones o el gasto por ejecución para que un agente confundido no entre en bucle en una página.
Qué devuelve la herramienta
Cada respuesta incluye el token o la cookie, el user agent con el que se produjo y el costo de la resolución. El agente puede reutilizar el user agent al enviar, y un supervisor puede detener la ejecución cuando el gasto supera un umbral. Las estructuras de solicitud de cada tipo de desafío están en la referencia de la API.
No hace falta ningún SDK
CaptchaNo es una API REST sencilla, así que cada guía de framework de arriba son unas pocas líneas de tu propio código en lugar de un paquete en el que tengas que confiar. Eso también significa que la misma herramienta funciona en cualquier framework para el que no hayamos escrito una guía.
Preguntas frecuentes sobre captchas y agentes de IA
¿Puede un agente de IA resolver captchas por sí mismo?
A veces puede hacer clic en una casilla, pero no puede responder de forma fiable a los desafíos de imágenes, y a los navegadores automatizados se les muestran con más frecuencia. Una herramienta de resolución convierte el desafío en una llamada determinista sobre la que el agente puede ramificar.
¿Qué frameworks de agentes se admiten?
Cualquier framework que pueda llamar a una API HTTP. Tenemos guías para MCP, LangChain, Browser Use, el OpenAI Agents SDK, CrewAI y n8n, y el mismo patrón funciona en otros.
¿Existe un servidor MCP de CaptchaNo?
Sí. captchano-mcp es un servidor MCP de código abierto (MIT) que ejecutas con npx -y captchano-mcp. Lee tu clave de API del entorno, nunca del modelo, y admite un límite de gasto opcional. Está publicado en el MCP Registry oficial.
¿Cómo evito que un agente gaste de más?
Cada resultado incluye su costo. Lleva un total acumulado en la herramienta o en el contexto de la ejecución y rechaza más resoluciones cuando se supere un presupuesto.
¿Está permitido dejar que los agentes resuelvan captchas?
Depende del sitio y de la tarea. Los usos previstos son agentes que actúan en tus propias cuentas, que prueban tus propios sistemas o que recopilan datos que el sitio permite. Lee primero los términos del sitio de destino.
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.