Bright Data

oficial

Descubre, extrae e interactúa con la web: una interfaz que impulsa el acceso automatizado a través de internet público.

¿Qué puedes hacer con Bright Data MCP?

  • Búsqueda web — Pide a tu asistente que realice búsquedas en Bing o Google y devuelva resultados estructurados con enlaces, títulos y descripciones.
  • Extracción de páginas — Obtén cualquier URL como Markdown limpio, texto, HTML o ld_json, con detección de bots y gestión de CAPTCHA integradas.
  • Datos estructurados de plataformas — Encuentra y ejecuta extractores preconfigurados para sitios como Amazon, LinkedIn, TikTok y npm, para obtener JSON limpio en lugar de analizar HTML.
  • Automatización del navegador — Navega, haz clic, escribe, desplázate y toma capturas de pantalla en una sesión de navegador remota para sitios interactivos o que requieren iniciar sesión.
  • Recopilación de respuestas de LLM — Envía indicaciones a ChatGPT o Perplexity y recibe sus respuestas para comparar cómo describe cada uno una marca.
  • Recopilación por lotes — Ejecuta hasta 5 búsquedas o extrae hasta 5 URL en una sola llamada para recopilar datos en paralelo.

Documentación

Bright Data Logo

Bright Data MCP

Búsqueda web, extracción de páginas, extracción de datos estructurados y automatización del navegador para agentes de IA y LLM mediante el Model Context Protocol.

Compatible con agentes de IA, agentes de programación, asistentes de chat y cualquier cliente compatible con MCP.

npm version npm downloads License

Inicio rápido • Precios • Casos de uso • Herramientas • Habilidades de agente • Documentación • Soporte

Plan gratuito: 5.000 solicitudes al mes. No se requiere tarjeta de crédito. Se renueva mensualmente.


Descripción general

El servidor MCP de Bright Data ofrece a los agentes de IA acceso en tiempo real a datos web públicos. Proporciona 30 herramientas que abarcan:

  • Búsqueda web — resultados de Bing y Google como datos estructurados
  • Extracción de páginas — cualquier URL como Markdown o HTML; la detección de bots, la resolución de CAPTCHA y la rotación de proxies se gestionan automáticamente en cada solicitud
  • Datos estructurados (Web Scraper API) — JSON limpio de más de 1.200 scrapers prediseñados: Amazon, LinkedIn, Instagram, TikTok, YouTube, X, Reddit, Facebook, Crunchbase, Zillow, npm, PyPI y más, sin analizar HTML. Seis herramientas permiten encontrar y ejecutar cualquiera de ellos
  • Automatización del navegador — navegar, hacer clic, escribir, tomar capturas de pantalla y leer páginas en una sesión de navegador remota
  • Recopilación de respuestas de LLM — enviar prompts a ChatGPT y Perplexity y recibir sus respuestas como datos estructurados

Todas las solicitudes se enrutan a través de la infraestructura de desbloqueo de Bright Data, por lo que las páginas que bloquean a los clientes HTTP habituales (detección de bots, CAPTCHA, límites de frecuencia, restricciones geográficas) se cargan con normalidad. Sin configuración de proxies, sin mantenimiento de navegadores headless y sin necesidad de escribir lógica de reintentos.

Dos opciones de implementación: un servidor remoto alojado (una URL, sin instalación) o una instancia local mediante npx @brightdata/mcp.


Inicio rápido

Servidor alojado — sin instalación. Añade esta URL a tu cliente MCP:

https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE

Obtén tu token de API en la configuración de tu cuenta de Bright Data. Las cuentas nuevas reciben 5.000 solicitudes gratuitas al mes.

Parámetros de URL opcionales:

ParámetroDescripciónEjemplo
groups=<ids>Limita el acceso a grupos de herramientas específicos (predeterminado: todas las herramientas)...&groups=scrapers,browser
tools=<names>Limita el acceso a herramientas específicas...&tools=search_engine,scrape_as_markdown
Claude Desktop
  1. Ve a: Settings → Connectors → Add custom connector
  2. Nombre: Bright Data
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. Haz clic en "Add"

O ejecútalo localmente:

{
  "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

Añádelo a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
VS Code

Añádelo a .vscode/mcp.json:

{
  "servers": {
    "brightdata": {
      "type": "http",
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Windsurf

Añádelo a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "brightdata": {
      "serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Gemini CLI

Añádelo a ~/.gemini/settings.json:

{
  "mcpServers": {
    "brightdata": {
      "httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Zed

Añádelo a la configuración de Zed:

{
  "context_servers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Warp

Ve a Settings > MCP Servers > Add MCP Server y añade:

{
  "brightdata": {
    "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  }
}
Otros clientes (npx local)

Para cualquier cliente compatible con servidores MCP locales:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}

Precios y plan gratuito

Todas las cuentas incluyen un plan gratuito mensual recurrente. No se requiere tarjeta de crédito ni compromiso para empezar.

5.000 solicitudes gratuitas al mes, que se renuevan el día 1 de cada mes. Las solicitudes no utilizadas no se acumulan. En las cuentas de equipo, el plan gratuito se comparte entre todos los usuarios de la cuenta.

Qué incluye el plan gratuito:

  • Obtener cualquier página web y extraerla como Markdown
  • Acceso a más de 60 scrapers prediseñados para dominios populares
  • Búsqueda web (Bing, Google)
  • Desbloqueo web (elusión de la detección de bots, resolución de CAPTCHA, rotación de proxies)
  • Automatización del navegador
  • Segmentación geográfica

Más allá del plan gratuito: paga según el uso, sin compromiso:

Búsqueda, extracción y recopilaciónNavegación del navegador
Pago por uso$1.50 / 1K resultados$8 / GB
  • Cuando se agotan las solicitudes gratuitas, las solicitudes se detienen. No hay cargos inesperados, a menos que hayas depositado fondos
  • Añadir una tarjeta de crédito es solo un paso de verificación; no se te cobrará a menos que se agote tu plan gratuito y hayas depositado fondos
  • Establece un límite de gasto en el panel de control para que el uso de pago por uso nunca supere tu presupuesto

Precios completos, planes por volumen y opciones empresariales →


Casos de uso

Investigación en tiempo real

Responde preguntas con datos web actuales en lugar de datos de entrenamiento. Busca y luego consulta las fuentes.

TareaHerramientas
Buscar información actual en la websearch_engine, search_engine_batch
Leer una página específica como Markdown limpioscrape_as_markdown, scrape_batch

Ejemplos de prompts: "¿Cuál es el precio actual de las acciones de Tesla?", "Consulta el pronóstico del tiempo de hoy para Nueva York", "Encuentra las fuentes más citadas sobre la regulación de la IA en la UE de los últimos 6 meses".

Inteligencia de comercio electrónico

Consulta datos de productos como JSON estructurado: precio, disponibilidad, valoración, número de reseñas, vendedor e imágenes.

TareaHerramientas
Productos, reseñas y resultados de búsqueda de Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara y otras tiendassearch_scrapers → get_scraper_details → run_scraper
Comparación de precios entre tiendasEl mismo flujo con el scraper de Google Shopping

Ejemplos de prompts: "Compara el precio de este portátil en Amazon, Walmart y Best Buy", "Obtén la valoración y el número de reseñas del ASIN B0D2Q9397Y", "¿Hay existencias de este producto?".

Análisis de mercado y de la competencia

Crea perfiles de competidores con datos actuales: financiación, número de empleados, contrataciones, reseñas de clientes y páginas de precios.

TareaHerramientas
Financiación, tamaño, empleados y ofertas de empleo de empresas (Crunchbase, ZoomInfo, LinkedIn)search_scrapers → run_scraper
Opiniones de clientes (Google Maps, Facebook, reseñas de tiendas de aplicaciones)search_scrapers → run_scraper
Páginas de precios de la competenciascrape_as_markdown, scrape_batch
Descubrimiento de mercadosearch_engine_batch

Ejemplo de prompt: "Analiza Notion como competidor: precios, financiación, enfoque de contratación y de qué se quejan los clientes".

Agentes de IA con acceso web fiable

Sustituye las herramientas integradas de búsqueda y obtención de datos que se bloquean en sitios protegidos. Todas las solicitudes pasan por una infraestructura de desbloqueo, por lo que los agentes no fallan ante la detección de bots, los CAPTCHA ni las restricciones geográficas.

TareaHerramientas
Sustituto directo de la búsqueda web integradasearch_engine
Sustituto directo de la obtención de URL integradascrape_as_markdown
Recopilación de datos en paralelo (5 a la vez)search_engine_batch, scrape_batch
Sitios interactivos (muros de inicio de sesión, desplazamiento infinito, contenido dinámico)scraping_browser_* (14 herramientas)

Agentes de programación

Datos de registros de paquetes bajo demanda, sin extracción ni cachés obsoletas.

TareaHerramientas
Versión, README y metadatos de paquetes npm y PyPIrun_scraper con el scraper de npmjs o pypi (encuéntralos con search_scrapers)
Leer archivos de repositorios de GitHubrun_scraper con el scraper de repositorios de GitHub

Ejemplos de prompts: "¿Cuál es la última versión de express en npm?", "Obtén el README del paquete langchain-brightdata de PyPI".

GEO y visibilidad de marca

Envía prompts a los principales LLM y recibe sus respuestas como datos estructurados. Mide cómo describen los asistentes de IA tu marca, qué fuentes citan y qué recomiendan: el ciclo de retroalimentación para la optimización para motores generativos.

TareaHerramientas
Respuestas de ChatGPT con citas y recomendacioneschatgpt_ai_insights
Respuestas de Perplexity con fuentesperplexity_ai_insights

Ejemplo de prompt: "Pregunta a ChatGPT y Perplexity «cuál es el mejor proveedor de proxies» y compara cómo nos posiciona cada uno".

Supervisión de redes sociales

Datos estructurados de las principales plataformas: perfiles, publicaciones, comentarios y métricas de interacción. Cada plataforma tiene scrapers para cada tipo de dato (perfiles de LinkedIn, reels de Instagram, comentarios de TikTok, ...); encuéntralos con search_scrapers y ejecútalos con run_scraper.

PlataformaEjemplos de scrapers
LinkedInperfiles de personas, perfiles de empresas, ofertas de empleo, publicaciones, búsqueda de personas
Instagramperfiles, publicaciones, reels, comentarios
TikTokperfiles, publicaciones, tienda, comentarios
Facebookperfiles, publicaciones, anuncios del marketplace, reseñas de empresas, eventos
YouTubevídeos, canales, comentarios
X (Twitter)publicaciones, publicaciones por perfil
Redditpublicaciones, comentarios

Ejemplo de prompt: "Obtén las últimas 10 publicaciones de este perfil de TikTok y resume la interacción".

Creación de contenido e investigación académica

Recopila material de referencia de varias páginas a la vez, filtrado por actualidad y relevancia.

TareaHerramientas
Recopilar varias fuentes en una sola llamadascrape_batch (hasta 5 URL)
Noticias y datos financierossearch_engine con consultas de noticias, run_scraper con el scraper de Yahoo Finance

Comparación

CapacidadBright Data MCPServidores MCP web habituales
Número total de herramientas302–10
Extractores de JSON estructurado específicos de cada plataformaMás de 1.200 scrapers prediseñados para comercio electrónico, redes sociales, empresas, finanzas, viajes y tiendas de aplicaciones, disponibles mediante 6 herramientasPoco habituales; solo extracción genérica
Desbloqueo (elusión de la detección de bots, resolución de CAPTCHA, rotación de proxies)Integrado en cada solicitudNormalmente ninguno; bloqueados en sitios protegidos
Motores de búsquedaBing, GoogleNormalmente uno
Automatización del navegador14 herramientas, navegador remoto, sin configuración localLimitada o inexistente
Recopilación de respuestas de LLM (ChatGPT, Perplexity)SíNo disponible
Datos de registros de paquetes (npm, PyPI)SíNo disponible
Operaciones por lotes10 búsquedas o 10 extracciones por llamadaNormalmente solo una solicitud
Segmentación geográficaSíLimitada o inexistente
Plan gratuito5.000 solicitudes al mes, incluye automatización del navegador, sin tarjeta de créditoVaría; a menudo acceso sin clave con límites de frecuencia

Selección de herramientas: grupos

Las herramientas están organizadas en grupos para que solo cargues lo que necesitas. Menos herramientas implican menos contexto que tu agente debe procesar.

  • Si no se especifican GROUPS ni TOOLS, se habilitan las 30 herramientas. Al establecer cualquiera de ellos, el servidor se limita a esas herramientas
  • GROUPS habilita paquetes de herramientas. Separados por comas: GROUPS="scrapers,browser" (local) o &groups=scrapers,browser (URL alojada)
  • TOOLS añade herramientas individuales: TOOLS="scrape_batch,session_stats". Si se usa por sí solo, habilita únicamente las herramientas indicadas
  • Cada grupo también incluye search_engine, scrape_as_markdown y ask_brightdata_assistant
  • El ID de grupo custom está reservado; usa TOOLS para seleccionar herramientas individuales
ID del grupoContenidoNúmero de herramientas
scrapersBuscar y ejecutar cualquier scraper preconfigurado de Web Scraper API (Amazon, LinkedIn, TikTok, npm, ...)6
browserAutomatización remota del navegador14
geoRecopilación de respuestas de ChatGPT y Perplexity2
advanced_scrapingHerramientas por lotes, estadísticas de sesión3

Los ID de grupo anteriores (ecommerce, social, business, finance, research, app_stores, travel, code) siguen funcionando y habilitan las herramientas scrapers; social y business también añaden search_dataset y list_dataset_fields. Los nombres antiguos de web_data_* en TOOLS también habilitan las herramientas scrapers.

Ejemplos de configuración

Servidor local con automatización del navegador y herramientas por lotes:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>",
        "GROUPS": "browser,advanced_scraping"
      }
    }
  }
}

Configuración de agente de programación (Claude Code / Cursor / Windsurf): datos de npm, PyPI y GitHub mediante scrapers preconfigurados:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>",
        "GROUPS": "scrapers"
      }
    }
  }
}

Referencia de herramientas (30 herramientas)

Qué herramienta usar

  • Se conoce la URL y se necesita el contenido: scrape_as_markdown. Varias URL (hasta 5): scrape_batch
  • Se necesita encontrar información: search_engine. Varias consultas (hasta 5): search_engine_batch
  • Datos estructurados de una plataforma conocida (Amazon, LinkedIn, TikTok, npm, PyPI, etc.): search_scrapers → get_scraper_details → run_scraper — devuelve JSON limpio, más rápido y fiable que extraer los datos de la misma página
  • HTML sin procesar: scrape_as_markdown con format: 'html'
  • La página requiere interacción (hacer clic, escribir, desplazarse, iniciar sesión): herramientas scraping_browser_*
  • Cómo responde ChatGPT/Perplexity a una instrucción: chatgpt_ai_insights / perplexity_ai_insights
  • Preguntas sobre Bright Data (productos, zonas, errores, configuración): ask_brightdata_assistant

Notas sobre las ejecuciones de scrapers:

  • Devuelven JSON estructurado; se cobra por registro devuelto
  • Los registros con un campo error explican las entradas que no se pudieron procesar, por ejemplo, una URL de tipo incorrecto
  • Los resultados pueden ser grandes. Mantén bajo limit_per_input para los métodos discover_by_* y ejecuta la recopilación masiva en un subagente cuando tu framework lo permita, para evitar que los registros saturen la ventana de contexto principal
  • Si una ejecución falla, scrape_as_markdown funciona con la misma URL como alternativa
Búsqueda y extracción — 5 herramientas
HerramientaDescripciónGrupo
search_engineBusca en Bing (predeterminado) o Google. Devuelve JSON (enlace, título, descripción), 10 resultados por página. Parámetros: country, page (desde 0), time_range (hour, day, week, month, year, any; Bing solo admite day, week, year)predeterminado / todos los grupos
search_engine_batchHasta 5 consultas de búsqueda en una llamadapredeterminado / advanced_scraping
scrape_as_markdownCualquier URL. Devuelve el contenido como Markdown (predeterminado), texto, HTML o ld_jsonpredeterminado / todos los grupos
scrape_batchHasta 5 URL en una llamada. Devuelve el contenido como Markdown (predeterminado), texto, HTML o ld_jsonpredeterminado / advanced_scraping
session_statsRecuento de uso de herramientas en la sesión actualpredeterminado / advanced_scraping
Web Scraper API — 6 herramientas

Busca y ejecuta cualquiera de los más de 1.200 scrapers preconfigurados de Bright Data. La lista de scrapers se carga desde docs.brightdata.com/scrapers.json y se actualiza a diario. Disponible tanto en el servidor alojado como en el local. Se habilita de forma predeterminada cuando no se selecciona ninguna herramienta ni grupo; de lo contrario, añade el grupo scrapers (&groups=scrapers en la URL alojada, GROUPS=scrapers localmente).

Flujo habitual: search_scrapers → get_scraper_details → run_scraper. Se cobra por registro; los métodos discover_by_* recopilan hasta limit_per_input registros por entrada (10 de forma predeterminada).

HerramientaDescripciónGrupo
search_scrapersBusca scrapers por sitio o tipo de datos (p. ej., «amazon reviews», «linkedin.com»). Devuelve el ID del conjunto de datos, el nombre, el dominio y los métodos de recopilaciónpredeterminado / scrapers
get_scraper_detailsDescripción, campos de entrada, ejemplo de entrada y campos principales de salida de un método de scraperpredeterminado / scrapers
run_scraperEjecuta un método de scraper. Espera hasta 45 segundos; si sigue en ejecución, devuelve un snapshot_id para consultarlo más tardepredeterminado / scrapers
get_scraper_progressEstado de una ejecución: starting, running, ready, failed o canceledpredeterminado / scrapers
get_scraper_resultsRegistros de una ejecución finalizadapredeterminado / scrapers
refresh_scrapersVuelve a cargar la lista de scrapers ahora, en lugar de esperar a la actualización diariapredeterminado / scrapers
Automatización del navegador — 14 herramientas

Sesión remota del navegador. Secuencia habitual: navegar → obtener una instantánea → interactuar mediante referencias → extraer datos o hacer una captura de pantalla.

HerramientaDescripción
scraping_browser_navigateAbre o reutiliza una sesión del navegador y navega a una URL
scraping_browser_go_backVuelve a la página anterior
scraping_browser_go_forwardAvanza a la página siguiente
scraping_browser_snapshotInstantánea ARIA de la página que enumera los elementos interactivos con referencias. Es necesaria antes de realizar acciones basadas en referencias
scraping_browser_click_refHace clic en un elemento mediante la referencia de la última instantánea
scraping_browser_type_refEscribe en un elemento mediante su referencia; opcionalmente, pulsa Enter para enviar
scraping_browser_fill_formRellena varios campos de formulario mediante sus referencias en una sola llamada
scraping_browser_screenshotCaptura de pantalla de la página actual; full_page es opcional
scraping_browser_get_textContenido de texto del cuerpo de la página
scraping_browser_get_htmlHTML de la página actual
scraping_browser_scrollSe desplaza hasta el final de la página
scraping_browser_scroll_to_refDesplaza un elemento hasta que quede visible
scraping_browser_wait_for_refEspera a que un elemento sea visible, con tiempo de espera opcional
scraping_browser_network_requestsSolicitudes de red desde que se cargó la página: método, URL, estado

Las referencias proceden de la última instantánea. Si la página cambia después de hacer clic o navegar, toma una nueva instantánea antes de la siguiente acción basada en referencias. Para páginas estáticas, scrape_as_markdown es más rápido y económico que una sesión del navegador.

Visibilidad GEO y LLM — 2 herramientas
HerramientaEntradaDevuelve
chatgpt_ai_insightsInstrucciónLa respuesta de ChatGPT en formato Markdown
perplexity_ai_insightsInstrucciónLa respuesta de Perplexity en formato Markdown

Úsalo para flujos de trabajo de optimización para motores generativos (seguimiento de cómo los LLM describen tu marca) y de evaluación mediante LLM.

Búsqueda en conjuntos de datos — 2 herramientas

Búsqueda con filtros en conjuntos de datos de LinkedIn almacenados; devuelve los registros coincidentes de una vez, sin ejecutar un scraper.

HerramientaDescripciónGrupo
list_dataset_fieldsCampos filtrables de un conjunto de datos (nombre, tipo, descripción). Llama a esta herramienta antes de search_datasetpredeterminado / social, business
search_datasetRegistros que coinciden con un filtro, hasta 10 por llamada, con un cursor para obtener máspredeterminado / social, business
Asistente de Bright Data — 1 herramienta
HerramientaDescripciónGrupo
ask_brightdata_assistantPregunta a Sophie, la asistente de soporte de Bright Data, sobre productos, API, zonas, errores o configuración de la cuenta. Pasa el dialog_id devuelto para hacer una pregunta de seguimiento en el mismo hilopredeterminado / todos los grupos

Referencia completa de herramientas en la documentación →


Habilidades de agentes

Habilidades listas para usar que enseñan a tu agente a utilizar correctamente este servidor MCP. La colección completa está en github.com/brightdata/skills — 21 habilidades que abarcan la orquestación de MCP, inteligencia competitiva, comparación de precios, seguimiento de marcas, auditorías SEO, creación de scrapers, canalizaciones RAG y mucho más.

Tres de las habilidades de mayor impacto:

HabilidadQué hace
bright-data-mcpEstablece Bright Data MCP como opción predeterminada para todas las operaciones de datos web, sustituyendo WebFetch, WebSearch y otras herramientas web integradas que fallan ante la detección de bots
competitive-intelInstantáneas de competidores, comparación de precios, análisis de reseñas, señales de contratación, análisis de contenido/SEO y mapas del panorama del mercado a partir de datos web en tiempo real
price-comparisonEncuentra un producto en Amazon, Walmart, eBay, Best Buy y Google Shopping, e indica la opción disponible más barata

Explora las 21 habilidades →


Configuración

Configuración básica (local)

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "your-token-here"
      }
    }
  }
}

Configuración avanzada

{
  "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 de entorno

VariableDescripciónValor predeterminadoEjemplo
API_TOKENTu token de API de Bright Data (obligatorio)-your-token-here
RATE_LIMITLimitación de velocidad personalizadailimitada100/1h, 50/30m
SERP_ZONENombre personalizado de la zona de SERP API, utilizado por las herramientas de búsquedamcp_serpmy_serp_zone
BROWSER_ZONENombre personalizado de la zona de Browsermcp_browsermy_browser_zone
CONTENT_GATESi el contenido de una página devuelto por una herramienta de datos parece contener instrucciones para cambiar la configuración de MCP, el servidor pregunta al usuario (mediante MCP elicitation) antes de devolverlo. Establécelo en off para desactivarloonoff
CONTENT_GATE_TIMEOUTSegundos que se espera la respuesta del usuario antes de retener el contenido12060, 300
BROWSER_FILTERED_SNAPSHOTscraping_browser_snapshot siempre muestra solo botones, enlaces y campos. Ahorra tokens y evita que el texto de la página se haga pasar por un elemento en el que se puede hacer clic (para tareas sensibles). Si es necesario, el texto de la página se puede leer después con scraping_browser_get_textoffon
BASE_TIMEOUTTiempo de espera de las solicitudes para las herramientas básicas, en segundos (búsqueda y extracción)Sin límite60, 120
BASE_MAX_RETRIESNúmero máximo de reintentos de las herramientas básicas ante errores transitorios (0-3)01, 3
GROUPSID de grupos de herramientas separados por comas. Limita el servidor a estos gruposTodas las herramientasscrapers,browser
TOOLSNombres de herramientas individuales separados por comas. Limita el servidor a estas herramientasTodas las herramientasscrape_batch,session_stats

Filtro de contenido

scrape_as_markdown, search_engine y sus variantes por lotes devuelven lo que diga una página web. Si ese contenido incluye texto que parezca una instrucción para cambiar la configuración de MCP —registrar un servidor, ejecutar un paquete npx -y, editar el archivo de configuración de MCP—, el servidor se detiene y te pregunta, a través de tu cliente MCP, antes de devolverlo. Si lo apruebas, el contenido se devuelve sin cambios; si lo rechazas, se retiene y se proporciona una breve explicación al asistente. Las páginas que no contienen ese tipo de texto se devuelven exactamente como antes, sin mostrar ninguna solicitud. En una llamada por lotes, solo se retienen los elementos que coinciden.

Las páginas sobre la configuración de MCP (documentación, archivos README) generarán una solicitud de forma natural. Los clientes que no admiten MCP elicitation no reciben el contenido coincidente; establece CONTENT_GATE=off si aceptas el riesgo. Mientras el servidor espera tu respuesta, informa del progreso; los clientes que no amplían el tiempo de espera de sus herramientas al recibir actualizaciones de progreso limitarán la espera a su propio límite: CONTENT_GATE_TIMEOUT es el parámetro correspondiente en el servidor. Las herramientas del navegador no están cubiertas.


Documentación

RecursoEnlace
Documentación de la APIdocs.brightdata.com/ai/mcp-server/overview
Referencia completa de herramientasdocs.brightdata.com/ai/mcp-server/tools
Habilidades de agentesgithub.com/brightdata/skills
Ejemplos de usoexamples
Registro de cambiosCHANGELOG.md

Solución de problemas

Problemas comunes y soluciones

Error "spawn npx ENOENT"

Instala Node.js o usa la ruta completa a node:

"command": "/usr/local/bin/node"  // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe"  // Windows

Tiempos de espera agotados en sitios complejos

Aumenta el tiempo de espera en la configuración de tu cliente a 180s.

Problemas de autenticación

Verifica que tu token de API sea válido y tenga los permisos necesarios. Los tokens se administran en la configuración de la cuenta.

run_scraper devuelve errores o ningún dato

Los registros con un campo error explican las entradas que fallaron. Compara tu entrada con sample_input de get_scraper_details (por ejemplo, las URL de productos de Amazon contienen /dp/, mientras que las de Walmart contienen /ip/) y comprueba que la página sea de acceso público. scrape_as_markdown funciona como alternativa en la misma URL.

Falla la conexión al servidor remoto

Comprueba tu conexión a Internet y la configuración del firewall.


Contribuciones

Sigue los estándares de programación de Bright Data.


Asistencia

CanalEnlace
Incidencias de GitHubgithub.com/brightdata-com/brightdata-mcp/issues
Documentacióndocs.brightdata.com/ai/mcp-server/overview
Correo electrónicosupport@brightdata.com

Licencia

MIT © Bright Data Ltd.