Dale a AstrBot la Capacidad de Interactuar con la Web Usando Bright Data (MCP + Skills)

En este tutorial, aprenderás:

• Qué es AstrBot y qué ofrece como plataforma de agente de IA de código abierto.
• Por qué agregar acceso web en tiempo real hace que AstrBot sea más efectivo para tareas del mundo real.
• Cómo Bright Data equipa a AstrBot con herramientas de búsqueda web, scraping, descubrimiento y automatización de navegador de nivel empresarial.
• Cómo integrar el Web MCP de Bright Data con AstrBot.
• Cómo mejorar AstrBot con experiencia en productos de Bright Data usando las Bright Data skills.
• Los resultados de combinar AstrBot con el Web MCP y las Bright Data skills.

¡Comencemos!

¿Qué es AstrBot?

AstrBot es un framework de agente de IA de código abierto y multiplataforma. Integra asistentes impulsados por LLM directamente en aplicaciones de chat populares como Telegram, Slack, Discord, WeChat y más.

Va más allá de los chatbots tradicionales al admitir flujos de trabajo de agentes, llamadas a herramientas, MCP, skills y bases de conocimiento. También incluye extensiones de plugins para automatización, soporte al cliente, gestión del conocimiento empresarial y asistentes de IA personales.

AstrBot ha acumulado más de 36.5k estrellas en GitHub, cuenta con más de 1.000 plugins de la comunidad y más de 200k usuarios activos semanales.

Características Principales

Las principales capacidades que ofrece AstrBot:

• Soporte multiplataforma: Chatea con tu agente a través de Telegram, Slack, Discord, QQ, WeChat, Lark, DingTalk y muchas otras plataformas de mensajería.
• Soporte nativo de MCP: Integra herramientas y servicios externos a través del Model Context Protocol.
• Integración de skills: Amplía los agentes con skills reutilizables que proporcionan capacidades y flujos de trabajo especializados.
• Ecosistema de más de 1.000 plugins: Añade nuevas funciones e integraciones a través de un rico marketplace de plugins mantenido por la comunidad.
• Base de conocimiento: Crea asistentes de IA que respondan preguntas usando PDFs, archivos DOCX, Markdown y otros documentos.
• Soporte multi-proveedor de LLM: Compatible con OpenAI, Anthropic, Google Gemini, Ollama y muchos proveedores compatibles con OpenAI.
• Sandbox de agentes: Ejecuta código y comandos de shell de forma segura en entornos de ejecución aislados.
• Potente WebUI: Configura modelos, plugins, servidores MCP, logs y depuración desde una interfaz centralizada.
• Despliegue flexible: Despliega con uv, Docker, aplicaciones de escritorio, launchers o entornos en la nube.
• Automatización de flujos de trabajo: Programa tareas, orquesta herramientas y construye agentes de IA autónomos para flujos de trabajo del mundo real.

Descubre más en la documentación oficial.

Por Qué AstrBot Necesita Acceso a la Web

Sin duda, AstrBot es un sólido framework de IA repleto de funciones avanzadas. Sin embargo, como todas las aplicaciones impulsadas por LLM, hereda estas limitaciones fundamentales:

• Conocimiento desactualizado: Los LLMs son entrenados con conjuntos de datos estáticos que se detienen en un momento específico en el tiempo.
• Acceso limitado a la web: Por sí solos, no pueden interactuar de forma fiable con páginas web.

AstrBot ayuda a superar parte de este desafío con una herramienta de búsqueda web integrada. Aun así, esta herramienta puede tener dificultades a escala o al acceder a sitios web protegidos por tecnologías anti-bot como CAPTCHAs, límites de velocidad y fingerprinting.

Aquí es donde entra Bright Data. Al conectar AstrBot a las soluciones de Bright Data, el agente obtiene acceso a herramientas de nivel empresarial para búsqueda web en tiempo real, extracción de datos, descubrimiento de sitios web, automatización de navegador y recuperación de conjuntos de datos.

Lo que distingue a Bright Data es su infraestructura global de datos web, respaldada por más de 400 millones de IPs residenciales. Esta arquitectura ofrece la escalabilidad y fiabilidad necesarias para cargas de trabajo en producción, con concurrencia ilimitada, disponibilidad garantizada por SLA del 99,99% y una tasa de éxito de solicitudes del 99,95%.

Cómo Bright Data Apoya a AstrBot con Búsqueda Web, Scraping, Descubrimiento e Interacción

Bright Data puede conectarse a AstrBot a través de dos integraciones:

• Bright Data Web MCP: Un servidor MCP que expone más de 70 herramientas para búsqueda web, scraping, extracción de datos estructurados y automatización de navegador.
• Bright Data skills: Una colección de Agent Skills que proporcionan a AstrBot conocimiento especializado sobre los productos de Bright Data, flujos de trabajo recomendados y mejores prácticas. La mayoría de estas skills dependen de la Bright Data CLI.

Nota: Los dos enfoques son complementarios. Por ejemplo, una Bright Data skill específica ayuda a AstrBot a entender cuándo y cómo usar las herramientas del Web MCP de manera efectiva.

Juntos, el Web MCP y las Bright Data skills transforman a AstrBot en un agente de IA más capaz. Gracias a ellos, puede realizar investigación web en tiempo real, automatización de navegador y extracción de datos estructurados.

Bright Data Web MCP

El Bright Data Web MCP equipa a AstrBot con un amplio conjunto de herramientas impulsadas por las APIs de Bright Data.

En el modo Rapid (el nivel gratuito con 5.000 solicitudes gratuitas al mes), AstrBot puede utilizar herramientas esenciales para investigación web y extracción de datos. Estas incluyen:

Al activar el modo Pro, AstrBot obtiene acceso a herramientas para extraer datos estructurados de LinkedIn, Amazon, Instagram, Walmart, YouTube, Google Maps, Zillow, TikTok y más de 40 otras plataformas. También desbloquea múltiples herramientas de automatización de navegador respaldadas por la Browser API de Bright Data.

Bright Data Skills

Las Bright Data skills amplían AstrBot con conocimiento especializado y flujos de trabajo. Ayudan al agente a elegir los servicios de Bright Data correctos y a seguir las mejores prácticas recomendadas.

Algunas de las skills disponibles incluyen:

Configuración de AstrBot: Guía Paso a Paso

En esta sección, verás cómo configurar AstrBot y conectarlo a Telegram.

Nota: Puedes adaptar fácilmente las instrucciones a continuación a cualquier otra plataforma de mensajería compatible con la librería.

Requisitos previos

Asegúrate de tener:

• uv instalado en tu máquina local.
• Una clave API de uno de los proveedores de LLM compatibles con AstrBot. Aquí usaremos una clave API de OpenAI.
• Una cuenta de Telegram con un bot listo para conectar a AstrBot. Sigue la guía oficial para crear un bot de Telegram y obtener su token.

Paso #1: Instalar y Ejecutar AstrBot

Primero, instala AstrBot ejecutando el siguiente comando:

uv tool install astrbot, python 3.12

A continuación, navega a tu carpeta de proyecto e inicializa la configuración de AstrBot:

astrbot init

Recibirás un mensaje preguntando si deseas instalar AstrBot en el directorio actual. Ingresa “Y” para continuar:

Una vez completada la configuración, inicia AstrBot con:

astrbot run

Deberías ver una salida similar a la siguiente:

La WebUI de AstrBot estará disponible en http://localhost:6185. Abre esta URL en tu navegador e inicia sesión con las credenciales proporcionadas en los logs del terminal:

Después de iniciar sesión, establece una nueva contraseña para acceder al dashboard en la WebUI de AstrBot. ¡Bien hecho!

Paso #2: Añadir la Integración de LLM

En la página “Welcome” de la WebUI de AstrBot, haz clic en el botón “Configure” en la sección “Configure AI Model” para comenzar:

Aquí, conectaremos AstrBot a OpenAI (pero el proceso es similar para cualquier otro proveedor de LLM compatible). Selecciona Add y elige la opción “OpenAI Compatible”. Se abrirá el modal de configuración “openai”. Pega tu clave API de OpenAI en el campo correspondiente:

Haz clic en “Save and Fetch Models” para obtener dinámicamente los modelos de OpenAI disponibles. Luego, selecciona el modelo que deseas usar. En este ejemplo, utilizaremos OpenAI GPT-5.4 Mini:

Finalmente, presiona “Save” para aplicar la configuración y volver a la página “Welcome”. Tu agente AstrBot ahora está impulsado por un LLM de OpenAI. ¡Increíble!

Paso #3: Configurar la Conexión con Telegram

En la página “Welcome” de la WebUI de AstrBot, haz clic en el botón “Configure” bajo “Configure Platform Bot”. En el modal “Add Platform Adapter”, selecciona “Telegram” y pega tu token de bot de Telegram en el campo correspondiente:

Presiona “Save” y luego abre tu bot de Telegram (llamado “AstrBot Agent” en este ejemplo). Deberías recibir un mensaje con el siguiente texto:

Hello, I'm AstrBot!

Para verificar que la integración de LLM funciona correctamente, envía un mensaje de prueba como:

Hey, how's it going?

Deberías recibir una respuesta como esta:

Fue generada por GPT-5.4 Mini y enviada a través de AstrBot.

¡Configuración completa! El framework ya está completamente configurado y puedes interactuar con él a través de Telegram.

Conectar AstrBot al Bright Data Web MCP

En este capítulo, aprenderás cómo configurar el Bright Data Web MCP en AstrBot.

Requisitos Previos

Para una experiencia más fluida siguiendo esta sección, verifica que tienes:

• Una comprensión básica de cómo funciona MCP.
• Familiaridad con las herramientas proporcionadas por el Bright Data Web MCP.

Además, debes tener una cuenta de Bright Data con una clave API configurada. Lee la guía oficial para generar tu clave API de Bright Data.

Paso #1: Familiarizarse con el Bright Data Web MCP

Antes de comenzar, ten en cuenta que AstrBot recomienda conectarse a servidores MCP remotos. Por esta razón, en lugar de configurar un servidor Bright Data Web MCP local con el paquete @brightdata/mcp, integraremos el servidor Web MCP remoto.

Nota: El Bright Data Web MCP remoto está diseñado para despliegues a escala empresarial. Admite escalabilidad ilimitada y conexiones concurrentes, al igual que todos los demás servicios de Bright Data.

Para comenzar, familiarízate con la URL de conexión estándar del Web MCP:

https://mcp.brightdata.com/mcp?token=<YOUR_BRIGHT_DATA_API_KEY>&pro=1

Reemplaza <YOUR_BRIGHT_DATA_API_KEY> con tu clave API de Bright Data. El parámetro token autentica tus solicitudes y las asocia con tu cuenta de Bright Data.

El parámetro &pro=1 es opcional:

• Con &pro=1: Acceso al catálogo completo de más de 70 herramientas y capacidades avanzadas. Se aplican las tarifas de uso estándar de Bright Data.
• Sin &pro=1: Solo las herramientas gratuitas disponibles en el modo Rapid (hasta 5.000 solicitudes por mes).

Ahora, supongamos que necesitas un control más granular sobre las herramientas expuestas. Por ejemplo, deseas configurar el acceso solo a herramientas o grupos de herramientas específicos. En ese caso, puedes generar una URL de conexión Web MCP personalizada desde el dashboard de Bright Data.

Inicia sesión en tu cuenta de Bright Data y navega a la página “AI Gateways > MCP”. Sigue el asistente de configuración para configurar tu servidor MCP y generar una URL de conexión personalizada:

Copia la URL de conexión “Streamable HTTP” generada, o construye una usando el formato mostrado anteriormente. Usarás esta URL en el siguiente paso para conectar AstrBot al Bright Data Web MCP. ¡Genial!

Paso #2: Añadir la Conexión del Bright Data Web MCP en AstrBot

AstrBot te permite configurar conexiones MCP directamente desde su WebUI.

Para añadir un nuevo servidor MCP, abre el desplegable “Extensions” a la izquierda y selecciona la opción “MCP Servers”. En la página “MCP”, haz clic en el botón “+” en la esquina inferior derecha:

Dale un nombre a tu servidor MCP (por ejemplo, “Bright Data Web MCP”) y pega la siguiente configuración:

{
  "transport": "streamable_http",
  "url": "<YOUR_WEB_MCP_CONNECTION_URL>"
}

Reemplaza <YOUR_WEB_MCP_CONNECTION_URL> con la URL de conexión del Bright Data Web MCP obtenida anteriormente.

Presiona “Test Connection” para verificar que el servidor MCP está configurado correctamente. Si la conexión es exitosa, AstrBot mostrará un mensaje de confirmación seguido de una lista de las herramientas disponibles:

Al usar el modo Pro (&pro=1), verás las más de 70 herramientas del Bright Data Web MCP.

Completa la integración haciendo clic en “Save”. El archivo de configuración de AstrBot ./data/mcp_server.json incluirá:

{
  "mcpServers": {
    "Bright Data Web MCP": {
      "active": true,
      "transport": "streamable_http",
      "url": "<YOUR_WEB_MCP_CONNECTION_URL>"
    }
  }
}

Alternativamente, puedes lograr el mismo resultado editando manualmente este archivo de configuración.

Después de guardar, la página “MCP” mostrará la nueva entrada “Bright Data Web MCP”, que debería estar habilitada por defecto:

¡Fantástico! AstrBot ahora está conectado al Bright Data Web MCP y puede llamar a sus herramientas de interacción web.

Más adelante en esta guía, verás una configuración de AstrBot con el Web MCP junto con las Bright Data skills.

Añadir Conocimiento sobre Bright Data a AstrBot Usando las Skills Oficiales

A continuación, se te guiará a través del proceso de añadir las Bright Data skills a AstrBot usando la herramienta CLI skills de Vercel.

Nota: Si no deseas usar skills, puedes descargar las skills directamente desde el repositorio oficial. Navega a la carpeta skills/, crea un archivo ZIP con su contenido y súbelo manualmente desde la página “Extensions > Skills” en AstrBot.

Requisitos Previos

Antes de seguir esta sección, verifica que tienes:

• Un entorno basado en UNIX (Linux, macOS o WSL).
• Node.js 22+ instalado localmente.
• La Bright Data CLI instalada y configurada localmente. Este es el requisito principal para usar las Bright Data skills. Para una configuración rápida, consulta la guía “Bright Data CLI: Instalación y Configuración“. Alternativamente, consulta el artículo dedicado en el blog para más detalles.
• Una comprensión básica de qué proporcionan las Bright Data skills. Para más información, lee el artículo sobre las Bright Data skills en nuestro blog.

También se recomienda cierta familiaridad con la herramienta CLI estándar skills de Agent Skills, aunque no es obligatoria.

Paso #1: Instalar las Bright Data Skills

Para añadir las Bright Data skills a AstrBot usando la herramienta CLI skills, ejecuta:

npx skills add brightdata/skills -a astrbot

Este comando instala el paquete npm skills e inicia el proceso de configuración. Esto hará lo siguiente:

1. Descargará las Bright Data skills desde el Directorio de Agent Skills.
2. Las configurará para su uso de forma global o dentro de tu proyecto local.

A continuación, se te pedirá que selecciones qué skills instalar:

Para instalar todas las skills disponibles, usa la barra espaciadora para seleccionar cada una y luego presiona Enter para continuar.

A continuación, elige el alcance de la instalación. Como la integración del Web MCP se configuró localmente, también deberías instalar las Bright Data skills localmente. Por lo tanto, selecciona la opción “Project” y presiona Enter:

Presiona Enter nuevamente para confirmar la instalación. Una vez completada, verás un mensaje de confirmación:

Las Bright Data skills ahora están disponibles en el directorio ./data/skills de AstrBot. ¡Fantástico!

Paso #2: Confirmar que las Skills Están Disponibles

Regresa a la WebUI de AstrBot y abre la página “Extensions > Skills”:

Verás una lista que contiene todas las Bright Data skills que acabas de instalar.

Nota: Si las skills no aparecen, intenta actualizar la página.

Opcionalmente, si aún no has configurado la Bright Data CLI, ejecuta la skill de onboarding. En Telegram escribe:

/agent-onboarding

Esto carga la Bright Data skill de onboarding dedicada, que te guía a través del proceso de configuración requerido por las otras Bright Data skills. Para ejecutarla, también debes proporcionar a AstrBot permiso para ejecutar comandos de shell.

¡Misión cumplida! En el próximo capítulo, aprenderás cómo usar el Bright Data Web MCP y las skills juntos dentro de AstrBot.

AstrBot + Bright Data Web MCP y Skills: Ejemplo Completo

Tu agente AstrBot ahora tiene herramientas y conocimiento listos para empresas para interactuar con la web. Esto le permite manejar una amplia variedad de casos de uso del mundo real que requieren datos web en tiempo real, automatización de navegador y extracción de datos estructurados.

Por ejemplo, supongamos que deseas usar AstrBot como asistente de compras. Los sitios web modernos de comercio electrónico suelen estar protegidos por tecnologías anti-bot avanzadas, lo que dificulta que los agentes de IA interactúen con ellos. Para más información, consulta nuestra guía sobre scraping de e-commerce.

Al integrar Bright Data, AstrBot puede superar estas limitaciones mientras busca en la web, interactúa con páginas web y extrae la información necesaria para completar tus solicitudes.

Ahora, imagina que deseas usar AstrBot a través de Telegram para ayudarte a encontrar un producto en el sitio web de Zara. ¡Mira los pasos a continuación!

Paso #1: Lanzar los Prompts

Comienza con un prompt como este:

Search Google for the Zara men's polo shirts sale page. Visit the page in a browser and return a full-page screenshot.

Deberías recibir una respuesta similar a:

Observa cómo el agente completó la tarea. Entre bastidores:

• Llamó a la herramienta search_engine (respaldada por la API SERP de Bright Data) para buscar en Google la consulta “Zara men’s polo shirts sale page”.
• Parseó el SERP devuelto en JSON para identificar la página correcta.
• Abrió la página en una instancia de navegador en la nube usando la herramienta scraping_browser_navigate (impulsada por la Browser API de Bright Data).
• Capturó una captura de pantalla de página completa con la herramienta scraping_browser_screenshot.
• Devolvió tanto la captura de pantalla como la URL de la página.

Si abres la WebUI de AstrBot y navegas a “Platforms > Platform Logs”, puedes inspeccionar cada herramienta del Web MCP y Bright Data skill que utilizó el agente:

Supongamos que abres la captura de pantalla, te gusta el tercer producto y deseas que AstrBot recupere toda la información sobre él. Puedes enviar un prompt como:

I like the third product, the Zip Polo Sweatshirt. Get the URL of its product page, then scrape it to extract the main product information. Return the results in a structured text message.

La respuesta debería verse similar a esta:

Entre bastidores, AstrBot llama a múltiples herramientas de Bright Data para identificar la página del producto y extraer su información. Dependiendo del flujo de trabajo, puede recuperar los datos usando scrape_as_markdown o una herramienta especializada como web_data_zara_products (que se basa en la API de datos web de Zara de Bright Data).

Paso #2: Analizar el Resultado

Observa que la información devuelta en el último mensaje coincide con lo que está disponible en la página oficial del producto de Zara:

Una página de producto puede requerir varias interacciones manuales para revelar toda su información (por ejemplo, expandir la sección “PRODUCT MEASUREMENTS”). A pesar de eso, AstrBot pudo devolver los detalles completos del producto gracias a las herramientas especializadas expuestas por el Web MCP de Bright Data.

Desde allí, puedes continuar la conversación de forma natural. Por ejemplo, podrías preguntarle a AstrBot si el producto vale la pena comprarlo, compararlo con alternativas similares, o recomendar otros productos dentro del mismo rango de precios.

¡Et voilà! Este sencillo ejemplo destaca cuánto más capaz se vuelve AstrBot cuando se integra con Bright Data. Sin el Web MCP y las Bright Data skills, no podría completar de manera fiable flujos de trabajo que dependen de búsqueda web en tiempo real, descubrimiento de sitios web, extracción de datos e interacciones automatizadas con el navegador.

Conclusión

En esta publicación del blog, aprendiste qué es AstrBot y qué aporta. En particular, viste cómo ampliar su funcionalidad integrando Bright Data a través del Web MCP y las Bright Data skills.

Con Bright Data, AstrBot puede aprovechar herramientas para investigación web en tiempo real, scraping y descubrimiento de fuentes. Esto le permite generar respuestas más fundamentadas basadas en información precisa, contextual y verificable. También puede usar herramientas de interacción con el navegador en la nube, lo que te permite delegar flujos de trabajo web complejos directamente al agente.

Para escenarios aún más avanzados, explora la gama completa de soluciones de datos web listas para IA disponibles a través del ecosistema de Bright Data.

¡Regístrate en Bright Data de forma gratuita hoy mismo y comienza a explorar nuestras soluciones de datos web!