Bright Data MCP Server

oficial

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

Documentación

Bright Data Logo

The Web MCP

🌐 Dale a tu IA superpoderes web en tiempo real
Conecta LLMs a la web en vivo sin bloqueos

npm version npm downloads License

Inicio RápidoCaracterísticasPreciosDemosDocumentaciónSoporte

🎉 ¡Plan Gratuito Disponible! 🎉

5,000 créditos/mes GRATIS
Sin tarjeta de crédito · Se renueva automáticamente cada mes · Perfecto para prototipos y flujos de trabajo diarios con IA


NUEVO: Grupo de Herramientas Code - El Mejor Amigo de tu Agente de Código

Acceso instantáneo a datos de paquetes npm y PyPI, directamente desde tu agente de IA.

¿Necesitas la última versión de un paquete? ¿Quieres leer su README sin salir de tu flujo de trabajo?
El grupo de herramientas Code proporciona a los agentes de código metadatos de paquetes estructurados y fiables bajo demanda —
sin scraping, sin cachés obsoletas, solo los datos que tu agente necesita para tomar decisiones inteligentes sobre dependencias.

npm
Versiones de paquetes, READMEs, metadatos y dependencias
PyPI
Información de paquetes Python, versiones y detalles del proyecto

GROUPS="code"  ·  La herramienta de referencia para Claude Code, Cursor, Windsurf y cualquier agente de código con MCP

Herramientas de Visibilidad de Marca GEO e IA

Ve cómo ChatGPT, Grok y Perplexity hablan de tu marca.

Consulta los principales LLMs directamente desde tu agente y recibe respuestas estructuradas en formato markdown.
El ciclo de retroalimentación definitivo para la Optimización para Motores Generativos (GEO) — monitoriza las recomendaciones generadas por IA, rastrea las menciones de marca en los LLMs y comprende cómo la IA percibe tus productos.

ChatGPT
Información, citas y recomendaciones generadas por IA
Grok
Análisis de IA en tiempo real impulsado por datos de X
Perplexity
Respuestas de IA aumentadas por búsqueda con fuentes

GROUPS="geo"  ·  Funciona con cualquier agente compatible con MCP


🌟 Descripción General

The Web MCP es tu puerta de entrada para dotar a los asistentes de IA de verdaderas capacidades web. Sin más respuestas desactualizadas, sin más "no puedo acceder a información en tiempo real" - solo acceso web fiable y sin interrupciones que realmente funciona.

Creado por Bright Data, la plataforma de datos web #1 del mundo, este servidor MCP asegura que tu IA nunca sea bloqueada, limitada por tasa o reciba CAPTCHAs.

Funciona con Cualquier LLM
Claude, GPT, Gemini, Llama
🛡️ Nunca es Bloqueado
Desbloqueo de nivel empresarial
🚀 5,000 Créditos Gratis
Mensuales · Sin tarjeta
Cero Configuración
Funciona nada más sacarlo de la caja

🎯 Perfecto Para

  • 🔍 Investigación en Tiempo Real - Obtén precios actuales, noticias y datos en vivo
  • 🛍️ Inteligencia de Comercio Electrónico - Monitoriza productos, precios y disponibilidad
  • 📊 Análisis de Mercado - Sigue a la competencia y las tendencias de la industria
  • 🤖 Agentes de IA - Construye agentes que realmente puedan navegar por la web
  • 💻 Agentes de Código - Consulta paquetes npm/PyPI, versiones y READMEs en tiempo real
  • 🧠 GEO y Visibilidad de Marca - Ve cómo ChatGPT, Grok y Perplexity perciben tu marca
  • 📝 Creación de Contenido - Accede a información actualizada para escribir
  • 🎓 Investigación Académica - Recopila datos de múltiples fuentes de manera eficiente

⚡ Inicio Rápido

Usa el asistente de configuración:

GIF for day2

📡 ¡Usa nuestro servidor alojado - No necesita instalación!

Perfecto para usuarios que quieren cero configuración. Solo añade esta URL a tu cliente MCP:

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

Configuración en Claude Desktop:

  1. Ve a: Ajustes → Conectores → Añadir conector personalizado
  2. Nombre: Bright Data Web
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. ¡Haz clic en "Añadir" y listo! ✨
Ejecutar localmente en tu máquina
{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}

🚀 Precios y Modos

⚡ Modo Rápido (Plan gratuito)💎 Modo Pro🔧 Modo Personalizado

$0/mes

5,000 créditos


✅ Búsqueda Web
✅ Scraping con desbloqueador Web
✅ Búsqueda Discover clasificada por IA
❌ Automatización de Navegador
❌ Herramientas de datos web


Modo por Defecto

Pago por uso

Todo en rápido más 60+ herramientas


✅ Control de Navegador
✅ APIs de Datos Web



PRO_MODE=true

Basado en uso

Elige las herramientas que necesitas


✅ Combinar grupos de herramientas
✅ Añadir herramientas individuales
❌ Anula la elegibilidad Pro


GROUPS="browser"
TOOLS="scrape_as_html"

💡 Cómo funciona el plan gratuito: Tu cuenta recibe 5,000 créditos/mes (~$7.50 de valor), renovados automáticamente el día 1 sin necesidad de tarjeta de crédito. Las solicitudes MCP se descuentan de este fondo común — las herramientas base (search_engine, scrape_as_markdown, discover) cuestan 1 crédito por solicitud, mientras que las herramientas web_data_* cuestan 1 crédito por registro devuelto. Los créditos no utilizados no se acumulan, y cuando se agotan las solicitudes se detienen (sin cargos sorpresa a menos que hayas depositado fondos). El modo Pro no está incluido en el plan gratuito e incurre en cargos adicionales basados en el uso.


🧠 Selección Avanzada de Herramientas

  • GROUPS te permite habilitar paquetes de herramientas seleccionadas. Usa IDs de grupo separados por comas como ecommerce,browser.
  • TOOLS añade nombres de herramientas explícitos además de los grupos seleccionados.
  • Prioridad de modo: PRO_MODE=true (todas las herramientas) → GROUPS / TOOLS (lista blanca) → modo rápido por defecto (kit de herramientas base).
  • Herramientas base siempre habilitadas: search_engine, search_engine_batch, scrape_as_markdown, scrape_batch, discover.
  • El ID de grupo custom está reservado; usa TOOLS para selecciones personalizadas.
ID de GrupoDescripciónHerramientas destacadas
ecommerceConjuntos de datos de retail y marketplacesweb_data_amazon_product, web_data_walmart_product, web_data_google_shopping
socialInsights sociales, de comunidad y de creadoresweb_data_linkedin_posts, web_data_tiktok_posts, web_data_youtube_videos
browserHerramientas de automatización del Scraping Browser de Bright Datascraping_browser_snapshot, scraping_browser_click_ref, scraping_browser_screenshot
financeConjuntos de datos de inteligencia financieraweb_data_yahoo_finance_business
businessConjuntos de datos de inteligencia empresarial y de ubicaciónweb_data_crunchbase_company, web_data_zoominfo_company_profile, web_data_zillow_properties_listing
researchFuentes de datos de noticias y para desarrolladoresweb_data_github_repository_file, web_data_reuter_news
app_storesDatos de tiendas de aplicacionesweb_data_google_play_store, web_data_apple_app_store
travelInformación de viajesweb_data_booking_hotel_listings
geoVisibilidad de marca GEO y LLMweb_data_chatgpt_ai_insights, web_data_grok_ai_insights, web_data_perplexity_ai_insights
codeInteligencia de paquetes para agentes de codificaciónweb_data_npm_package, web_data_pypi_package
advanced_scrapingAyudantes de extracción por lotes y asistida por IAsearch_engine_batch, scrape_batch, extract

Ejemplo para Claude Desktop

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

Ejemplo para agente de codificación (Claude Code / Cursor / Windsurf)

Proporcione a su agente de codificación inteligencia de paquetes en tiempo real — últimas versiones, READMEs, dependencias y metadatos de npm y PyPI sin necesidad de scraping:

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

✨ Características

🔥 Capacidades Principales

🔍 Búsqueda Web Inteligente
Resultados de calidad Google optimizados para IA
📄 Markdown Limpio
Extracción de contenido lista para IA
🌍 Acceso Global
Evita las restricciones geográficas automáticamente
🛡️ Protección Anti-Bot
Nunca serás bloqueado ni limitado por tasa
🤖 Automatización de Navegador
Controla navegadores reales de forma remota (Pro)
Rápido como un Rayo
Optimizado para mínima latencia

🎯 Ejemplos de Consultas que Simplemente Funcionan

✅ "What's Tesla's current stock price?"
✅ "Find the best-rated restaurants in Tokyo right now"
✅ "Get today's weather forecast for New York"
✅ "What movies are releasing this week?"
✅ "What are the trending topics on Twitter today?"
✅ "What's the latest version of express on npm?"
✅ "Get the README for the langchain-brightdata PyPI package"

🎬 Demostraciones

Nota: Estos videos muestran versiones anteriores. ¡Nuevas demostraciones próximamente! 🎥

Ver Videos de Demostración

Demostración de Búsqueda Web Básica

https://github.com/user-attachments/assets/59f6ebba-801a-49ab-8278-1b2120912e33

Demostración de Scraping Avanzado

https://github.com/user-attachments/assets/61ab0bee-fdfa-4d50-b0de-5fab96b4b91d

📺 Más tutoriales en YouTube →


🔧 Herramientas Disponibles

⚡ Herramientas en Modo Rápido (Predeterminado - Gratis)

HerramientaDescripciónCaso de Uso
🔍 search_engineBúsqueda web con resultados optimizados para IAInvestigación, verificación de hechos, eventos actuales
📄 scrape_as_markdownConvierte cualquier página web a markdown limpioExtracción de contenido, documentación
🎯 discoverBúsqueda web con ranking de IA y puntuación de relevancia basada en intenciónInvestigación profunda, pipelines RAG, análisis competitivo

💎 Herramientas en Modo Pro (Más de 60 herramientas)

Haz clic para ver todas las herramientas Pro
CategoríaHerramientasDescripción
Control de Navegadorscraping_browser.*Automatización completa del navegador
APIs de Datos Webweb_data_*Extracción de datos estructurados
E-commerceScrapers de productosDatos de Amazon, eBay, Walmart
Redes SocialesScrapers socialesTwitter, LinkedIn, Instagram
Mapas y LocalHerramientas de ubicaciónGoogle Maps, datos de negocios

📚 Ver documentación completa de herramientas →


🎮 ¡Pruébalo Ahora!

🧪 Área de Juegos en Línea

Prueba el Web MCP sin ninguna configuración:


🔧 Configuración

Configuración Básica

{
  "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",
        "PRO_MODE": "true",              // Enable all 60+ tools
        "RATE_LIMIT": "100/1h",          // Custom rate limiting
        "WEB_UNLOCKER_ZONE": "custom",   // Custom unlocker zone
        "BROWSER_ZONE": "custom_browser", // Custom browser zone
        "POLLING_TIMEOUT": "600"         // Polling timeout in seconds (default: 600)
      }
    }
  }
}

Variables de Entorno

VariableDescripciónValor PredeterminadoEjemplo
API_TOKENTu token de API de Bright Data (requerido)-your-token-here
PRO_MODEHabilita todas las más de 60 herramientasfalsetrue
RATE_LIMITLimitación de tasa personalizadailimitado100/1h, 50/30m
WEB_UNLOCKER_ZONENombre de zona personalizada de Web Unlockermcp_unlockermy_custom_zone
BROWSER_ZONENombre de zona personalizada de Browsermcp_browsermy_browser_zone
POLLING_TIMEOUTTiempo de espera para sondeo de herramientas web_data_* (segundos)600300, 1200
BASE_TIMEOUTTiempo de espera de solicitud para herramientas base en segundos (búsqueda y scrape)Sin límite60, 120
BASE_MAX_RETRIESReintentos máximos para herramientas base en errores transitorios (0-3)01, 3
GROUPSIDs de grupos de herramientas separados por comas-ecommerce,browser
TOOLSNombres de herramientas individuales separados por comas-extract,scrape_as_html

Notas:

  • POLLING_TIMEOUT controla cuánto tiempo esperan las herramientas web_data_* por resultados. Cada segundo = 1 intento de sondeo.
  • Valores más bajos (ej., 300) fallarán más rápido en recolecciones de datos lentas.
  • Valores más altos (ej., 1200) permiten más tiempo para tareas de scraping complejas.

📚 Documentación


🚨 Problemas Comunes y Soluciones

🔧 Guía de Solución de Problemas

❌ Error "spawn npx ENOENT"

Solución: 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 en Sitios Complejos

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

🔑 Problemas de Autenticación

Solución: Asegúrate de que tu token de API sea válido y tenga los permisos adecuados

📡 Conexión al Servidor Remoto

Solución: Verifica tu conexión a internet y la configuración del firewall

Más solución de problemas →


🤝 Contribuciones

¡Nos encantan las contribuciones! Así es como puedes ayudar:

Por favor, sigue los estándares de codificación de Bright Data.


📞 Soporte


📜 Licencia

MIT © Bright Data Ltd.


Construido con ❤️ por
Bright Data

La plataforma de datos web #1 del mundo


⭐ Danos estrella en GitHubLee nuestro Blog