Bright Data
oficialDescubre, 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 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.
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ámetro | Descripción | Ejemplo |
|---|---|---|
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
- Ve a: Settings → Connectors → Add custom connector
- Nombre:
Bright Data - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - 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ón | Navegació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.
| Tarea | Herramientas |
|---|---|
| Buscar información actual en la web | search_engine, search_engine_batch |
| Leer una página específica como Markdown limpio | scrape_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.
| Tarea | Herramientas |
|---|---|
| Productos, reseñas y resultados de búsqueda de Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara y otras tiendas | search_scrapers → get_scraper_details → run_scraper |
| Comparación de precios entre tiendas | El 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.
| Tarea | Herramientas |
|---|---|
| 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 competencia | scrape_as_markdown, scrape_batch |
| Descubrimiento de mercado | search_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.
| Tarea | Herramientas |
|---|---|
| Sustituto directo de la búsqueda web integrada | search_engine |
| Sustituto directo de la obtención de URL integrada | scrape_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.
| Tarea | Herramientas |
|---|---|
| Versión, README y metadatos de paquetes npm y PyPI | run_scraper con el scraper de npmjs o pypi (encuéntralos con search_scrapers) |
| Leer archivos de repositorios de GitHub | run_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.
| Tarea | Herramientas |
|---|---|
| Respuestas de ChatGPT con citas y recomendaciones | chatgpt_ai_insights |
| Respuestas de Perplexity con fuentes | perplexity_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.
| Plataforma | Ejemplos de scrapers |
|---|---|
| perfiles de personas, perfiles de empresas, ofertas de empleo, publicaciones, búsqueda de personas | |
| perfiles, publicaciones, reels, comentarios | |
| TikTok | perfiles, publicaciones, tienda, comentarios |
| perfiles, publicaciones, anuncios del marketplace, reseñas de empresas, eventos | |
| YouTube | vídeos, canales, comentarios |
| X (Twitter) | publicaciones, publicaciones por perfil |
| publicaciones, 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.
| Tarea | Herramientas |
|---|---|
| Recopilar varias fuentes en una sola llamada | scrape_batch (hasta 5 URL) |
| Noticias y datos financieros | search_engine con consultas de noticias, run_scraper con el scraper de Yahoo Finance |
Comparación
| Capacidad | Bright Data MCP | Servidores MCP web habituales |
|---|---|---|
| Número total de herramientas | 30 | 2–10 |
| Extractores de JSON estructurado específicos de cada plataforma | Más de 1.200 scrapers prediseñados para comercio electrónico, redes sociales, empresas, finanzas, viajes y tiendas de aplicaciones, disponibles mediante 6 herramientas | Poco 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 solicitud | Normalmente ninguno; bloqueados en sitios protegidos |
| Motores de búsqueda | Bing, Google | Normalmente uno |
| Automatización del navegador | 14 herramientas, navegador remoto, sin configuración local | Limitada 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 lotes | 10 búsquedas o 10 extracciones por llamada | Normalmente solo una solicitud |
| Segmentación geográfica | Sí | Limitada o inexistente |
| Plan gratuito | 5.000 solicitudes al mes, incluye automatización del navegador, sin tarjeta de crédito | Varí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
GROUPSniTOOLS, se habilitan las 30 herramientas. Al establecer cualquiera de ellos, el servidor se limita a esas herramientas GROUPShabilita paquetes de herramientas. Separados por comas:GROUPS="scrapers,browser"(local) o&groups=scrapers,browser(URL alojada)TOOLSañ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_markdownyask_brightdata_assistant - El ID de grupo
customestá reservado; usaTOOLSpara seleccionar herramientas individuales
| ID del grupo | Contenido | Número de herramientas |
|---|---|---|
scrapers | Buscar y ejecutar cualquier scraper preconfigurado de Web Scraper API (Amazon, LinkedIn, TikTok, npm, ...) | 6 |
browser | Automatización remota del navegador | 14 |
geo | Recopilación de respuestas de ChatGPT y Perplexity | 2 |
advanced_scraping | Herramientas por lotes, estadísticas de sesión | 3 |
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_markdownconformat: '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
errorexplican las entradas que no se pudieron procesar, por ejemplo, una URL de tipo incorrecto - Los resultados pueden ser grandes. Mantén bajo
limit_per_inputpara los métodosdiscover_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_markdownfunciona con la misma URL como alternativa
Búsqueda y extracción — 5 herramientas
| Herramienta | Descripción | Grupo |
|---|---|---|
search_engine | Busca 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_batch | Hasta 5 consultas de búsqueda en una llamada | predeterminado / advanced_scraping |
scrape_as_markdown | Cualquier URL. Devuelve el contenido como Markdown (predeterminado), texto, HTML o ld_json | predeterminado / todos los grupos |
scrape_batch | Hasta 5 URL en una llamada. Devuelve el contenido como Markdown (predeterminado), texto, HTML o ld_json | predeterminado / advanced_scraping |
session_stats | Recuento de uso de herramientas en la sesión actual | predeterminado / 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).
| Herramienta | Descripción | Grupo |
|---|---|---|
search_scrapers | Busca 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ón | predeterminado / scrapers |
get_scraper_details | Descripción, campos de entrada, ejemplo de entrada y campos principales de salida de un método de scraper | predeterminado / scrapers |
run_scraper | Ejecuta un método de scraper. Espera hasta 45 segundos; si sigue en ejecución, devuelve un snapshot_id para consultarlo más tarde | predeterminado / scrapers |
get_scraper_progress | Estado de una ejecución: starting, running, ready, failed o canceled | predeterminado / scrapers |
get_scraper_results | Registros de una ejecución finalizada | predeterminado / scrapers |
refresh_scrapers | Vuelve a cargar la lista de scrapers ahora, en lugar de esperar a la actualización diaria | predeterminado / 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.
| Herramienta | Descripción |
|---|---|
scraping_browser_navigate | Abre o reutiliza una sesión del navegador y navega a una URL |
scraping_browser_go_back | Vuelve a la página anterior |
scraping_browser_go_forward | Avanza a la página siguiente |
scraping_browser_snapshot | Instantá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_ref | Hace clic en un elemento mediante la referencia de la última instantánea |
scraping_browser_type_ref | Escribe en un elemento mediante su referencia; opcionalmente, pulsa Enter para enviar |
scraping_browser_fill_form | Rellena varios campos de formulario mediante sus referencias en una sola llamada |
scraping_browser_screenshot | Captura de pantalla de la página actual; full_page es opcional |
scraping_browser_get_text | Contenido de texto del cuerpo de la página |
scraping_browser_get_html | HTML de la página actual |
scraping_browser_scroll | Se desplaza hasta el final de la página |
scraping_browser_scroll_to_ref | Desplaza un elemento hasta que quede visible |
scraping_browser_wait_for_ref | Espera a que un elemento sea visible, con tiempo de espera opcional |
scraping_browser_network_requests | Solicitudes 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
| Herramienta | Entrada | Devuelve |
|---|---|---|
chatgpt_ai_insights | Instrucción | La respuesta de ChatGPT en formato Markdown |
perplexity_ai_insights | Instrucción | La 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.
| Herramienta | Descripción | Grupo |
|---|---|---|
list_dataset_fields | Campos filtrables de un conjunto de datos (nombre, tipo, descripción). Llama a esta herramienta antes de search_dataset | predeterminado / social, business |
search_dataset | Registros que coinciden con un filtro, hasta 10 por llamada, con un cursor para obtener más | predeterminado / social, business |
Asistente de Bright Data — 1 herramienta
| Herramienta | Descripción | Grupo |
|---|---|---|
ask_brightdata_assistant | Pregunta 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 hilo | predeterminado / 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:
| Habilidad | Qué hace |
|---|---|
| bright-data-mcp | Establece 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-intel | Instantá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-comparison | Encuentra un producto en Amazon, Walmart, eBay, Best Buy y Google Shopping, e indica la opción disponible más barata |
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
| Variable | Descripción | Valor predeterminado | Ejemplo |
|---|---|---|---|
API_TOKEN | Tu token de API de Bright Data (obligatorio) | - | your-token-here |
RATE_LIMIT | Limitación de velocidad personalizada | ilimitada | 100/1h, 50/30m |
SERP_ZONE | Nombre personalizado de la zona de SERP API, utilizado por las herramientas de búsqueda | mcp_serp | my_serp_zone |
BROWSER_ZONE | Nombre personalizado de la zona de Browser | mcp_browser | my_browser_zone |
CONTENT_GATE | Si 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 desactivarlo | on | off |
CONTENT_GATE_TIMEOUT | Segundos que se espera la respuesta del usuario antes de retener el contenido | 120 | 60, 300 |
BROWSER_FILTERED_SNAPSHOT | scraping_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_text | off | on |
BASE_TIMEOUT | Tiempo de espera de las solicitudes para las herramientas básicas, en segundos (búsqueda y extracción) | Sin límite | 60, 120 |
BASE_MAX_RETRIES | Número máximo de reintentos de las herramientas básicas ante errores transitorios (0-3) | 0 | 1, 3 |
GROUPS | ID de grupos de herramientas separados por comas. Limita el servidor a estos grupos | Todas las herramientas | scrapers,browser |
TOOLS | Nombres de herramientas individuales separados por comas. Limita el servidor a estas herramientas | Todas las herramientas | scrape_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
| Recurso | Enlace |
|---|---|
| Documentación de la API | docs.brightdata.com/ai/mcp-server/overview |
| Referencia completa de herramientas | docs.brightdata.com/ai/mcp-server/tools |
| Habilidades de agentes | github.com/brightdata/skills |
| Ejemplos de uso | examples |
| Registro de cambios | CHANGELOG.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
| Canal | Enlace |
|---|---|
| Incidencias de GitHub | github.com/brightdata-com/brightdata-mcp/issues |
| Documentación | docs.brightdata.com/ai/mcp-server/overview |
| Correo electrónico | support@brightdata.com |
Licencia
MIT © Bright Data Ltd.