Bright Data

officiel

Dé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 Logo

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.

npm version npm downloads License

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ètreDescriptionExemple
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
  1. Accédez à : Settings → Connectors → Add custom connector
  2. Nom : Bright Data
  3. URL : https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. 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 collecteNavigation dans le navigateur
Paiement à l’utilisation1,50 $ / 1 000 résultats8 $ / 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âcheOutils
Rechercher des informations récentes sur le Websearch_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âcheOutils
Produits, avis et résultats de recherche sur Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara et d’autres boutiquessearch_scrapers → get_scraper_details → run_scraper
Comparaison des prix entre détaillantsLe 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âcheOutils
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 concurrentsscrape_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âcheOutils
Remplacement direct de la recherche Web intégréesearch_engine
Remplacement direct de la récupération d’URL intégréescrape_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âcheOutils
Version, README et métadonnées des paquets npm et PyPIrun_scraper avec le scraper npmjs ou pypi (trouvez-les avec search_scrapers)
Lire des fichiers de dépôts GitHubrun_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âcheOutils
Réponses de ChatGPT avec citations et recommandationschatgpt_ai_insights
Réponses de Perplexity avec sourcesperplexity_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.

PlateformeExemples de scrapers
LinkedInprofils de personnes, profils d’entreprises, offres d’emploi, publications, recherche de personnes
Instagramprofils, publications, Reels, commentaires
TikTokprofils, publications, boutique, commentaires
Facebookprofils, publications, annonces de la marketplace, avis sur les entreprises, événements
YouTubevidéos, chaînes, commentaires
X (Twitter)publications, publications par profil
Redditpublications, 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âcheOutils
Collecter plusieurs sources en un seul appelscrape_batch (jusqu’à 5 URL)
Actualités et données financièressearch_engine avec des requêtes d’actualité, run_scraper avec le scraper Yahoo Finance

Comparaison

FonctionnalitéBright Data MCPServeurs MCP Web courants
Nombre total d’outils302–10
Extracteurs JSON structurés spécifiques aux plateformesPlus 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 outilsRares ; 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êteGénéralement absent ; blocage sur les sites protégés
Moteurs de rechercheBing, GoogleGénéralement un seul
Automatisation de navigateur14 outils, navigateur distant, aucune configuration localeLimitée ou inexistante
Collecte de réponses de LLM (ChatGPT, Perplexity)OuiNon proposée
Données de registres de paquets (npm, PyPI)OuiNon proposées
Opérations par lots10 recherches ou 10 extractions par appelGénéralement une seule requête
Ciblage géographiqueOuiLimité ou inexistant
Offre gratuite5 000 requêtes/mois, automatisation de navigateur incluse, aucune carte bancaireVariable ; 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 GROUPS ni TOOLS, les 30 outils sont activés. Définir l’un ou l’autre limite le serveur à ces seuls outils
  • GROUPS active des ensembles d’outils. Valeurs séparées par des virgules : GROUPS="scrapers,browser" (local) ou &groups=scrapers,browser (URL hébergée)
  • TOOLS ajoute 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_markdown et ask_brightdata_assistant
  • L’identifiant de groupe custom est réservé ; utilisez TOOLS pour 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_markdown avec format: '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 error expliquent les entrées qui ont échoué, par exemple une URL de type incorrect
  • Les résultats peuvent être volumineux. Gardez limit_per_input bas pour les méthodes discover_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_markdown fonctionne sur la même URL comme solution de repli
Recherche et scraping — 5 outils
OutilDescriptionGroupe
search_engineRecherche 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_batchJusqu’à 5 requêtes de recherche en un seul appelpar défaut / advanced_scraping
scrape_as_markdownN’importe quelle URL. Renvoie le contenu au format Markdown (par défaut), texte, HTML ou ld_jsonpar défaut / tous les groupes
scrape_batchJusqu’à 5 URL en un seul appel. Renvoie le contenu au format Markdown (par défaut), texte, HTML ou ld_jsonpar défaut / advanced_scraping
session_statsNombre d’utilisations des outils pour la session en courspar 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).

OutilDescriptionGroupe
search_scrapersTrouver 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 collectepar défaut / scrapers
get_scraper_detailsDescription, champs d’entrée, exemple d’entrée et principaux champs de sortie d’une méthode de scraperpar défaut / scrapers
run_scraperExé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érieurementpar défaut / scrapers
get_scraper_progressÉtat d’une exécution : démarrage, en cours, prête, échouée ou annuléepar défaut / scrapers
get_scraper_resultsEnregistrements d’une exécution terminéepar défaut / scrapers
refresh_scrapersRecharger la liste des scrapers immédiatement au lieu d’attendre l’actualisation quotidiennepar 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.

OutilDescription
scraping_browser_navigateOuvrir ou réutiliser une session de navigateur et accéder à une URL
scraping_browser_go_backRevenir en arrière
scraping_browser_go_forwardAvancer
scraping_browser_snapshotInstantané 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_refCliquer sur un élément à l’aide de sa référence dans le dernier instantané
scraping_browser_type_refSaisir du texte dans un élément à l’aide de sa référence ; possibilité d’appuyer sur Entrée pour envoyer
scraping_browser_fill_formRemplir plusieurs champs de formulaire par référence en un seul appel
scraping_browser_screenshotCapture d’écran de la page actuelle ; full_page facultatif
scraping_browser_get_textContenu textuel du corps de la page
scraping_browser_get_htmlHTML de la page actuelle
scraping_browser_scrollFaire défiler jusqu’en bas de la page
scraping_browser_scroll_to_refFaire défiler jusqu’à un élément pour le rendre visible
scraping_browser_wait_for_refAttendre qu’un élément devienne visible, avec délai d’expiration facultatif
scraping_browser_network_requestsRequê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
OutilEntréeRenvoie
chatgpt_ai_insightsInviteRéponse de ChatGPT au format Markdown
perplexity_ai_insightsInviteRé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.

OutilDescriptionGroupe
list_dataset_fieldsChamps filtrables d’un jeu de données (nom, type, description). À appeler avant search_datasetpar défaut / social, business
search_datasetEnregistrements correspondant à un filtre, jusqu’à 10 par appel, avec un curseur pour en obtenir davantagepar défaut / social, business
Assistant Bright Data — 1 outil
OutilDescriptionGroupe
ask_brightdata_assistantDemandez à 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 filpar 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étenceFonction
bright-data-mcpDé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-intelInstantané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-comparisonIdentifie 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

VariableDescriptionValeur par défautExemple
API_TOKENVotre jeton API Bright Data (obligatoire)-your-token-here
RATE_LIMITLimitation personnalisée du débitillimitée100/1h, 50/30m
SERP_ZONENom personnalisé de la zone SERP API, utilisé par les outils de recherchemcp_serpmy_serp_zone
BROWSER_ZONENom personnalisé de la zone Browsermcp_browsermy_browser_zone
CONTENT_GATELorsque 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 fonctiononoff
CONTENT_GATE_TIMEOUTNombre de secondes à attendre la réponse de l’utilisateur avant de retenir le contenu12060, 300
BROWSER_FILTERED_SNAPSHOTscraping_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_textoffon
BASE_TIMEOUTDélai d’expiration des requêtes des outils de base, en secondes (recherche et scraping)Aucune limite60, 120
BASE_MAX_RETRIESNombre maximal de nouvelles tentatives des outils de base en cas d’erreurs temporaires (0-3)01, 3
GROUPSID de groupes d’outils séparés par des virgules. Limite le serveur à ces groupesTous les outilsscrapers,browser
TOOLSNoms d’outils individuels séparés par des virgules. Limite le serveur à ces outilsTous les outilsscrape_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

RessourceLien
Documentation de l’APIdocs.brightdata.com/ai/mcp-server/overview
Référence complète des outilsdocs.brightdata.com/ai/mcp-server/tools
Compétences des agentsgithub.com/brightdata/skills
Exemples d’utilisationexemples
Journal des modificationsCHANGELOG.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

CanalLien
Problèmes GitHubgithub.com/brightdata-com/brightdata-mcp/issues
Documentationdocs.brightdata.com/ai/mcp-server/overview
E-mailsupport@brightdata.com

Licence

MIT © Bright Data Ltd.