Périmètre sûr : ce guide s'applique uniquement à vos applications et environnements de QA, préproduction ou production, ou à des systèmes pour lesquels vous disposez d'une autorisation écrite. Il ne porte ni sur l'automatisation de sites tiers, ni sur la neutralisation de protections anti-bot.
L'extension CaptchaAI résout les défis CAPTCHA directement dans le navigateur que vos testeurs pilotent déjà. Pour une équipe QA, la difficulté est de garder ce comportement stable quand la suite tourne sans surveillance. Traitez l'extension comme un workflow de navigateur reproductible, pas comme un interrupteur : quatre éléments décident de sa stabilité — l'état du compte, le profil de navigateur, le handler CAPTCHA visé et le comportement une fois le token appliqué.
Préparer l'extension pour des tests stables
Pourquoi la traiter comme un workflow
Le sujet devient urgent le jour où l'extension, séduisante en démonstration manuelle, échoue dès qu'elle s'exécute sans opérateur. Il vous faut des suites déterministes qui gardent les tests sensibles au CAPTCHA dans votre CI.
CaptchaAI répond avec une API unique couvrant les familles rencontrées en QA : reCAPTCHA v2 et v3, Cloudflare Turnstile et Challenge, GeeTest v3, les CAPTCHA image/OCR et les grilles d'images. Le contrat submit/poll reste identique d'un type à l'autre — seul le handler change — et la facturation par thread ne pénalise pas le volume.
Les quatre réglages qui décident de la stabilité
État du compte et clé API. Stockez la clé CaptchaAI dans un secret CI ou un coffre, jamais dans le code source. Une alerte de solde évite qu'un compte à sec interrompe une exécution nocturne.
Profil de navigateur isolé. Chargez l'extension dans un profil dédié (--user-data-dir) plutôt que dans le profil par défaut. Vous obtenez un état reproductible et un échec rejouable à l'identique.
Sélection du handler. Un seul type de CAPTCHA par test. Récupérez uniquement les paramètres attendus (sitekey, URL, action) ; en collecter plus brouille le débogage.
Comportement après résolution. Appliquez le token dans la session qui a déclenché le défi : même contexte de navigateur, même cookie jar. Une session dépareillée est la première cause de rejet.
Mettre en œuvre et observer l'intégration
Un scénario concret en session de test
Prenez la version réelle de ce workflow : un job planifié dans GitHub Actions, un worker interne hébergé sur OVHcloud ou Scaleway, ou un test end-to-end franchissant une étape protégée par CAPTCHA. La première exécution passe en cinq minutes ; ensuite, elle doit survivre aux déploiements, aux à-coups réseau et au changement de famille de CAPTCHA. Côté RGPD, ne conservez dans les logs que les identifiants techniques utiles au diagnostic.
Exemple de code
Exemple côté client de votre suite de tests, pour une tâche Turnstile :
import fetch from 'node-fetch';
const API_KEY = process.env.CAPTCHAAI_KEY;
export async function createTurnstileTask(siteKey, pageUrl) {
const res = await fetch('https://api.captchaai.com/createTask', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
clientKey: API_KEY,
task: {
type: 'TurnstileTaskProxyless',
websiteURL: pageUrl,
websiteKey: siteKey,
},
}),
});
const data = await res.json();
return data.taskId;
}
Observabilité et journalisation
Instrumentez les appels CAPTCHA pour obtenir des signaux exploitables : durée d'obtention du token, code retour HTTP et identifiant de tâche. Séparez les journaux par environnement et corrélez les identifiants avec votre traçage distribué, par exemple OpenTelemetry : un identifiant unique suffit à rejouer un scénario complet.
Liste de contrôle avant fusion
- Le périmètre reste limité à vos applications ou à des sources autorisées.
- La clé CaptchaAI vit dans un secret CI, jamais dans le dépôt.
- Les durées d'appel et les codes retour sont tracés à chaque exécution.
- Le token est appliqué dans la même session que le défi.
- Un retry idempotent et plafonné gère les erreurs transitoires.
Dépannage rapide
| Symptôme | Cause probable | Correctif |
|---|---|---|
ERROR_WRONG_USER_KEY |
Clé copiée avec un espace parasite. | Recopiez la clé et stockez-la en secret CI. |
ERROR_ZERO_BALANCE |
Solde sous le minimum par tâche. | Rechargez et ajoutez une alerte de solde. |
| Token refusé | Token appliqué dans une autre session. | Gardez résolution et envoi dans le même contexte. |
FAQ
L'extension CaptchaAI fonctionne-t-elle avec Selenium et Playwright ?
Oui. Vous chargez l'extension via un profil dédié et l'argument --load-extension, avec Selenium comme avec Playwright. Seule l'ouverture du navigateur change.
CaptchaAI prend-il en charge hCaptcha pour mes tests QA ?
Non — pas encore pris en charge, ni hCaptcha ni FunCaptcha (Arkose Labs). CaptchaAI couvre en revanche reCAPTCHA v2/v3, Cloudflare Turnstile et Challenge, GeeTest v3, l'OCR et les grilles d'images.
Quel plan CaptchaAI choisir pour une suite de tests en CI ?
Commencez par le plan BASIC ($15/mois, 5 threads), suffisant pour une suite QA en parallèle modéré. La facturation par thread inclut des résolutions illimitées : vous montez de palier quand vos jobs le nécessitent.
Guides connexes
- Démarrage rapide CaptchaAI
- QA CAPTCHA en environnements autorisés
- Tester l'endpoint API sur vos formulaires
- Résolution CAPTCHA en CI
- Résoudre reCAPTCHA v2 via l'API
Fiabilisez vos workflows CAPTCHA avec une méthode reproductible. – Obtenez votre clé CaptchaAI.
