Bright Data MCP Server
oficialDescubre, extrae e interactúa con la web: una interfaz que impulsa el acceso automatizado a través de internet público.
Documentación
The Web MCP
🌐 Dale a tu IA superpoderes web en tiempo real
Conecta LLMs a la web en vivo sin bloqueos
Inicio Rápido • Características • Precios • Demos • Documentación • Soporte
🎉 ¡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:
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:
- Ve a: Ajustes → Conectores → Añadir conector personalizado
- Nombre:
Bright Data Web - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - ¡Haz clic en "Añadir" y listo! ✨
{
"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/mes5,000 créditos ✅ Búsqueda Web Modo por Defecto
|
Pago por usoTodo en rápido más 60+ herramientas ✅ Control de Navegador |
Basado en usoElige las herramientas que necesitas ✅ Combinar grupos de herramientas 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 herramientasweb_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
GROUPSte permite habilitar paquetes de herramientas seleccionadas. Usa IDs de grupo separados por comas comoecommerce,browser.TOOLSañ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
customestá reservado; usaTOOLSpara selecciones personalizadas.
| ID de Grupo | Descripción | Herramientas destacadas |
|---|---|---|
ecommerce | Conjuntos de datos de retail y marketplaces | web_data_amazon_product,
web_data_walmart_product,
web_data_google_shopping |
social | Insights sociales, de comunidad y de creadores | web_data_linkedin_posts,
web_data_tiktok_posts,
web_data_youtube_videos |
browser | Herramientas de automatización del Scraping Browser de Bright Data | scraping_browser_snapshot,
scraping_browser_click_ref,
scraping_browser_screenshot |
finance | Conjuntos de datos de inteligencia financiera | web_data_yahoo_finance_business |
business | Conjuntos de datos de inteligencia empresarial y de ubicación | web_data_crunchbase_company,
web_data_zoominfo_company_profile,
web_data_zillow_properties_listing |
research | Fuentes de datos de noticias y para desarrolladores | web_data_github_repository_file,
web_data_reuter_news |
app_stores | Datos de tiendas de aplicaciones | web_data_google_play_store,
web_data_apple_app_store |
travel | Información de viajes | web_data_booking_hotel_listings |
geo | Visibilidad de marca GEO y LLM | web_data_chatgpt_ai_insights,
web_data_grok_ai_insights,
web_data_perplexity_ai_insights |
code | Inteligencia de paquetes para agentes de codificación | web_data_npm_package,
web_data_pypi_package |
advanced_scraping | Ayudantes de extracción por lotes y asistida por IA | search_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
🔧 Herramientas Disponibles
⚡ Herramientas en Modo Rápido (Predeterminado - Gratis)
| Herramienta | Descripción | Caso de Uso |
|---|---|---|
🔍 search_engine | Búsqueda web con resultados optimizados para IA | Investigación, verificación de hechos, eventos actuales |
📄 scrape_as_markdown | Convierte cualquier página web a markdown limpio | Extracción de contenido, documentación |
🎯 discover | Búsqueda web con ranking de IA y puntuación de relevancia basada en intención | Investigació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ía | Herramientas | Descripción |
|---|---|---|
| Control de Navegador | scraping_browser.* | Automatización completa del navegador |
| APIs de Datos Web | web_data_* | Extracción de datos estructurados |
| E-commerce | Scrapers de productos | Datos de Amazon, eBay, Walmart |
| Redes Sociales | Scrapers sociales | Twitter, LinkedIn, Instagram |
| Mapas y Local | Herramientas de ubicación | Google Maps, datos de negocios |
🎮 ¡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
| Variable | Descripción | Valor Predeterminado | Ejemplo |
|---|---|---|---|
API_TOKEN | Tu token de API de Bright Data (requerido) | - | your-token-here |
PRO_MODE | Habilita todas las más de 60 herramientas | false | true |
RATE_LIMIT | Limitación de tasa personalizada | ilimitado | 100/1h, 50/30m |
WEB_UNLOCKER_ZONE | Nombre de zona personalizada de Web Unlocker | mcp_unlocker | my_custom_zone |
BROWSER_ZONE | Nombre de zona personalizada de Browser | mcp_browser | my_browser_zone |
POLLING_TIMEOUT | Tiempo de espera para sondeo de herramientas web_data_* (segundos) | 600 | 300, 1200 |
BASE_TIMEOUT | Tiempo de espera de solicitud para herramientas base en segundos (búsqueda y scrape) | Sin límite | 60, 120 |
BASE_MAX_RETRIES | Reintentos máximos para herramientas base en errores transitorios (0-3) | 0 | 1, 3 |
GROUPS | IDs de grupos de herramientas separados por comas | - | ecommerce,browser |
TOOLS | Nombres de herramientas individuales separados por comas | - | extract,scrape_as_html |
Notas:
POLLING_TIMEOUTcontrola 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
🤝 Contribuciones
¡Nos encantan las contribuciones! Así es como puedes ayudar:
- 🐛 Reportar errores
- 💡 Sugerir características
- 🔧 Enviar PRs
- ⭐ ¡Dale estrella a este repositorio!
Por favor, sigue los estándares de codificación de Bright Data.
📞 Soporte
|
🐛 Issues de GitHub Reporta errores y características |
📚 Documentación Guías completas |
✉️ Correo Electrónico [email protected] |
📜 Licencia
MIT © Bright Data Ltd.
La plataforma de datos web #1 del mundo