Integra ZeroClaw con Bright Data para un asistente de IA con acceso web

En este artículo aprenderás:

• Qué es ZeroClaw y qué ventajas ofrece.
• Por qué añadir acceso web mejora las capacidades de tu asistente de IA.
• Cómo Bright Data habilita la integración con ZeroClaw mediante scraping web, búsqueda, descubrimiento y herramientas de automatización del navegador.
• Cómo conectar Bright Data a ZeroClaw usando MCP.
• Cómo proporcionar a tu asistente de IA ZeroClaw conocimiento de Bright Data a través de Agent Skills dedicados.
• Qué soporta la integración ZeroClaw + Bright Data, con un ejemplo completo.

¡Empecemos!

¿Qué es ZeroClaw?

ZeroClaw es un runtime de agente de IA ligero basado en Rust, diseñado para ejecutarse completamente en tu propia máquina.

Actúa como asistente de IA personal que se conecta a múltiples proveedores de LLM, interactúa en decenas de canales y ejecuta tareas del mundo real mediante herramientas como shell, navegador y APIs. Lo que lo diferencia de sus competidores es su enfoque totalmente local y centrado en la privacidad.

ZeroClaw ha ganado tracción rápidamente en la comunidad open source, superando las 30k estrellas en GitHub en menos de un par de meses.

Sus funcionalidades principales son:

• Runtime de binario único: Se ejecuta como un binario compacto de Rust con inicio rápido y uso mínimo de recursos.
• Agnóstico al proveedor: Compatible con más de 50 proveedores de IA, incluidos OpenAI, Anthropic, Ollama y más.
• Soporte multicanal: Se conecta a más de 20 plataformas como Discord, Telegram, correo electrónico y CLI.
• Privacidad local primero: Todo se ejecuta en tu máquina, con control total de los datos (sin nube, sin telemetría).
• Motor de ejecución de herramientas: Interactúa con shell, navegador, APIs HTTP, hardware y servidores MCP.
• Seguridad y sandboxing: Salvaguardas integradas, permisos y aislamiento del espacio de trabajo para una automatización segura.
• Motor de automatización y SOP (Procedimiento Operativo Estándar): Soporta flujos de trabajo mediante cron jobs, webhooks y procedimientos basados en eventos.
• Integración de hardware: Compatible con dispositivos como Raspberry Pi, Arduino y ESP32.
• Arquitectura extensible: Permite añadir fácilmente nuevos proveedores, herramientas, canales e integraciones personalizadas.

Descubre más en la documentación oficial.

Por qué dar a tu asistente de IA ZeroClaw acceso a la web

Incluso los LLM más avanzados que impulsan ZeroClaw comparten una limitación fundamental: su conocimiento está congelado en el tiempo. Al depender de datos de entrenamiento estáticos, no pueden seguir de forma natural los cambios del mundo real.

En un entorno de rápida evolución, esto es un inconveniente serio. Sin acceso a información actualizada, un asistente de IA puede generar respuestas obsoletas, alucinar hechos o realizar acciones incorrectas.

Para mantenerse fiables, tus agentes de IA ZeroClaw necesitan acceso a la web en vivo. Por eso ZeroClaw incluye herramientas integradas para scraping web y búsqueda. Sin embargo, estas no siempre están listas para producción y pueden enfrentar bloqueos o resultados inconsistentes.

¡Aquí es donde entra Bright Data!

Bright Data destaca con una red de más de 400 millones de IPs residenciales en 195 países, ofreciendo un 99,99% de tiempo de actividad y una tasa de éxito del 99,95%. Convierte tu agente de IA en una solución con acceso a datos web escalable y de nivel productivo.

Al integrar la infraestructura lista para IA de Bright Data, tu asistente ZeroClaw puede superar sus límites de entrenamiento mediante:

• Investigación en tiempo real: Accede a información actualizada mediante consultas de búsqueda en vivo en Google, Bing, Yandex y más
• Validación de la precisión de la información: Contrasta resultados con fuentes en línea fiables
• Recopilación de datos en vivo: Extrae contenido actualizado como precios, reseñas e información de mercado
• Soporte para muchos otros casos de uso…

Cómo ampliar ZeroClaw con Bright Data: 2 enfoques

Bright Data soporta ZeroClaw mediante dos integraciones complementarias:

• Bright Data Web MCP: El servidor MCP oficial que expone más de 70 herramientas para interactuar con las APIs y servicios de Bright Data.
• Bright Data Skills: Una colección de Agent Skills que enseñan a ZeroClaw cómo usar eficazmente las soluciones de Bright Data.

Importante: Estos dos enfoques no son alternativas. En cambio, funcionan mejor juntos. En particular, los Bright Data skills incluyen un skill dedicado para ayudar a tus agentes de IA a aprovechar al máximo las herramientas de Web MCP.

Bright Data Web MCP

El Bright Data Web MCP proporciona más de 70 herramientas para la recopilación automatizada de datos web, extracción estructurada y automatización del navegador.

Incluso en el nivel gratuito (5k solicitudes/mes), tienes acceso a herramientas principales como:

Luego, el modo Pro desbloquea todas las capacidades del Web MCP. Esto incluye herramientas avanzadas para extracción estructurada de plataformas como Amazon, LinkedIn, Yahoo Finance, YouTube, TikTok, Zillow y Google Maps. Además, expone herramientas de automatización del navegador.

Bright Data Skills

Los Bright Data skills amplían el conocimiento de ZeroClaw mediante:

Pasos comunes

Antes de ver cómo integrar Bright Data en ZeroClaw, completa los pasos de configuración comunes.

Requisitos previos

Para seguir este tutorial, asegúrate de tener:

• Un sistema operativo basado en UNIX (Linux o macOS).
• Node.js 20+ instalado localmente (versión LTS recomendada).
• Rust instalado localmente.
• Una clave API de uno de los proveedores de LLM soportados por ZeroClaw (aquí usaremos una clave API de OpenAI).
• Una cuenta de Bright Data con una clave API configurada. Para generar una clave API de Bright Data, sigue la guía oficial.

Paso #1: Instalar ZeroClaw

En tu terminal, ejecuta el siguiente comando para descargar y ejecutar el script de instalación de ZeroClaw:

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

Verás una salida similar a la siguiente:

Ahora reinicia tu shell. El comando zeroclaw debería estar disponible globalmente. Verifícalo con:

zeroclaw --version

El resultado será algo como:

zeroclaw 0.7.3

¡Muy bien! ZeroClaw ha sido instalado en tu máquina.

Paso #2: Completar la configuración

Para una configuración guiada, ejecuta el siguiente comando:

zeroclaw onboard

El proceso de incorporación de ZeroClaw comenzará:

Serás guiado a través de un asistente de 9 pasos para configurar ZeroClaw.

Comienza seleccionando tu proveedor de IA objetivo. En este caso, elige OpenAI y pega tu clave API:

Luego obtén los modelos más recientes y selecciona uno (en este caso, gpt-5-mini).

Se te pedirá que conectes un canal. Esto es opcional para este tutorial. A continuación, asegúrate de habilitar el “Modo Soberano” para tener control total sobre las herramientas del asistente de IA:

Finalmente, personaliza tu asistente de IA proporcionando su nombre, zona horaria y tono preferido:

ZeroClaw se configurará ahora y el daemon necesario se lanzará automáticamente.

Para verificar que todo funciona, inicia el chat CLI con:

zeroclaw agent

Intenta enviar un mensaje como “¡Hola!” Si todo está configurado correctamente, deberías ver una respuesta como:

¡Genial! ZeroClaw está ahora funcionando correctamente en tu máquina.

Conectar tu asistente de IA ZeroClaw al Bright Data MCP

En esta sección guiada, aprenderás a configurar una instancia local del Bright Data Web MCP en ZeroClaw.

Requisitos previos

Para seguir esta sección más fácilmente, se recomienda que tengas:

• Familiaridad con cómo funciona el estándar MCP.
• Conocimiento de las herramientas proporcionadas por el Bright Data Web MCP.

Ten en cuenta también que los requisitos previos listados en la sección “Pasos comunes” siguen aplicando aquí.

Paso #1: Configurar el Web MCP de Bright Data

Antes de configurar el Web MCP en tu instalación de ZeroClaw, primero verifica que el servidor MCP funciona correctamente en tu máquina.

Comienza iniciando sesión en tu cuenta de Bright Data. Para una configuración rápida, considera las instrucciones en la sección “MCP” del panel de control:

De lo contrario, para más orientación, sigue los pasos a continuación.

Primero, instala el Web MCP añadiendo globalmente el paquete @brightdata/mcp:

npm install -g @brightdata/mcp

A continuación, verifica que el servidor MCP se inicia con:

API_TOKEN="<YOUR_BRIGHT_DATA_API>" npx -y @brightdata/mcp

Reemplaza el marcador <YOUR_BRIGHT_DATA_API> con tu clave API real de Bright Data. El comando anterior establece la variable de entorno API_TOKEN requerida y lanza el servidor Web MCP localmente.

Si todo funciona correctamente, deberías ver registros similares a:

En la primera ejecución, el paquete @brightdata/mcp crea automáticamente dos zonas en tu cuenta de Bright Data:

• mcp_unlocker: Una zona para Web Unlocker.
• mcp_browser: Una zona para Browser API.

Estas zonas impulsan las más de 70 herramientas disponibles en Web MCP. También puedes configurar nombres de zona personalizados, como se describe en el repositorio oficial.

Para verificar que las zonas predeterminadas fueron creadas, accede a la página “Proxies e Infraestructura de Scraping” en el panel de control. Deberías ver ambas zonas en la tabla “Mis Zonas”:

Recuerda que en el nivel gratuito del Web MCP, solo hay disponible un conjunto limitado de herramientas.

Para desbloquear las más de 70 herramientas, debes habilitar el modo Pro configurando el entorno PRO_MODE="true":

API_TOKEN="<YOUR_BRIGHT_DATA_API>" PRO_MODE="true" npx -y @brightdata/mcp

Nota: El modo Pro no está incluido en el nivel gratuito y genera cargos adicionales.

¡Excelente! Acabas de verificar que el Bright Data Web MCP funciona en tu sistema. Ahora configurarás ZeroClaw para conectarse a él.

Paso #2: Añadir la configuración del Web MCP

ZeroClaw soporta la configuración MCP mediante una configuración especial en el archivo ~/.zeroclaw/config.toml. Este es el archivo de configuración global utilizado por ZeroClaw.

Para habilitar el Bright Data Web MCP, asegúrate de que tu config.toml incluya lo siguiente:

# ~/.zeroclaw/config.toml

[mcp]
enabled = true
deferred_loading = true
servers = [{ name = "bright-data", command = "npx", transport = "stdio", args = ["@brightdata/mcp"], env = { API_TOKEN = "<YOUR_BRIGHT_DATA_API_KEY", PRO_MODE = "true" }, headers = {} }]

En detalle, enabled debe estar en true para activar el soporte MCP (en versiones recientes, está deshabilitado por defecto). Además, el array servers en [mcp] debe contener una configuración válida del Bright Data MCP como se muestra arriba.

Esa configuración refleja el comando npx visto anteriormente, con credenciales pasadas mediante variables de entorno:

• API_TOKEN (requerido): Tu clave API de Bright Data.
• PRO_MODE (opcional): Habilita funciones avanzadas. Elimínalo o establécelo en "false" si no planeas usar el modo Pro.

Nota: Los servidores MCP en ZeroClaw se cargan de forma diferida, lo que significa que no se inician al arrancar el daemon.
En cambio, ZeroClaw se conecta a la instancia local del Web MCP solo cuando lanzas tu asistente de IA, ejecutando el comando npx configurado en ese momento.

¡Genial! Vamos a verificarlo.

Paso #3: Verificar la conexión

Inicia una nueva sesión CLI de ZeroClaw con:

zeroclaw agent

En los registros de inicio, deberías observar ahora:

Como el Web MCP es el único configurado, y los registros hacen referencia específicamente a él, podemos afirmar que ZeroClaw se conectó exitosamente a una instancia local del Web MCP.

Para disipar cualquier duda, prueba un prompt como este:

Which Bright Data MCP tools do you have access to?

Deberías recibir una respuesta que liste todas las herramientas expuestas por el Web MCP. Con el modo Pro habilitado, la salida incluirá el conjunto completo de herramientas disponibles, como se muestra a continuación:

¡Felicitaciones! La integración del Web MCP está funcionando correctamente. Más adelante en este artículo, verás el Web MCP en acción junto con los Bright Data Skills.

Dando a tu asistente de IA ZeroClaw conocimiento de la infraestructura de Bright Data mediante Skills

Aquí verás cómo añadir Bright Data skills a tu instalación local de ZeroClaw.

Requisitos previos

Para completar este capítulo, asegúrate de tener:

• Una comprensión básica del estándar Agent Skills.
• Familiaridad con los Bright Data skills.
• Git instalado localmente.

Además de los requisitos previos de “Pasos comunes”, también necesitarás:

• Una zona de Web Unlocker API configurada en tu cuenta de Bright Data.
• La biblioteca jq instalada localmente.

Para instalar jq (un procesador JSON ligero similar a sed) en sistemas operativos basados en Debian, ejecuta:

sudo apt-get install curl jq

O, en macOS, ejecuta:

brew install curl jq

Para una configuración rápida de una zona Web Unlocker API, consulta la guía “Crea tu primera Unlocker API“. De lo contrario, continúa con el paso a continuación.

Paso #1: Crear una zona Web Unlocker API

Comienza iniciando sesión en tu cuenta de Bright Data. Ve a la página “Proxies e Infraestructura de Scraping” y observa la tabla “Mis Zonas”:

Si ya existe una zona Web Unlocker, como web_unlocker en este caso, pasa al siguiente paso.

De lo contrario, crea una desplazándote hasta la tarjeta “Unblocker API” y presionando “Crear zona”:

Elige un nombre claro para tu zona y completa el asistente de configuración hasta que la zona esté activa.
¡Fantástico!

Paso #2: Finalizar la configuración de los Skills

Para conectarse a la infraestructura de Bright Data, los skills oficiales requieren estas dos variables de entorno:

• BRIGHTDATA_API_KEY: Requerida para autenticar solicitudes a las APIs de Bright Data.
• BRIGHTDATA_UNLOCKER_ZONE: Contiene el nombre de tu zona Web Unlocker API, habilitando capacidades de scraping web y búsqueda (ya que la Web Unlocker API también puede actuar como API SERP).

Establece los entornos requeridos en tu sistema con:

export BRIGHTDATA_API_KEY="<YOUR_BRIGHT_DATA_API_KEY>"
export BRIGHTDATA_UNLOCKER_ZONE="<YOUR_BRIGHT_DATA_WEB_UNLOCKER_API_ZONE_NAME>"

Reemplaza los marcadores con los valores reales. ¡Una vez configurados, los Bright Data skills están listos para ser utilizados por ZeroClaw!

Paso #3: Añadir los Bright Data Skills en ZeroClaw

En el momento de escribir esto, los Bright Data skills requieren ejecución de scripts de shell para funcionar. Por lo tanto, primero establece allow_scripts en true en la sección [skills] de tu archivo de configuración de ZeroClaw:

# ~/.zeroclaw/config.toml

[skills]
# ...
allow_scripts = true
# ...

Para instalar nuevos skills en ZeroClaw, necesitas colocarlos dentro del directorio ~/.zeroclaw/workdpsace/skills. Comienza clonando el repositorio oficial de Bright Data skills:

git clone https://github.com/brightdata/skills

Dentro del repositorio, encontrarás todos los skills disponibles bajo la carpeta interna skills/:

skills/
  ├── ...
  └── skills/
        ├── brd-browser-debug/
        ├── bright-data-best-practices/
        ├── bright-data-mcp/
        ├── brightdata-cli/
        ├── competitive-intel/
        ├── data-feeds/
        ├── design-mirror/
        ├── python-sdk-best-practices/
        ├── scrape/
        └── scraper-builder/

Copia todas las carpetas de skills/skills/ en tu espacio de trabajo de ZeroClaw:

cp -r skills/skills/* ~/.zeroclaw/workspace/skills/

¡Listo! Los Bright Data skills han sido añadidos exitosamente a ZeroClaw.

Paso #4: Verificar que los Skills están disponibles

Para confirmar que ZeroClaw reconoce los Bright Data skills oficiales, ejecuta:

zeroclaw skills list

La salida debería mostrar la lista de Bright Data skills que añadiste previamente:

¡Misión cumplida! En la siguiente sección, experimentarás el asistente de IA ZeroClaw mejorado con el Bright Data Web MCP y los Agent Skills.

ZeroClaw + Bright Data en acción

Supón que eres un propietario de negocio que desea recibir regularmente un mensaje de tu asistente de IA ZeroClaw con un resumen de las reseñas de tu ficha de Google Maps. Logra esto con un prompt como este:

Retrieve the Google Maps reviews for the "NY Pizza Suprema" business in New York. Focus on reviews that were posted in the last 2 days. Also scrape the main business information from Google Maps (e.g., name, category, location, rating, number of reviews, etc.).

Then, aggregate everything into a concise report that includes 
- Updated average review score + udpated review count 
- A sentiment analysis of the most recent reviews 

For the sentiment analysis:
- Highlight common positive and negative themes 
- Include real quotes from customers 
- Emphasize what customers appreciated most and what they suggested could be improved

Importante: La tarea no es algo que ZeroClaw pueda lograr de forma fiable por sí solo. Esto se debe a que requiere herramientas de nivel productivo para búsqueda web (para localizar el negocio en Maps), scraping (para extraer datos del negocio) y extracción estructurada de Google Maps.

Consejo: Para asegurarte de que ZeroClaw use Bright Data para este flujo de trabajo (en lugar de herramientas integradas inestables), puedes indicarlo explícitamente en el prompt. O, de forma opcional, envía un mensaje pidiendo almacenar esta preferencia en la memoria del agente para que persista entre sesiones.

Para verificar que el prompt funciona, pruébalo iniciando el chat con el agente y enviando el mensaje:

zeroclaw agent

O envía el prompt directamente con:

zeroclaw agent --message "<YOUR_PROMPT>"

Esto es lo que deberías ver:

El flujo de trabajo esperado es:

1. Realiza una consulta web mediante la herramienta search_engine del Web MCP (impulsada por la API SERP de Bright Data).
2. Extrae la URL de Google Maps de los resultados de búsqueda estructurados.
3. Pasa la URL a la herramienta web_data_google_maps_reviews (respaldada por la API de Reseñas de Google de Bright Data).
4. Recupera metadatos del negocio (nombre, calificación, categoría, reseñas) haciendo scraping de la página del negocio en Maps usando scrape_as_markdown (a través de la Web Unlocker API).
5. Agrega todo en un informe estructurado.

Nota: Antes de ejecutar cualquier herramienta, el agente de IA solicitará permiso. Concédelo con “A” para permitir que el agente recuerde este permiso para usos futuros. De lo contrario, solo para la ejecución actual, aprueba la ejecución con “Y”.

El resultado es un informe contextual que contiene puntuaciones de reseñas y análisis de sentimientos basado en datos reales de Google Maps:

Esto incluye perspectivas del mundo real derivadas directamente de información en vivo de Google Maps y datos de reseñas:

¡Et voilà! El único paso que queda es habilitar la programación, conectar un canal, y comenzarás a recibir informes automatizados con todos los insights que necesitas. Este es un ejemplo sencillo que muestra el poder de ZeroClaw + Bright Data, ¡aunque también son posibles muchos otros casos de uso!

Conclusión

En este tutorial, exploraste qué es ZeroClaw y el valor que proporciona. En particular, aprendiste por qué y cómo mejorarlo integrando Bright Data a través del Web MCP y sus skills oficiales.

Esta configuración eleva tu asistente de IA ZeroClaw habilitando acceso directo a la web. Desbloquea capacidades como búsqueda web, descubrimiento de contenido, extracción de datos estructurados e interacciones automatizadas con sitios web.

Si quieres ir más lejos, explora la suite completa de servicios listos para IA disponibles en el ecosistema de Bright Data.

¡Regístrate hoy en una cuenta gratuita de Bright Data y comienza a integrar nuestras potentes herramientas de datos web!