Guide
CapSolver AI
CapSolver pour les agents d'IA

CapSolver pour les agents IA

Votre agent peut naviguer, cliquer et taper. Mais une grande partie des tâches du monde réel se bloquent devant un mur de vérification humaine – un reCAPTCHA, un tourniquet Cloudflare, une vérification des empreintes digitales de l’appareil – et une exécution en plusieurs étapes par ailleurs parfaite s’arrête. CapSolver efface ce mur en ligne, dans votre flux de travail existant, et redonne le contrôle directement à l’agent pour que la tâche se termine.

Cette page explique ce que cela signifie en pratique, où CapSolver s’intègre dans une pile d’agents et comment choisir un chemin d’intégration. Si vous préférez passer directement au code, consultez Introduction et démarrage rapide, le Core SDK, les Agent Tools et le MCP Service.

L’écart de production

Les agents font une démonstration magnifique. Dans une démo, l’agent réserve le vol, enrichit le prospect ou récupère le dossier. En production, il s’agit d’un défi de vérification et un membre de l’équipe doit intervenir. Le même échec se présente sous quatre formes reconnaissables:

  • Interruption du flux de travail: un seul défi de vérification interrompt une tâche en plusieurs étapes par ailleurs complète.
  • Repli manuel: les équipes gardent discrètement des agents “autonomes”, intervenant dès que l’un d’entre eux est bloqué.
  • Aucune couche de récupération: les agents de navigation peuvent cliquer et taper, mais rien ne ferme la boucle lorsque la vérification se déclenche.
  • Aucune observabilité — la production a besoin d’ID de demande, de tentatives et d’états d’erreur clairs, et non d’un jeton renvoyé par une boîte noire.

Dans les tests réels de CapSolver, une fraction significative des tâches des agents (de l’ordre de 30 % ou plus) se bloque sur les contrôles CAPTCHA, Cloudflare ou d’empreintes digitales. C’est l’écart que CapSolver est conçu pour combler.

Ce que CapSolver ajoute: une couche de récupération, pas une réécriture

CapSolver ne remplace pas votre infrastructure d’agent ou votre navigateur. Il se situe entre l’agent et le mur, résout le défi et renvoie le résultat en ligne afin que la tâche initiale puisse continuer. Il n’y a pas de réarchitecture: vous conservez votre orchestration, votre session de navigateur et votre logique métier exactement telles qu’elles sont, et vous ajoutez la couche qu’elles ne couvrent pas.

Deux choix de conception en font un script de production plutôt qu’un script unique:

  • Conçu pour la logique et l’observabilité des nouvelles tentatives. Une résolution renvoie un jeton utilisable et un identifiant de requête, de sorte que chaque défi est traçable: vous pouvez attribuer, réessayer et déboguer les blocages au lieu de deviner pourquoi un agent s’est arrêté.
  • La résolution s’effectue dans le cloud. La détection, l’assemblage des paramètres et le remplissage des résultats s’effectuent de votre côté via le SDK; la reconnaissance réelle est effectuée par le service AI de CapSolver. Votre code (ou votre modèle) décide quoi faire; CapSolver se charge de le résoudre.

Le SDK couvre actuellement les types de vérification que les agents rencontrent le plus souvent – ​​reCAPTCHA v2 et v3 (y compris Enterprise) et Cloudflare Turnstile – tandis que le service CapSolver sous-jacent prend en charge un catalogue beaucoup plus large de types de défis. Consultez la référence du type de tâche pour la liste complète actuelle.

Comment ça marche

CapSolver divise «passer un mur» en cinq étapes claires qui s’inscrivent dans un flux existant:

  1. Détecter: le flux de votre agent ou de votre navigateur rencontre un défi de vérification humaine.
  2. Résoudre — CapSolver relève le défi pour tous les types CAPTCHA pris en charge.
  3. Récupérer: le résultat est renvoyé en ligne dans votre flux d’agent.
  4. Continuer: l’agent reprend et termine la tâche d’origine, sans échec.
  5. Observer: un ID de demande, un état et des informations sur les erreurs permettent de tracer chaque résolution.

Choisissez le chemin de votre pile

CapSolver est livré sous forme de trois packages Python ainsi que d’intégrations de framework natives, afin que vous puissiez choisir le niveau d’abstraction qui correspond à la façon dont vous construisez. Tous les trois sont superposés sur un seul moteur: choisissez l’ajustement le plus proche et expédiez-le en quelques minutes.

CheminIdéal pourCe que vous obtenez
Service MCP ( capsolver-mcp )Tout client compatible MCP — Claude Desktop, Claude Code, Cursor, ClineUn serveur MCP standard qui expose automatiquement les outils de résolution, avec un code d’intégration proche de zéro. Le moyen le plus rapide d’entrer. Consultez le [Guide du service MCP] (./mcp-service/).
Outils d’agent ( capsolver-agent )LangChain, le SDK OpenAI Agents, l’utilisation du navigateur ou toute boucle d’agent personnaliséeDes schémas d’outils indépendants du framework, un exécuteur et des outils LangChain prêts à l’emploi : laissez le modèle décider quand résoudre. Consultez le Guide de l’agent.
SDK de base ( capsolver-core )Scripts, robots d’exploration et automatisation sur mesure de PlaywrightLe moteur lui-même: détecte, lit les paramètres, résout et remplit, sans aucun LLM requis. Consultez le Guide du SDK Core.

Les intégrations du framework sont mappées sur ces packages: un agent Utilisation du navigateur enregistre la résolution comme une action qui récupère la session chaque fois qu’une vérification apparaît en cours de tâche; une application LangChain ou OpenAI Agents SDK appelle CapSolver comme un outil avec un traçage complet; et un flux Playwright résolvant directement l’assurance qualité, la RPA et l’automatisation de bout en bout sur mesure.

Fonctionne au-dessus de l’infrastructure de votre navigateur

CapSolver est additif. Vous apportez le navigateur (Browserbase, Steel, Playwright, Puppeteer, Selenium ou le vôtre) et CapSolver efface la partie qu’il ne peut pas parcourir seul. Une adresse IP propre et un nouveau navigateur mettent un agent au mur; CapSolver y parvient. Nous ajoutons la couche que votre pile ne couvre pas plutôt que de remplacer la pile.

À qui est-ce destiné

Le problème de vérification apparaît de la même manière pour tous les agents verticaux de production de bâtiments:

  • Automatisation des ventes: les agents de sensibilisation et de prospection sont bloqués pour enrichir les prospects et collecter des signaux à grande échelle, de sorte que les pipelines qui devraient fonctionner sans surveillance pendant la nuit sont bloqués.
  • Technologie RH et recrutement: les agents de recherche de candidats traînent derrière la vérification sur les sites d’emploi et les profils.
  • RegTech et conformité: les agents de révision automatisés doivent accéder à des portails fermés pour extraire les dépôts et les enregistrements dans les délais.
  • Outils d’assurance qualité et de test: les agents de test de bout en bout s’interrompent sur CAPTCHA dans les flux de connexion de préparation et de production.

Dans chaque cas, le correctif est le même: une couche de récupération qui permet de terminer le travail autorisé et dirigé par l’utilisateur sans intervention humaine.

Conçu pour une automatisation responsable

CapSolver est une infrastructure pour le travail légitime et autorisé par l’utilisateur – le même rôle qu’une API de paiement joue pour un produit SaaS ou qu’une API de messagerie joue pour les communications. Un agent agit pour le compte d’un utilisateur réel qui l’a autorisé ; le problème n’est pas l’agent, c’est que l’automatisation légitime et dirigée par l’utilisateur continue d’être signalée à tort comme un robot. CapSolver résout cette erreur de classification afin que le travail autorisé puisse se terminer.

Ce positionnement est accompagné de garde-corps:

  • Autorisé par l’utilisateur uniquement — conçu pour l’automatisation à laquelle un utilisateur est explicitement dirigé et consenti.
  • Respecte les conditions du site — destiné à prendre en charge les flux de travail des agents légaux et conformes aux conditions.
  • Piste d’audit complète: chaque résolution est enregistrée avec un ID de demande à des fins de responsabilité et d’examen.
  • Politique d’utilisation claire et acceptable: les directives publiées définissent à quoi sert et ne sert pas le service. Voir notre déclaration de conformité et notre position sur les abus.

Modèle de tarification

CapSolver est basé sur l’utilisation: vous payez par défi résolu avec succès, sans minimum mensuel et sans frais pour les tentatives infructueuses. Un niveau gratuit vous permet de tester votre propre flux de travail avant de vous engager, des remises sur volume s’appliquent à mesure que vous évoluez, et les équipes d’entreprise qui exécutent des agents à grande échelle peuvent demander un SLA, une intégration personnalisée et un canal d’assistance dédié. Voir pricing pour les détails actuels.

Commencer

  1. Créez un compte et obtenez une clé API — inscrivez-vous sur le site Web CapSolver, copiez votre clé depuis le tableau de bord et ajoutez des fonds. Chaque résolution réussie consomme de l’équilibre.
  2. Choisissez un chemin — le Service MCP pour une utilisation plug-and-play dans un client IA, les Agent Tools pour permettre à un appel de modèle de se résoudre lui-même, ou le Core SDK pour les scripts et l’automatisation personnalisée.
  3. Déposez-le dans votre flux — suivez le guide de correspondance et ajoutez la couche qui manquait à votre agent.

Si votre agent touche le vrai Web, il se heurtera à ce mur. CapSolver est la couche qui le fait passer.