Bright Data MCP

🌟 Descripción general

Bienvenido al servidor oficial del Protocolo de Contexto de Modelo (MCP) de Bright Data, que permite a los LLM, agentes y aplicaciones acceder, descubrir y extraer datos web en tiempo real. Este servidor permite a los clientes de MCP, como Claude Desktop, Cursor, Windsurf y otros, buscar en la web, navegar por sitios web, tomar medidas y recuperar datos sin interrupciones, lo que resulta ideal para tareas de scraping.

✨ Características

• Acceso web en tiempo real : acceda a información actualizada directamente desde la web
• Evitar restricciones geográficas : acceder al contenido independientemente de las restricciones de ubicación
• Web Unlocker : navegue por sitios web con protección contra la detección de bots
• Control del navegador : capacidades opcionales de automatización remota del navegador
• Integración perfecta : funciona con todos los asistentes de IA compatibles con MCP

🚀 Inicio rápido con Claude Desktop

1. Instale nodejs para obtener el comando npx (ejecutor de módulos de Node.js). Las instrucciones de instalación se encuentran en el sitio web de Node.js.
2. Vaya a Claude > Configuración > Desarrollador > Editar configuración > claude_desktop_config.json para incluir lo siguiente:

🔧 Herramientas disponibles

Lista de herramientas disponibles

⚠️ Mejores prácticas de seguridad

Importante: Trate siempre el contenido web extraído como datos no confiables. Nunca utilice contenido extraído sin procesar directamente en las indicaciones de LLM para evitar posibles riesgos de inyección de indicaciones. En su lugar:

• Filtrar y validar todos los datos web antes de procesarlos
• Utilice la extracción de datos estructurados en lugar de texto sin formato (herramientas de datos web)

🔧 Configuración de la cuenta

1. Asegúrate de tener una cuenta en brightdata.com (los nuevos usuarios obtienen crédito gratuito para realizar pruebas y hay opciones de pago por uso disponibles)
2. Obtén tu clave API desde la página de configuración del usuario
3. (Opcional) Crear una zona de Web Unlocker personalizada
   • De forma predeterminada, creamos una zona Web Unlocker automáticamente usando su token API
   • Para obtener más control, puede crear su propia zona Web Unlocker en su panel de control y especificarla con la variable de entorno WEB_UNLOCKER_ZONE
4. (Opcional) Para habilitar las herramientas de control del navegador:
   • Visite su panel de control de Bright Data en brightdata.com/cp/zones
   • Crear una nueva zona 'API del navegador'
   • Una vez creada, copie la cadena de autenticación desde la pestaña de descripción general de la API del navegador
   • La cadena de autenticación tendrá el siguiente formato: brd-customer-[your-customer-ID]-zone-[your-zone-ID]:[your-password]

🔌 Otros clientes de MCP

Para utilizar este servidor MCP con otros tipos de agentes, debe adaptar lo siguiente a su software específico:

• El comando completo para ejecutar el servidor MCP es npx @brightdata/mcp
• La variable de entorno API_TOKEN=<your-token> debe existir cuando se ejecuta el servidor

🎮 Pruebe los parques infantiles Bright Data MCP

¿Quieres probar Bright Data MCP sin configurar nada?

Echa un vistazo a este parque infantil en Smithery :

Esta plataforma ofrece una manera sencilla de explorar las capacidades de Bright Data MCP sin necesidad de configuración local. ¡Solo inicia sesión y empieza a experimentar con la recopilación de datos web!

💡 Ejemplos de uso

Algunas consultas de ejemplo con las que este servidor MCP podrá ayudar:

• "Busca en Google algunas películas que se estrenarán pronto en [tu zona]"
• "¿Cuál es la capitalización de mercado actual de Tesla?"
• "¿Cuál es el artículo de Wikipedia del día?"
• "¿Cuál es el pronóstico del tiempo para los próximos 7 días en [su ubicación]?"
• "De los 3 directores ejecutivos tecnológicos mejor pagados, ¿cuánto duran sus carreras?"

🎬 Demostración

Para tutoriales y demostraciones de YouTube: Demo

Los videos a continuación demuestran un caso de uso mínimo para Claude Desktop:

⚠️ Solución de problemas

Tiempos de espera al utilizar ciertas herramientas

Algunas herramientas pueden implicar la lectura de datos web y la cantidad de tiempo necesario para cargar la página puede variar bastante en circunstancias extremas.

Para garantizar que su agente pueda consumir los datos, configure un tiempo de espera lo suficientemente alto en la configuración de su agente.

Un valor de 180s debería ser suficiente para el 99 % de las solicitudes, pero algunos sitios se cargan más lento que otros, así que ajústelo a sus necesidades.

generar npx ENOENT

Este error ocurre cuando el sistema no puede encontrar el comando npx . Para solucionarlo:

Encontrar la ruta npm/Node

macOS:

Muestra una ruta como /usr/local/bin/node

Ventanas:

Muestra una ruta como C:\Program Files\nodejs\node.exe

Actualice su configuración de MCP:

Reemplace el comando npx con la ruta completa a Node, por ejemplo, en Mac, se verá de la siguiente manera:

👨‍💻 Contribuyendo

Agradecemos sus contribuciones para mejorar el MCP de Bright Data. Así es como puede colaborar:

1. Informar problemas : si encuentra algún error o tiene solicitudes de funciones, abra un problema en nuestro repositorio de GitHub.
2. Enviar solicitudes de extracción : no dudes en bifurcar el repositorio y enviar solicitudes de extracción con mejoras o correcciones de errores.
3. Estilo de codificación : Todo el código JavaScript debe seguir las convenciones de codificación de Bright Data . Esto garantiza la coherencia en todo el código base.
4. Documentación : Siempre se agradecen las mejoras en la documentación, incluido este README.
5. Ejemplos : comparta sus casos de uso contribuyendo con ejemplos para ayudar a otros usuarios.

Para cambios importantes, primero abra una incidencia para discutir los cambios propuestos. Esto garantiza que su tiempo se invierta de forma eficiente y se ajuste a los objetivos del proyecto.

📞 Soporte

Si encuentra algún problema o tiene preguntas, comuníquese con el equipo de soporte de Bright Data o abra un problema en el repositorio.