Utiliser le CLI Bright Data avec Claude Code, Codex CLI et d’autres agents IA locaux

Dans cet article, vous apprendrez :

• Pourquoi les agents IA bénéficient d’outils d’accès web de niveau entreprise et pourquoi les exposer via un CLI est une approche efficace.
• Comment installer et configurer le CLI Bright Data localement.
• Instructions et bonnes pratiques pour permettre aux agents IA disposant d’un accès shell, tels que Claude Code, Codex CLI et Gemini CLI, d’utiliser le CLI Bright Data.
• Les différences clés entre CLI, MCP et Agent Skills pour fournir des capacités web aux solutions IA.

Commençons !

Les agents IA ont besoin d’un accès fiable au web

Les agents IA sont de plus en plus sollicités pour effectuer des tâches concrètes, dont beaucoup nécessitent un accès au web. Pour surmonter les limitations de connaissance des LLM causées par des données d’entraînement statiques, ils ont également besoin de pouvoir explorer librement les sources en ligne.

Pour cette raison, la plupart des grands fournisseurs de LLM proposent des capacités de recherche web intégrées. Cependant, ces outils peinent souvent en termes de fiabilité et d’échelle. Ils échouent fréquemment face aux sites protégés par des systèmes anti-bot comme les CAPTCHA, les limites de débit et les vérifications d’empreintes.

Pour les cas d’usage en production, les agents IA ont besoin d’outils de niveau entreprise pour récupérer des données web de manière fiable et interagir avec des pages web.

Pourquoi le CLI est une interface naturelle pour les agents IA

L’une des façons les plus efficaces d’exposer des outils web aux agents IA est via le CLI. La raison est que la plupart des LLM ont été largement entraînés sur l’utilisation du shell. Ils sont donc déjà familiers avec les flux de travail CLI courants.

Ils peuvent découvrir des commandes avec --help, enchaîner plusieurs commandes, interpréter les sorties, récupérer après des erreurs et automatiser des flux de travail complexes. Cela rend les intégrations basées sur CLI flexibles, légères et très compatibles avec l’IA moderne.

CLI Bright Data : accès web de niveau entreprise pour les agents IA

Le CLI Bright Data apporte l’infrastructure de données web de Bright Data directement dans le terminal. Il expose notamment des commandes pour rechercher, scraper, découvrir, extraire des données structurées et automatiser les interactions avec le navigateur.

Remarque : Explorez le code du CLI Bright Data sur GitHub.

Parmi ses commandes les plus populaires :

Ce qui différencie cet outil CLI, c’est qu’il est propulsé par l’infrastructure de Bright Data, construite sur un réseau de plus de 400 millions d’IPs résidentielles. Cette infrastructure mondiale est conçue pour des charges de travail à grande échelle et de qualité production. Elle offre une disponibilité de 99,99 %, atteint un taux de succès de 99,95 % et inclut des capacités intégrées de contournement anti-bot pour accéder même aux sites les plus complexes.

Grâce à cela, les agents IA utilisant le CLI Bright Data peuvent explorer et interagir avec le web à grande échelle, même face à des sites complexes.

Comment démarrer avec le CLI Bright Data

La section suivante vous guide à travers le processus de configuration du CLI Bright Data sur votre machine.

Vous pouvez également consulter le guide officiel d’installation et de configuration ou lire notre article dédié au CLI Bright Data.

Prérequis

Pour exécuter le CLI Bright Data localement, vous avez besoin de :

• Node.js version 20+ installé localement (la dernière version LTS est recommandée).
• Un compte Bright Data (vous pouvez en créer un nouveau gratuitement).

Important : Le CLI Bright Data inclut 5 000 requêtes gratuites par mois, vous pouvez donc démarrer sans abonnement Bright Data.

Étape n°1 : Installer le CLI Bright Data

Pour installer le CLI Bright Data sur n’importe quelle plateforme, exécutez :

npm install -g @brightdata/cli

Cette commande installe le package npm @brightdata/cli globalement sur votre système.

Sinon, sur Linux ou macOS, vous pouvez l’installer [en utilisant le script shell officiel](https://github.com/brightdata/cli?tab=readme-ov-file#macos, linux) :

curl -fsSL https://cli.brightdata.com/install.sh | sh

Une fois l’installation terminée, la commande brightdata (ou son alias plus court, bdata) sera disponible globalement.

Pour vérifier que le CLI a été installé avec succès, vérifiez sa version avec le flag --version (ou -v) :

brightdata, version

Ou utilisez la commande abrégée :

bdata, version

Vous devriez voir une sortie similaire à :

0.3.2

Bien joué ! Le CLI Bright Data est maintenant installé. Connectez-le ensuite à votre compte Bright Data.

Étape n°2 : Lier votre compte Bright Data

Il est temps d’authentifier le CLI Bright Data avec votre compte Bright Data. Pour ce faire, exécutez :

bdata login

Cette commande ouvre automatiquement votre navigateur par défaut et vous redirige vers la page de connexion Bright Data. Si le navigateur ne s’ouvre pas, copiez l’URL affichée dans le terminal et collez-la dans votre navigateur. Suivez ensuite les instructions pour vous authentifier avec votre compte Bright Data via OAuth.

Remarque : Si votre machine n’a pas accès à un navigateur graphique, exécutez plutôt cette commande :

bdata login, device

Cette commande affiche une URL de vérification et un code à usage unique. Ouvrez l’URL depuis n’importe quel appareil disposant d’un navigateur, entrez le code et complétez le processus d’authentification. Une fois terminé, la session CLI sur votre machine sera authentifiée.

Après vous être connecté, vous devriez voir une page de confirmation comme celle-ci :

Une fois l’authentification terminée, le CLI génère une clé API Agent Bright Data :

Cette clé API spéciale est stockée localement et utilisée par le CLI pour authentifier de manière sécurisée les requêtes vers les services Bright Data.

Si vous souhaitez vous déconnecter et supprimer les identifiants stockés, exécutez :

bdata logout

Parfait ! Vous êtes prêt à accéder au web directement depuis votre terminal.

Étape n°3 : Tester la configuration du CLI Bright Data

Pour vérifier que le CLI Bright Data fonctionne correctement, exécutez la commande suivante :

bdata scrape "https://example.com/"

Cela appelle la commande scrape du CLI pour récupérer le contenu de https://example.com/. En coulisses, elle :

1. Envoie la requête via l’API Web Unlocker de Bright Data.
2. Récupère la page.
3. Retourne le contenu extrait en Markdown (le format de sortie par défaut).

Remarque : Markdown est un excellent format pour l’ingestion par les LLM, démontrant que le CLI Bright Data est conçu pour les flux de travail IA.

Vous devriez voir cette sortie :

Cela correspond à la représentation Markdown optimisée pour les LLM de la page cible :

Pour explorer toutes les commandes et options disponibles du CLI Bright Data, consultez la documentation officielle.

Mission accomplie ! Le CLI Bright Data est maintenant installé, authentifié et prêt à l’emploi.

Instruire les agents IA locaux à utiliser le CLI Bright Data pour les tâches web

Maintenant que le CLI Bright Data est disponible sur votre machine, vous pouvez demander à votre agent IA préféré de l’utiliser pour des tâches web.

La section suivante s’applique à toute solution d’agent IA disposant d’un accès shell. Cela inclut les agents basés sur CLI tels que Claude Code, Codex CLI, Gemini CLI, OpenCode, Aider, Pi et autres. Elle couvre également les assistants IA de bureau comme Claude Desktop et goose, ainsi que d’autres frameworks d’agents IA comme OpenClaw, ZeroClaw et solutions similaires.

L’objectif est de fournir à ces agents IA le contexte dont ils ont besoin pour utiliser de manière autonome le CLI Bright Data pour la récupération de données web, le scraping, la recherche et les tâches d’automatisation de navigateur.

Suivez les instructions ci-dessous !

Prérequis

Avant de commencer, assurez-vous d’avoir :

• Le CLI Bright Data installé et configuré localement.
• Un agent IA (par exemple, Claude Code, Claude Desktop, Gemini CLI, Codex, OpenCode, etc.) configuré sur votre machine.

Note : Les chapitres ci-dessous utilisent Claude Code comme exemple, mais toute autre solution d’agent IA disposant d’un accès shell fonctionnera. Aucune modification de l’approche globale n’est requise.

Étape n°1 : Activer l’accès shell

Premièrement, votre agent IA a besoin d’un accès au shell système. Si un agent IA ne peut pas interagir avec l’environnement terminal sous-jacent et exécuter des commandes, il ne peut pas invoquer le CLI Bright Data.

La plupart des solutions d’agents IA modernes disposent déjà d’un accès shell intégré, généralement combiné à un système de permissions demandant une confirmation avant d’exécuter des commandes. Cependant, certains agents désactivent l’accès à l’exécution de commandes.

Si l’accès shell est désactivé, consultez la documentation de l’agent et activez-le avant de continuer. Pour des raisons de sécurité, il est recommandé de configurer l’agent dans un mode nécessitant une approbation avant d’exécuter des commandes terminal.

Étape n°2 : Fournir le contexte sur le CLI Bright Data

Votre agent IA peut ne pas savoir ce qu’est le CLI Bright Data ou pourrait en déduire incorrectement l’objectif lorsque vous le mentionnez dans un prompt. Pour réduire le risque d’hallucinations, fournissez à l’agent un contexte initial sur l’outil.

Commencez avec le prompt suivant :

From now on, assume the Bright Data CLI is installed and available through the `bdata` command.

You can use it to:
- Scrape websites.
- Search the web.
- Extract structured data from 40+ supported platforms.
- Control remote browsers for browser automation.
- Perform other web data retrieval tasks.

Whenever a task requires web data or browser automation, consider whether the Bright Data CLI is the most appropriate tool before using other approaches.

Cela fournit à l’agent IA les informations dont il a besoin pour comprendre ce qu’est le CLI Bright Data et quand il doit être utilisé.

Notez que le prompt mentionne uniquement la commande bdata plutôt que la commande plus longue brightdata. Cela simplifie les instructions et évite toute confusion potentielle lors de l’interaction avec le CLI.

Exécutez le prompt dans votre agent IA, et la sortie ressemblera à quelque chose comme ceci :

Merveilleux ! Votre agent IA local connaît maintenant le CLI Bright Data.

Étape n°3 : Instruire l’agent IA sur l’utilisation efficace du CLI

La plupart des LLM savent déjà comment interagir avec les outils CLI. Cependant, il est toujours recommandé d’instruire explicitement l’agent IA sur la manière d’utiliser correctement le CLI Bright Data.

Pour cette raison, exécutez le prompt ci-dessous :

When using the Bright Data CLI, do not assume command names, arguments, or options.

Always use `bdata, help` and `<command> --help` (or `-h`) to discover the available commands, understand their syntax, and determine the correct flags before executing them.

Cela devrait suffire à guider l’agent IA vers l’utilisation correcte du CLI Bright Data.

Il n’est pas nécessaire de fournir à l’agent l’intégralité de la documentation CLI ou de décrire manuellement chaque commande disponible. Le flag intégré --help (-h) offre toutes les informations dont l’agent a besoin pour découvrir et utiliser le CLI.

Conseil : Optionnellement, envisagez de fournir des conseils supplémentaires sur quand utiliser une commande plutôt qu’une autre, selon les exigences spécifiques de la tâche.

L’agent IA devrait répondre avec quelque chose de similaire à :

Pour comprendre pourquoi les indications dans les prompts sont suffisantes, essayez cette commande dans le terminal :

bdata, help

Remarquez comment cette commande liste toutes les commandes disponibles du CLI Bright Data :

Ensuite, inspectez la sortie --help pour une commande spécifique :

bdata search, help

Encore une fois, remarquez le niveau de détail fourni :

La sortie inclut même des exemples que l’agent IA peut adapter à différents cas d’usage.

Ainsi, en appelant des commandes avec --help (ou -h), l’agent reçoit toutes les informations nécessaires pour utiliser avec succès les commandes du CLI Bright Data.

Formidable ! Votre agent IA dispose maintenant du contexte et des instructions nécessaires pour tirer le meilleur parti du CLI Bright Data.

Étape n°4 : Utiliser le CLI Bright Data pour les tâches web

Vous pouvez maintenant demander à votre agent IA de gérer l’une des nombreuses tâches liées au web prises en charge par le CLI Bright Data.

Par exemple, exécutez la tâche suivante :

Use the Bright Data CLI to research the best AI startups in Europe. Select 2,3 relevant sources and scrape their content. Based on these sources, identify the top 3 AI startups in Europe. Then, search for each startup's Crunchbase company profile and extract structured information from it. Finally, create a report describing what each company does and include the relevant Crunchbase data.

Cette tâche implique la recherche web, le scraping web et l’extraction de données structurées. C’est donc un excellent exemple de ce qu’un agent IA peut accomplir avec le CLI Bright Data.

Exécutez-la dans Claude Code, et vous devriez voir un flux de travail similaire à celui-ci :

Plus précisément, l’agent IA :

1. A appelé bdata, help pour découvrir les commandes disponibles dans le CLI Bright Data.
2. A identifié bdata search comme la commande appropriée pour la recherche web.
3. A utilisé bdata search pour effectuer une recherche « best AI startups Europe 2026 » sur Google et récupéré un SERP au format JSON.
4. A analysé les résultats de recherche pour identifier les articles les plus pertinents.
5. A identifié bdata scrape comme la commande appropriée pour extraire le contenu des pages web.
6. A appelé bdata scrape, help pour comprendre la syntaxe de la commande et les options disponibles.
7. A utilisé bdata scrape sur les URL des articles sélectionnés pour récupérer leur contenu au format Markdown.
8. A analysé le contenu Markdown et identifié les 3 meilleures startups IA mentionnées dans les sources.
9. A identifié bdata pipelines comme la commande appropriée pour extraire des données structurées depuis les profils Crunchbase.
10. A appelé bdata pipelines, help pour comprendre la syntaxe de la commande.
11. A utilisé bdata search pour trouver la page de profil Crunchbase de chaque startup.
12. A utilisé bdata pipelines sur chaque profil Crunchbase pour extraire des données d’entreprise structurées au format JSON. En coulisses, cela s’appuie sur le Scraper Crunchbase de Bright Data.
13. A combiné toutes les informations extraites dans un rapport Markdown final.

Le rapport final généré devrait ressembler à :

Le résultat produit combine des informations provenant à la fois des articles originaux et des données structurées extraites de Crunchbase.

Et voilà ! Grâce aux prompts fournis, votre agent IA peut maintenant utiliser de manière autonome le CLI Bright Data pour effectuer des tâches complexes nécessitant un accès web.

CLI vs MCP vs Agent Skills : choisir la bonne approche pour les agents IA

Outre le CLI Bright Data, les agents peuvent également accéder aux mêmes capacités via le Bright Data Web MCP ou les Agent Skills. Cela soulève une question importante : quelle approche choisir ?

La réponse dépend de votre flux de travail, de votre architecture et du niveau de contrôle requis. CLI, MCP et Agent Skills résolvent des problèmes différents et opèrent à différentes couches de la stack IA.

Comparez les trois méthodes dans le tableau ci-dessous :

N’oubliez pas que ces approches ne sont pas mutuellement exclusives. En fait, elles fonctionnent mieux lorsqu’elles sont combinées.

En détail, certaines compétences Bright Data fournissent des connaissances sur quand et comment utiliser les outils Bright Data Web MCP ou les commandes CLI Bright Data. Cela donne à l’agent à la fois les capacités d’exécution et le contexte nécessaire pour choisir le bon flux de travail.

Pour apprendre à intégrer des solutions IA populaires avec le CLI Bright Data, Web MCP et/ou Agent Skills, consultez notre blog ou la documentation officielle.

Conclusion

Dans cet article de blog, vous avez compris pourquoi les agents IA bénéficient de la capacité d’explorer le web. Vous avez également réalisé pourquoi les outils CLI offrent des avantages par rapport aux autres méthodes d’intégration. En détail, vous avez vu ce qu’est le CLI Bright Data et comment il prend en charge le scraping web, la recherche, la découverte et les tâches d’automatisation.

Vous avez appris à installer le CLI Bright Data sur votre machine et à instruire votre agent IA préféré pour l’utiliser dans des tâches nécessitant un accès web. Cela ouvre un large éventail de cas d’usage et représente l’une des nombreuses façons dont Bright Data prend en charge les intégrations IA.

Créez un compte gratuit dès aujourd’hui et profitez du niveau gratuit (5 000 requêtes/mois) pour essayer le CLI Bright Data !

FAQ

Le CLI Bright Data dispose-t-il d’un plan gratuit ?

Oui, le CLI Bright Data est proposé avec un niveau gratuit. Chaque nouveau compte Bright Data reçoit 5 000 crédits gratuits par mois partagés entre les produits pris en charge. Ceux-ci incluent également Web Unlocker API, API SERP, Web Scraper API et Scraper Studio. Aucune carte de crédit ni engagement n’est requis pour démarrer.

Quels agents IA peuvent se connecter au CLI Bright Data ?

Tout agent IA disposant d’un accès shell peut se connecter au CLI Bright Data. Cela inclut les agents CLI comme Claude Code, Codex CLI, Gemini CLI, OpenCode, ainsi que les agents de bureau et assistants IA ayant accès au terminal.

Quels sont les avantages d’utiliser le CLI Bright Data plutôt que MCP et Agent Skills dans un agent IA ?

Le CLI Bright Data offre aux agents IA un moyen léger et flexible d’accéder aux outils web via des commandes shell familières. Il peut nécessiter moins de surcharge de contexte que MCP. De plus, il tire parti des connaissances shell existantes des LLM. Gardez à l’esprit que les trois approches sont complémentaires et peuvent être utilisées ensemble pour une flexibilité maximale.