Résolution de captcha pour
agents n8n
Un agent qui rencontre un défi n'a rien dans sa boîte à outils pour y répondre : il se bloque ou hallucine un contournement. Donnez-lui un solveur sous forme d'outil et le blocage devient un appel de plus.
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.Pourquoi les agents en ont particulièrement besoin
Un scraper qui tombe sur un défi échoue bruyamment, et vous le corrigez. Un agent échoue en silence : il raisonne sur la page bloquée, invente une étape suivante plausible et signale des progrès qu'il n'a jamais faits. L'échec est pire parce qu'il est silencieux. Un outil de résolution typé transforme une impasse ambiguë en un résultat déterministe sur lequel l'agent peut s'appuyer.
Ce que renvoie l'outil
- Un token ou un cookie, selon le type de défi. Les systèmes évalués sur la session renvoient un cookie ainsi que l'ensemble des en-têtes utilisés pour l'obtenir.
- Le user agent utilisé, pour que l'agent puisse le réutiliser lors de la soumission.
- Le coût de la résolution, pour qu'un agent soumis à un budget puisse le comptabiliser au lieu de dépenser à l'aveugle.
Garder la boucle bornée
Donnez à l'agent un budget de résolutions par exécution. Chaque réponse indique son coût : un superviseur peut donc couper la boucle quand les dépenses dépassent un seuil, plutôt que de le découvrir sur la facture. À $0.00598 par résolution, une exécution d'agent typique coûte quelques centimes ou moins, mais une boucle de nouvelles tentatives sans limite reste une boucle sans limite.
Gardez l'appel d'outil bloquant
Les exemples appellent ?wait=60, pour que l'outil renvoie un token finalisé en une seule étape. C'est plus important pour les agents que pour les scripts : un outil qui renvoie "résolution en cours" oblige le modèle à raisonner sur le polling, ce qu'il fait mal. Si vous avez besoin d'un délai plus long, augmentez wait jusqu'à 120 secondes. Les formats de requête de chaque type de défi figurent dans la référence de l'API.
Comment la résolution s'intègre à n8n
Le nœud AI Agent de n8n peut appeler un outil HTTP Request. Pointez-le vers l'endpoint de résolution et l'agent pourra franchir un captcha en plein workflow.
- 01Ajouter un nœud AI Agent
Connectez un modèle de chat et une mémoire comme d'habitude.
- 02Ajouter un outil HTTP Request
Envoyez un POST à l'API avec ?wait=60 et des credentials Header Auth.
- 03Décrire l'outil
Indiquez à l'agent de l'appeler avec type, sitekey et url lorsqu'une page affiche un captcha.
- 04Utiliser le token
L'agent transmet le token à l'outil qui envoie le formulaire.
Injecter le token dans la page
L'agent reçoit le token de l'outil et le transmet au nœud ou à l'outil suivant qui envoie le formulaire.
Là où les intégrations échouent le plus souvent
Réglez le timeout de l'outil au-dessus de la valeur de wait.
Utilisez les credentials n8n pour que la clé n'apparaisse jamais dans le prompt ni dans l'export du workflow.
FAQ captcha n8n
Existe-t-il un nœud communautaire ?
Non, et ce n'est pas nécessaire. L'outil HTTP Request couvre toute l'API.
Puis-je l'utiliser sans agent ?
Oui. Consultez le guide d'intégration n8n pour un workflow simple avec un seul nœud HTTP Request.
Cela fonctionne-t-il sur n8n cloud ?
Oui. Il s'agit d'une requête HTTPS sortante ordinaire.
Comment voir ce que l'agent a dépensé ?
Chaque résultat inclut le coût, et le tableau de bord liste chaque résolution.
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.