Solveur de captcha
pour agents IA
Un agent qui rencontre un défi se bloque sans rien dire. Exposez la résolution comme un outil et le blocage devient un appel déterministe de plus.
Collez ceci dans votre agent de code
Claude Code, Cursor, Codex, Copilot ou Windsurf : le prompt vous demande votre clé API, ajoute le serveur MCP, intègre une fonction de résolution dans votre projet et vérifie le tout de bout en bout.
Configurez CaptchaNo (https://captchano.com) dans ce projet pour que les captchas ne bloquent plus notre automatisation de navigateur. Lisez d'abord le guide de configuration complet et suivez-le : https://captchano.com/agents/setup.md En résumé : 1. Demandez-moi une clé API CaptchaNo (elle commence par "cn-" ; je peux en créer une sur https://captchano.com/dashboard/keys). Ne la codez jamais en dur, ne l'affichez pas, ne la journalisez pas et ne la commitez jamais. Stockez-la sous CAPTCHANO_API_KEY dans le fichier .env du projet ignoré par git ou dans son gestionnaire de secrets. 2. Si vous prenez en charge MCP, ajoutez le serveur MCP CaptchaNo pour vous-même : commande "npx -y captchano-mcp", variables d'environnement CAPTCHANO_API_KEY et CAPTCHANO_MAX_SPEND_USD=1.00 (dans Claude Code : claude mcp add captchano -e CAPTCHANO_API_KEY=<key> -e CAPTCHANO_MAX_SPEND_USD=1.00 -- npx -y captchano-mcp). 3. Si ce code pilote un navigateur ou un client HTTP (Playwright, Puppeteer, Selenium, Scrapy, requests...), ajoutez une petite fonction utilitaire solveCaptcha qui appelle POST https://api.captchano.com/v1/solve?wait=60 avec la clé en bearer, et injectez le token renvoyé comme le montre le guide. Réutilisez le client HTTP et le style existants du projet. 4. Vérifiez : consultez le solde (outil get_balance ou GET /v1/balance), puis effectuez la vérification de bout en bout en une seule résolution décrite dans le guide (elle résout le reCAPTCHA de https://captchano.com/tools/captcha-demo et confirme que Google accepte le token). Pris en charge : reCAPTCHA v2/v3/Enterprise, Cloudflare Turnstile, DataDome (nécessite notre propre proxy) et captchas image. Les résolutions échouées ne sont pas facturées. N'automatisez que les sites qui nous appartiennent ou que nous sommes autorisés à automatiser. Indiquez-moi ce que vous avez modifié une fois terminé.
Guide complet suivi par l'agent : captchano.com/agents/setup.md
Configuration, réponses typées et visibilité du coût de chaque résolution.
Configuration, réponses typées et visibilité du coût de chaque résolution.
Configuration, réponses typées et visibilité du coût de chaque résolution.
Configuration, réponses typées et visibilité du coût de chaque résolution.
Configuration, réponses typées et visibilité du coût de chaque résolution.
Configuration, réponses typées et visibilité du coût de chaque résolution.
Pourquoi les agents se bloquent sur les captchas
Un script échoue bruyamment lorsqu'il rencontre un défi. Un agent échoue en silence, et c'est pire.
Rien dans la boîte à outils d'un agent classique ne sait résoudre une grille d'images ou un défi évalué sur la session : l'agent reste coincé sur la page.
Les modèles inventent une étape suivante plausible et signalent des progrès qu'ils n'ont jamais faits. L'échec est silencieux.
Un agent qui recharge sans cesse une page protégée par un défi dépense des tokens et du temps sans se rapprocher de son objectif.
Donnez à l'agent un outil de résolution
- 01Encapsulez l'API dans un outil
Une seule fonction qui prend le type, la sitekey et l'URL, et appelle /v1/solve?wait=60.
- 02Gardez la clé hors du prompt
Lisez-la depuis l'environnement à l'intérieur de l'outil, pour que le modèle ne la voie jamais.
- 03Renvoyez un résultat typé
Le token, le user agent utilisé et le coût, pour que l'agent puisse soumettre et comptabiliser ses dépenses.
- 04Bornez la boucle
Plafonnez les résolutions ou les dépenses par exécution pour qu'un agent désorienté ne puisse pas tourner en boucle sur une page.
Ce que renvoie l'outil
Chaque réponse contient le token ou le cookie, le user agent avec lequel il a été produit et le coût de la résolution. L'agent peut réutiliser ce user agent lors de la soumission, et un superviseur peut arrêter l'exécution quand les dépenses dépassent un seuil. Les formats de requête de chaque type de défi figurent dans la référence de l'API.
Aucun SDK requis
CaptchaNo est une simple API REST : chaque guide de framework ci-dessus se résume à quelques lignes de votre propre code plutôt qu'à un paquet auquel vous devriez faire confiance. Le même outil fonctionne donc aussi dans tout framework pour lequel nous n'avons pas encore écrit de guide.
FAQ captcha pour agents IA
Un agent IA peut-il résoudre des captchas tout seul ?
Il peut parfois cocher une case, mais il ne sait pas répondre de façon fiable aux défis par images, et les navigateurs automatisés en reçoivent plus souvent. Un outil de résolution transforme le défi en un appel déterministe sur lequel l'agent peut s'appuyer.
Quels frameworks d'agents sont pris en charge ?
Tout framework capable d'appeler une API HTTP. Nous proposons des guides pour MCP, LangChain, Browser Use, l'OpenAI Agents SDK, CrewAI et n8n, et le même principe fonctionne ailleurs.
Existe-t-il un serveur MCP CaptchaNo ?
Oui. captchano-mcp est un serveur MCP open source (MIT) que vous lancez avec npx -y captchano-mcp. Il lit votre clé API depuis l'environnement, jamais depuis le modèle, et prend en charge un plafond de dépenses optionnel. Il est référencé dans le MCP Registry officiel.
Comment empêcher un agent de trop dépenser ?
Chaque résultat indique son coût. Tenez un total cumulé dans l'outil ou dans le contexte d'exécution et refusez toute nouvelle résolution au-delà d'un budget.
Est-il permis de laisser des agents résoudre des captchas ?
Cela dépend du site et de la tâche. Les usages prévus sont les agents qui agissent sur vos propres comptes, testent vos propres systèmes ou collectent des données que le site autorise. Lisez d'abord les conditions du site cible.
Guides utiles
Prêt à développer ?
Commencez par un essai gratuit de 3 jours, puis payez par résolution réussie à mesure que votre trafic augmente. Aucune carte requise pour l'essai.