Bright Data
officielDécouvrez, extrayez et interagissez avec le web - une interface unique pour un accès automatisé à l'ensemble de l'internet public.
Que pouvez-vous faire avec Bright Data MCP ?
- Recherche Web — Demandez à votre assistant d’effectuer des recherches sur Bing ou Google et de renvoyer des résultats structurés avec des liens, des titres et des descriptions.
- Extraction de pages — Récupérez n’importe quelle URL au format Markdown, texte, HTML ou ld_json épuré, avec détection des bots et gestion des CAPTCHA intégrées.
- Données structurées des plateformes — Trouvez et exécutez des extracteurs préconfigurés pour des sites comme Amazon, LinkedIn, TikTok et npm afin d’obtenir du JSON épuré au lieu d’analyser du HTML.
- Automatisation du navigateur — Naviguez, cliquez, saisissez du texte, faites défiler les pages et prenez des captures d’écran dans une session de navigateur à distance pour les sites interactifs ou protégés par une connexion.
- Collecte de réponses de LLM — Envoyez des prompts à ChatGPT ou Perplexity et récupérez leurs réponses pour comparer la façon dont chacun décrit une marque.
- Collecte par lots — Effectuez jusqu’à 5 recherches ou extrayez jusqu’à 5 URL en un seul appel pour collecter des données en parallèle.
Documentation
Bright Data MCP
Recherche sur le Web, extraction de pages, extraction de données structurées et automatisation de navigateur pour les agents IA et les LLM via le Model Context Protocol.
Compatible avec les agents IA, les agents de programmation, les assistants conversationnels et tout client compatible avec MCP.
Démarrage rapide • Tarifs • Cas d’utilisation • Outils • Compétences des agents • Documentation • Assistance
Offre gratuite : 5 000 requêtes par mois. Aucune carte bancaire requise. Renouvellement mensuel.
Présentation
Le serveur MCP Bright Data donne aux agents IA un accès en temps réel aux données publiques du Web. Il propose 30 outils couvrant les domaines suivants :
- Recherche sur le Web — résultats Bing et Google sous forme de données structurées
- Extraction de pages — toute URL au format Markdown ou HTML, avec détection des bots, résolution des CAPTCHA et rotation des proxys gérées automatiquement à chaque requête
- Données structurées (Web Scraper API) — données JSON propres issues de plus de 1 200 scrapers préconfigurés : Amazon, LinkedIn, Instagram, TikTok, YouTube, X, Reddit, Facebook, Crunchbase, Zillow, npm, PyPI et bien d’autres, sans analyse du HTML. Six outils permettent de trouver et d’exécuter n’importe lequel d’entre eux
- Automatisation de navigateur — naviguer, cliquer, saisir du texte, prendre des captures d’écran et lire des pages dans une session de navigateur distante
- Collecte de réponses de LLM — envoyer des prompts à ChatGPT et Perplexity et récupérer leurs réponses sous forme de données structurées
Chaque requête passe par l’infrastructure de déblocage de Bright Data. Les pages qui bloquent les clients HTTP ordinaires (détection des bots, CAPTCHA, limites de débit, restrictions géographiques) sont donc accessibles normalement. Aucune configuration de proxy, aucune maintenance de navigateur headless et aucune logique de nouvelle tentative à écrire.
Deux options de déploiement : un serveur distant hébergé (une URL, aucune installation) ou une instance locale via npx @brightdata/mcp.
Démarrage rapide
Serveur hébergé — aucune installation. Ajoutez cette URL à votre client MCP :
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE
Récupérez votre jeton API dans les paramètres de votre compte Bright Data. Les nouveaux comptes bénéficient de 5 000 requêtes gratuites par mois.
Paramètres d’URL facultatifs :
| Paramètre | Description | Exemple |
|---|---|---|
groups=<ids> | Limiter à des groupes d’outils spécifiques (tous les outils par défaut) | ...&groups=scrapers,browser |
tools=<names> | Limiter à des outils spécifiques | ...&tools=search_engine,scrape_as_markdown |
Claude Desktop
- Accédez à : Settings → Connectors → Add custom connector
- Nom :
Bright Data - URL :
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - Cliquez sur « Add »
Ou exécutez-le localement :
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>"
}
}
}
}
Claude Code
claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
Cursor
Ajoutez-le à ~/.cursor/mcp.json :
{
"mcpServers": {
"brightdata": {
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
VS Code
Ajoutez-le à .vscode/mcp.json :
{
"servers": {
"brightdata": {
"type": "http",
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Windsurf
Ajoutez-le à ~/.codeium/windsurf/mcp_config.json :
{
"mcpServers": {
"brightdata": {
"serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Gemini CLI
Ajoutez-le à ~/.gemini/settings.json :
{
"mcpServers": {
"brightdata": {
"httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Zed
Ajoutez-le à vos paramètres Zed :
{
"context_servers": {
"brightdata": {
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Warp
Accédez à Settings > MCP Servers > Add MCP Server et ajoutez :
{
"brightdata": {
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
Autres clients (npx local)
Pour tout client prenant en charge les serveurs MCP locaux :
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>"
}
}
}
}
Tarifs et offre gratuite
Chaque compte comprend une offre gratuite mensuelle récurrente. Aucune carte bancaire ni aucun engagement ne sont nécessaires pour commencer.
5 000 requêtes gratuites par mois, renouvelées le 1er de chaque mois. Les requêtes non utilisées ne sont pas reportées. Pour les comptes d’équipe, l’offre gratuite est partagée entre tous les utilisateurs du compte.
Inclus gratuitement :
- Récupérer n’importe quelle page Web et l’extraire au format Markdown
- Accéder à plus de 60 scrapers préconfigurés pour les domaines populaires
- Recherche sur le Web (Bing, Google)
- Déblocage du Web (contournement de la détection des bots, résolution des CAPTCHA, rotation des proxys)
- Automatisation de navigateur
- Ciblage géographique
Au-delà de l’offre gratuite — paiement à l’utilisation, sans engagement :
| Recherche, extraction et collecte | Navigation dans le navigateur | |
|---|---|---|
| Paiement à l’utilisation | 1,50 $ / 1 000 résultats | 8 $ / Go |
- Lorsque les requêtes gratuites sont épuisées, les requêtes s’arrêtent. Aucune facturation surprise — sauf si vous avez déposé des fonds
- L’ajout d’une carte bancaire sert uniquement à la vérification ; aucun montant ne vous sera facturé, sauf si votre offre gratuite est épuisée et que vous avez déposé des fonds
- Définissez un plafond de dépenses dans le panneau de contrôle afin que l’utilisation à la demande ne dépasse jamais votre budget
Tarifs complets, forfaits volume et offres entreprise →
Cas d’utilisation
Recherche en temps réel
Répondez aux questions à l’aide de données Web en direct plutôt que de données d’entraînement. Effectuez une recherche, puis consultez les sources.
| Tâche | Outils |
|---|---|
| Rechercher des informations récentes sur le Web | search_engine, search_engine_batch |
| Lire une page spécifique au format Markdown épuré | scrape_as_markdown, scrape_batch |
Exemples de prompts : « Quel est le cours actuel de l’action Tesla ? », « Donne-moi les prévisions météo du jour à New York », « Trouve les sources les plus citées sur la réglementation européenne de l’IA au cours des six derniers mois ».
Veille e-commerce
Consultez les données produit sous forme de JSON structuré : prix, disponibilité, note, nombre d’avis, vendeur et images.
| Tâche | Outils |
|---|---|
| Produits, avis et résultats de recherche sur Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara et d’autres boutiques | search_scrapers → get_scraper_details → run_scraper |
| Comparaison des prix entre détaillants | Le même flux avec le scraper Google Shopping |
Exemples de prompts : « Compare le prix de cet ordinateur portable sur Amazon, Walmart et Best Buy », « Donne-moi la note et le nombre d’avis pour l’ASIN B0D2Q9397Y », « Ce produit est-il en stock ? ».
Analyse du marché et des concurrents
Établissez des profils de concurrents à partir de données en direct : financement, effectifs, recrutements, avis clients et pages de tarification.
| Tâche | Outils |
|---|---|
| Financement, taille, effectifs et offres d’emploi des entreprises (Crunchbase, ZoomInfo, LinkedIn) | search_scrapers → run_scraper |
| Avis des clients (Google Maps, Facebook, avis sur les boutiques d’applications) | search_scrapers → run_scraper |
| Pages de tarification des concurrents | scrape_as_markdown, scrape_batch |
| Découverte du marché | search_engine_batch |
Exemple de prompt : « Analyse Notion en tant que concurrent : tarifs, financement, priorités de recrutement et principales plaintes des clients ».
Agents IA avec un accès fiable au Web
Remplacez les outils intégrés de récupération et de recherche qui sont bloqués sur les sites protégés. Chaque requête passe par l’infrastructure de déblocage : les agents ne sont donc pas bloqués par la détection des bots, les CAPTCHA ou les restrictions géographiques.
| Tâche | Outils |
|---|---|
| Remplacement direct de la recherche Web intégrée | search_engine |
| Remplacement direct de la récupération d’URL intégrée | scrape_as_markdown |
| Collecte de données en parallèle (5 à la fois) | search_engine_batch, scrape_batch |
| Sites interactifs (écrans de connexion, défilement infini, contenu dynamique) | scraping_browser_* (14 outils) |
Agents de programmation
Obtenez des données de registres de paquets à la demande — sans scraping ni caches obsolètes.
| Tâche | Outils |
|---|---|
| Version, README et métadonnées des paquets npm et PyPI | run_scraper avec le scraper npmjs ou pypi (trouvez-les avec search_scrapers) |
| Lire des fichiers de dépôts GitHub | run_scraper avec le scraper de dépôts GitHub |
Exemples de prompts : « Quelle est la dernière version d’express sur npm ? », « Récupère le README du paquet PyPI langchain-brightdata ».
GEO et visibilité de marque
Envoyez des prompts aux principaux LLM et récupérez leurs réponses sous forme de données structurées. Mesurez la façon dont les assistants IA décrivent votre marque, les sources qu’ils citent et leurs recommandations — la boucle de rétroaction pour l’optimisation pour les moteurs génératifs.
| Tâche | Outils |
|---|---|
| Réponses de ChatGPT avec citations et recommandations | chatgpt_ai_insights |
| Réponses de Perplexity avec sources | perplexity_ai_insights |
Exemple de prompt : « Demande à ChatGPT et Perplexity “quel est le meilleur fournisseur de proxys” et compare la façon dont chacun nous classe ».
Veille des réseaux sociaux
Données structurées issues de toutes les grandes plateformes : profils, publications, commentaires et indicateurs d’engagement. Chaque plateforme dispose de scrapers par type de données (profils LinkedIn, Reels Instagram, commentaires TikTok, etc.) ; trouvez-les avec search_scrapers et exécutez-les avec run_scraper.
| Plateforme | Exemples de scrapers |
|---|---|
| profils de personnes, profils d’entreprises, offres d’emploi, publications, recherche de personnes | |
| profils, publications, Reels, commentaires | |
| TikTok | profils, publications, boutique, commentaires |
| profils, publications, annonces de la marketplace, avis sur les entreprises, événements | |
| YouTube | vidéos, chaînes, commentaires |
| X (Twitter) | publications, publications par profil |
| publications, commentaires |
Exemple de prompt : « Récupère les 10 dernières publications de ce profil TikTok et résume l’engagement ».
Création de contenu et recherche universitaire
Rassemblez des sources provenant de nombreuses pages en une seule fois, en filtrant selon leur actualité et leur pertinence.
| Tâche | Outils |
|---|---|
| Collecter plusieurs sources en un seul appel | scrape_batch (jusqu’à 5 URL) |
| Actualités et données financières | search_engine avec des requêtes d’actualité, run_scraper avec le scraper Yahoo Finance |
Comparaison
| Fonctionnalité | Bright Data MCP | Serveurs MCP Web courants |
|---|---|---|
| Nombre total d’outils | 30 | 2–10 |
| Extracteurs JSON structurés spécifiques aux plateformes | Plus de 1 200 scrapers préconfigurés couvrant le commerce électronique, les réseaux sociaux, les entreprises, la finance, les voyages et les boutiques d’applications, accessibles via 6 outils | Rares ; scraping générique uniquement |
| Déblocage (contournement de la détection des bots, résolution des CAPTCHA, rotation des proxys) | Intégré à chaque requête | Généralement absent ; blocage sur les sites protégés |
| Moteurs de recherche | Bing, Google | Généralement un seul |
| Automatisation de navigateur | 14 outils, navigateur distant, aucune configuration locale | Limitée ou inexistante |
| Collecte de réponses de LLM (ChatGPT, Perplexity) | Oui | Non proposée |
| Données de registres de paquets (npm, PyPI) | Oui | Non proposées |
| Opérations par lots | 10 recherches ou 10 extractions par appel | Généralement une seule requête |
| Ciblage géographique | Oui | Limité ou inexistant |
| Offre gratuite | 5 000 requêtes/mois, automatisation de navigateur incluse, aucune carte bancaire | Variable ; accès sans clé souvent limité par débit |
Sélection des outils : groupes
Les outils sont organisés en groupes pour que vous ne chargiez que ceux dont vous avez besoin. Moins d’outils signifie moins de contexte à traiter pour votre agent.
- Sans
GROUPSniTOOLS, les 30 outils sont activés. Définir l’un ou l’autre limite le serveur à ces seuls outils GROUPSactive des ensembles d’outils. Valeurs séparées par des virgules :GROUPS="scrapers,browser"(local) ou&groups=scrapers,browser(URL hébergée)TOOLSajoute des outils individuels :TOOLS="scrape_batch,session_stats". Utilisé seul, il active uniquement les outils indiqués- Chaque groupe comprend également
search_engine,scrape_as_markdownetask_brightdata_assistant - L’identifiant de groupe
customest réservé ; utilisezTOOLSpour sélectionner des outils individuellement | ID du groupe | Contenu | Nombre d’outils | |----------|----------|-----------| |scrapers| Rechercher et exécuter n’importe quel scraper préconfiguré de l’API Web Scraper (Amazon, LinkedIn, TikTok, npm, ...) | 6 | |browser| Automatisation de navigateur à distance | 14 | |geo| Collecte des réponses de ChatGPT et Perplexity | 2 | |advanced_scraping| Outils de traitement par lots, statistiques de session | 3 |
Les anciens ID de groupe (ecommerce, social, business, finance, research, app_stores, travel, code) fonctionnent toujours et activent les outils scrapers ; social et business ajoutent également search_dataset et list_dataset_fields. Les anciens noms web_data_* dans TOOLS activent aussi les outils scrapers.
Exemples de configuration
Serveur local avec automatisation de navigateur et outils de traitement par lots :
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>",
"GROUPS": "browser,advanced_scraping"
}
}
}
}
Configuration d’un agent de programmation (Claude Code / Cursor / Windsurf) — données npm, PyPI et GitHub via les scrapers préconfigurés :
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>",
"GROUPS": "scrapers"
}
}
}
}
Référence des outils (30 outils)
Quel outil utiliser
- URL connue, contenu nécessaire :
scrape_as_markdown. Plusieurs URL (jusqu’à 5) :scrape_batch - Besoin de trouver des informations :
search_engine. Plusieurs requêtes (jusqu’à 5) :search_engine_batch - Données structurées d’une plateforme connue (Amazon, LinkedIn, TikTok, npm, PyPI, etc.) :
search_scrapers→get_scraper_details→run_scraper— renvoie du JSON propre, plus rapidement et de manière plus fiable que le scraping de la même page - HTML brut :
scrape_as_markdownavecformat: 'html' - La page nécessite une interaction (clic, saisie, défilement, connexion) : outils
scraping_browser_* - Comment ChatGPT/Perplexity répond à une invite :
chatgpt_ai_insights/perplexity_ai_insights - Question sur Bright Data (produits, zones, erreurs, configuration) :
ask_brightdata_assistant
Remarques sur l’exécution des scrapers :
- Renvoie du JSON structuré, facturé par enregistrement renvoyé
- Les enregistrements contenant un champ
errorexpliquent les entrées qui ont échoué, par exemple une URL de type incorrect - Les résultats peuvent être volumineux. Gardez
limit_per_inputbas pour les méthodesdiscover_by_*et effectuez la collecte en masse dans un sous-agent lorsque votre framework le permet, afin d’éviter que les enregistrements n’inondent la fenêtre de contexte principale - En cas d’échec d’une exécution,
scrape_as_markdownfonctionne sur la même URL comme solution de repli
Recherche et scraping — 5 outils
| Outil | Description | Groupe |
|---|---|---|
search_engine | Recherche sur Bing (par défaut) ou Google. Renvoie du JSON (lien, titre, description), 10 résultats par page. Paramètres : country, page (à partir de 0), time_range (hour, day, week, month, year, any ; Bing prend uniquement en charge day, week, year) | par défaut / tous les groupes |
search_engine_batch | Jusqu’à 5 requêtes de recherche en un seul appel | par défaut / advanced_scraping |
scrape_as_markdown | N’importe quelle URL. Renvoie le contenu au format Markdown (par défaut), texte, HTML ou ld_json | par défaut / tous les groupes |
scrape_batch | Jusqu’à 5 URL en un seul appel. Renvoie le contenu au format Markdown (par défaut), texte, HTML ou ld_json | par défaut / advanced_scraping |
session_stats | Nombre d’utilisations des outils pour la session en cours | par défaut / advanced_scraping |
Web Scraper API — 6 outils
Recherchez et exécutez n’importe lequel des plus de 1 200 scrapers préconfigurés de Bright Data. La liste des scrapers est chargée depuis docs.brightdata.com/scrapers.json et actualisée quotidiennement. Disponible sur le serveur hébergé et le serveur local. Activé par défaut lorsqu’aucun outil ni groupe n’est sélectionné ; sinon, ajoutez le groupe scrapers (&groups=scrapers dans l’URL hébergée, GROUPS=scrapers en local).
Flux habituel : search_scrapers → get_scraper_details → run_scraper. Les exécutions sont facturées par enregistrement ; les méthodes discover_by_* collectent jusqu’à limit_per_input enregistrements par entrée (10 par défaut).
| Outil | Description | Groupe |
|---|---|---|
search_scrapers | Trouver des scrapers par site ou type de données (par ex. « avis Amazon », « linkedin.com »). Renvoie l’ID du jeu de données, le nom, le domaine et les méthodes de collecte | par défaut / scrapers |
get_scraper_details | Description, champs d’entrée, exemple d’entrée et principaux champs de sortie d’une méthode de scraper | par défaut / scrapers |
run_scraper | Exécuter une méthode de scraper. Attend jusqu’à 45 secondes ; si l’exécution est toujours en cours, renvoie un snapshot_id pour vérifier ultérieurement | par défaut / scrapers |
get_scraper_progress | État d’une exécution : démarrage, en cours, prête, échouée ou annulée | par défaut / scrapers |
get_scraper_results | Enregistrements d’une exécution terminée | par défaut / scrapers |
refresh_scrapers | Recharger la liste des scrapers immédiatement au lieu d’attendre l’actualisation quotidienne | par défaut / scrapers |
Automatisation de navigateur — 14 outils
Session de navigateur à distance. Séquence habituelle : naviguer → instantané → interagir par référence → extraire ou prendre une capture d’écran.
| Outil | Description |
|---|---|
scraping_browser_navigate | Ouvrir ou réutiliser une session de navigateur et accéder à une URL |
scraping_browser_go_back | Revenir en arrière |
scraping_browser_go_forward | Avancer |
scraping_browser_snapshot | Instantané ARIA de la page répertoriant les éléments interactifs avec leurs références. Obligatoire avant les actions basées sur une référence |
scraping_browser_click_ref | Cliquer sur un élément à l’aide de sa référence dans le dernier instantané |
scraping_browser_type_ref | Saisir du texte dans un élément à l’aide de sa référence ; possibilité d’appuyer sur Entrée pour envoyer |
scraping_browser_fill_form | Remplir plusieurs champs de formulaire par référence en un seul appel |
scraping_browser_screenshot | Capture d’écran de la page actuelle ; full_page facultatif |
scraping_browser_get_text | Contenu textuel du corps de la page |
scraping_browser_get_html | HTML de la page actuelle |
scraping_browser_scroll | Faire défiler jusqu’en bas de la page |
scraping_browser_scroll_to_ref | Faire défiler jusqu’à un élément pour le rendre visible |
scraping_browser_wait_for_ref | Attendre qu’un élément devienne visible, avec délai d’expiration facultatif |
scraping_browser_network_requests | Requêtes réseau depuis le chargement de la page : méthode, URL, état |
Les références proviennent du dernier instantané. Si la page change après un clic ou une navigation, prenez un nouvel instantané avant la prochaine action basée sur une référence. Pour les pages statiques, scrape_as_markdown est plus rapide et moins coûteux qu’une session de navigateur.
Visibilité GEO et LLM — 2 outils
| Outil | Entrée | Renvoie |
|---|---|---|
chatgpt_ai_insights | Invite | Réponse de ChatGPT au format Markdown |
perplexity_ai_insights | Invite | Réponse de Perplexity au format Markdown |
À utiliser pour l’optimisation pour les moteurs génératifs (suivi de la manière dont les LLM décrivent votre marque) et les workflows d’évaluation par un LLM.
Recherche dans les jeux de données — 2 outils
Recherche filtrée dans les jeux de données LinkedIn stockés ; renvoie immédiatement les enregistrements correspondants, sans exécution de scraper.
| Outil | Description | Groupe |
|---|---|---|
list_dataset_fields | Champs filtrables d’un jeu de données (nom, type, description). À appeler avant search_dataset | par défaut / social, business |
search_dataset | Enregistrements correspondant à un filtre, jusqu’à 10 par appel, avec un curseur pour en obtenir davantage | par défaut / social, business |
Assistant Bright Data — 1 outil
| Outil | Description | Groupe |
|---|---|---|
ask_brightdata_assistant | Demandez à Sophie, l’assistante d’assistance de Bright Data, des informations sur les produits, les API, les zones, les erreurs ou la configuration du compte. Transmettez le dialog_id renvoyé pour poser une question de suivi dans le même fil | par défaut / tous les groupes |
Référence complète des outils dans la documentation →
Compétences d’agent
Des compétences prêtes à l’emploi qui apprennent à votre agent à utiliser correctement ce serveur MCP. La collection complète se trouve sur github.com/brightdata/skills — 21 compétences couvrant l’orchestration MCP, la veille concurrentielle, la comparaison des prix, la veille de marque, les audits SEO, la création de scrapers, les pipelines RAG et bien plus encore.
Trois des compétences les plus utiles :
| Compétence | Fonction |
|---|---|
| bright-data-mcp | Définit Bright Data MCP comme outil par défaut pour toutes les opérations de données Web, en remplacement de WebFetch, WebSearch et d’autres outils Web intégrés qui échouent face à la détection des bots |
| competitive-intel | Instantanés des concurrents, comparaison des prix, analyse des avis, signaux de recrutement, analyse de contenu/SEO et cartographie du marché à partir de données Web en temps réel |
| price-comparison | Identifie un produit sur Amazon, Walmart, eBay, Best Buy et Google Shopping, puis indique l’option en stock la moins chère |
Parcourir les 21 compétences →
Configuration
Configuration de base (locale)
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here"
}
}
}
}
Configuration avancée
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here",
"RATE_LIMIT": "100/1h",
"SERP_ZONE": "custom_serp",
"BROWSER_ZONE": "custom_browser"
}
}
}
}
Variables d’environnement
| Variable | Description | Valeur par défaut | Exemple |
|---|---|---|---|
API_TOKEN | Votre jeton API Bright Data (obligatoire) | - | your-token-here |
RATE_LIMIT | Limitation personnalisée du débit | illimitée | 100/1h, 50/30m |
SERP_ZONE | Nom personnalisé de la zone SERP API, utilisé par les outils de recherche | mcp_serp | my_serp_zone |
BROWSER_ZONE | Nom personnalisé de la zone Browser | mcp_browser | my_browser_zone |
CONTENT_GATE | Lorsque le contenu d’une page renvoyé par un outil de données ressemble à des instructions visant à modifier la configuration MCP, le serveur demande confirmation à l’utilisateur (via l’élicitation MCP) avant de le renvoyer. Définissez sur off pour désactiver cette fonction | on | off |
CONTENT_GATE_TIMEOUT | Nombre de secondes à attendre la réponse de l’utilisateur avant de retenir le contenu | 120 | 60, 300 |
BROWSER_FILTERED_SNAPSHOT | scraping_browser_snapshot ne répertorie que les boutons, liens et champs. Réduit le nombre de jetons et empêche le texte de la page de se faire passer pour un élément cliquable (pour les tâches sensibles). Si nécessaire, le texte de la page peut ensuite être lu avec scraping_browser_get_text | off | on |
BASE_TIMEOUT | Délai d’expiration des requêtes des outils de base, en secondes (recherche et scraping) | Aucune limite | 60, 120 |
BASE_MAX_RETRIES | Nombre maximal de nouvelles tentatives des outils de base en cas d’erreurs temporaires (0-3) | 0 | 1, 3 |
GROUPS | ID de groupes d’outils séparés par des virgules. Limite le serveur à ces groupes | Tous les outils | scrapers,browser |
TOOLS | Noms d’outils individuels séparés par des virgules. Limite le serveur à ces outils | Tous les outils | scrape_batch,session_stats |
Filtre de contenu
scrape_as_markdown, search_engine et leurs variantes par lots renvoient tout ce qu’une page Web
contient. Si ce contenu comprend du texte ressemblant à des instructions visant à modifier votre configuration MCP — enregistrer un serveur, exécuter un package npx -y, modifier le fichier de configuration MCP — le serveur suspend le traitement et vous demande confirmation via votre client MCP avant de le renvoyer. Si vous approuvez, le contenu est renvoyé sans modification ; si vous refusez, il est retenu et une brève explication est fournie à l’assistant. Les pages qui ne contiennent pas ce type de texte sont renvoyées exactement comme auparavant, sans demande de confirmation. Pour un appel par lots, seuls les éléments correspondants sont retenus.
Les pages qui traitent de la configuration MCP (documentation, fichiers README) déclencheront naturellement une demande. Les clients qui ne prennent pas en charge l’élicitation MCP ne reçoivent pas le contenu correspondant ; définissez CONTENT_GATE=off si vous acceptez le risque. Pendant que le serveur attend votre réponse, il signale la progression ; les clients qui ne prolongent pas le délai d’expiration de leurs outils lors de ces notifications limiteront l’attente à leur propre délai — CONTENT_GATE_TIMEOUT est le paramètre côté serveur. Les outils de navigateur ne sont pas concernés.
Documentation
| Ressource | Lien |
|---|---|
| Documentation de l’API | docs.brightdata.com/ai/mcp-server/overview |
| Référence complète des outils | docs.brightdata.com/ai/mcp-server/tools |
| Compétences des agents | github.com/brightdata/skills |
| Exemples d’utilisation | exemples |
| Journal des modifications | CHANGELOG.md |
Dépannage
Problèmes courants et solutions
Erreur « spawn npx ENOENT »
Installez Node.js ou utilisez le chemin complet vers node :
"command": "/usr/local/bin/node" // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe" // Windows
Délais d’attente dépassés sur les sites complexes
Augmentez le délai d’attente dans les paramètres de votre client à 180s.
Problèmes d’authentification
Vérifiez que votre jeton API est valide et dispose des autorisations requises. Les jetons sont gérés dans les paramètres du compte.
run_scraper renvoie des erreurs ou aucune donnée
Les enregistrements contenant un champ error expliquent les entrées qui ont échoué. Comparez votre entrée avec sample_input de get_scraper_details (par exemple, les URL de produits Amazon contiennent /dp/, celles de Walmart /ip/) et vérifiez que la page est accessible au public. scrape_as_markdown fonctionne sur la même URL comme solution de repli.
Échec de la connexion au serveur distant
Vérifiez votre connexion Internet et les paramètres de votre pare-feu.
Contribution
Veuillez respecter les normes de codage de Bright Data.
Assistance
| Canal | Lien |
|---|---|
| Problèmes GitHub | github.com/brightdata-com/brightdata-mcp/issues |
| Documentation | docs.brightdata.com/ai/mcp-server/overview |
| support@brightdata.com |
Licence
MIT © Bright Data Ltd.