Dale a Pi Agent las Herramientas para Explorar e Interactuar con la Web a través de Bright Data Web MCP

En esta publicación del blog, aprenderás:

• Qué es Pi y qué aporta como solución de agente CLI.
• Por qué extenderlo con herramientas de acceso web lo hace significativamente más poderoso.
• Cómo habilitar estas capacidades en Pi Agent usando la integración de Bright Data Web MCP.

¡Comencemos!

¿Qué es Pi?

Pi, también conocido como Pi Agent o Pi Coding Agent, es un agente CLI extensible. Su objetivo es ayudarte a ejecutar flujos de trabajo de codificación impulsados por IA directamente en la terminal.

A diferencia de otros agentes CLI que te limitan a funciones fijas como modos de planificación o subagentes, Pi se mantiene ligero en su núcleo. En cambio, te permite extender todo mediante extensiones TypeScript, habilidades, plantillas de prompts y plugins.

Lo que hace especial a Pi es su flexibilidad, ya que puedes moldear su comportamiento, herramientas e incluso su interfaz de usuario. Admite múltiples proveedores de LLM, árboles de sesión y primitivas de personalización que lo acercan más a un runtime de agente programable que a un asistente CLI fijo.

Este enfoque minimalista hacia los agentes CLI ha sido ampliamente apreciado por la comunidad, con el proyecto alcanzando más de 63k estrellas en GitHub. También ha superado 1,7 millones de descargas semanales en npm.

Características principales

Las capacidades clave que ofrece Pi Agent son:

• Modelo de extensibilidad completo: Modifica casi cada capa (por ejemplo, herramientas, manejo del historial, compactación, interfaz de usuario e inyección de contexto) para construir comportamientos de agente completamente personalizados.
• Soporte multi-proveedor de LLM: Funciona con OpenAI, Anthropic, Google, Azure, Bedrock y más, con cambio fácil entre modelos durante la sesión.
• Agente CLI interactivo: Un agente de codificación completo basado en terminal con uso de herramientas en tiempo real, conciencia del contexto y control conversacional.
• Gestión del árbol de sesiones: Almacena conversaciones como ramas, permitiéndote rebobinar, bifurcar y explorar rutas de ejecución alternativas.
• Sistema de habilidades: Carga habilidades del agente dinámicamente para extenderlo sin saturar la ventana de contexto.
• Plantillas de prompts y comandos personalizados: Define prompts reutilizables que pueden activarse mediante comandos de barra diagonal para flujos de trabajo más rápidos.
• Modos Print, RPC y SDK: Usa Pi en scripts, servicios backend o aplicaciones integradas mediante salida estructurada o APIs programáticas.

Por Qué Pi Coding Agent Necesita Acceso Web Confiable

Sin importar qué LLM configures en Pi, el agente de codificación subyacente sigue enfrentando una limitación común de los modelos de lenguaje: el conocimiento desactualizado. Un LLM solo puede generar respuestas basadas en los datos estáticos con los que fue entrenado, que son esencialmente una instantánea del pasado.

Dado lo rápido que evoluciona el panorama tecnológico, esta limitación se vuelve crítica. Los modelos pueden sugerir patrones de codificación desactualizados, depender de métodos obsoletos o ignorar por completo las funciones recién lanzadas.

Esto crea un claro cuello de botella para las tareas de codificación y automatización en tu configuración de Pi Agent. E incluso cuando añades herramientas básicas de búsqueda web, estas suelen ser poco confiables a escala y pueden ser bloqueadas por las protecciones anti-bot que usan muchos sitios web.

Imagina que Pi Coding Agent pudiera obtener de manera confiable tutoriales, documentación y guías actualizadas, y aprender de ellas en tiempo real. También podría tomar capturas de pantalla de páginas web para analizarlas visualmente, interactuar con sitios y realizar flujos de trabajo mucho más complejos directamente desde la CLI.

¡Esto es exactamente lo que se vuelve posible con el servidor Web MCP de Bright Data!

Bright Data Web MCP como la Solución

Bright Data Web MCP expone más de 70 herramientas. Internamente, estas herramientas interactúan con los productos basados en API de Bright Data.

Web MCP viene con [dos modos](https://github.com/brightdata/brightdata-mcp?tab=readme-ov-file#-pricing, modes):

• Modo Rapid: Un nivel gratuito con hasta 5.000 solicitudes por mes y un conjunto limitado de herramientas para búsqueda web, scraping y descubrimiento.
• Modo Pro: Un nivel de pago que desbloquea las más de 70 herramientas, incluyendo extracción de datos estructurados de plataformas como Amazon, LinkedIn, Yahoo Finance, YouTube, Zillow, Google Maps y más de 40 otras, así como capacidades completas de automatización del navegador.

Las herramientas de Bright Data Web MCP más relevantes son:

Lo que hace único a Bright Data es su red global de más de 400 millones de IPs residenciales en 195 países. Esta infraestructura es la base de todos sus productos, diseñada para ofrecer confiabilidad de nivel empresarial con soporte para concurrencia ilimitada, escalabilidad masiva y un tiempo de actividad del 99,99% respaldado por SLA.

Cómo Configurar Bright Data Web MCP en Pi Agent

En esta sección de tutorial paso a paso, se te guiará a través de la configuración de la integración de Bright Data Web MCP en Pi Agent. De esta manera, el agente de codificación subyacente obtendrá acceso a capacidades de descubrimiento web, scraping y automatización del navegador.

¡Sigue las instrucciones a continuación!

Requisitos previos

Para seguir esta sección, asegúrate de tener:

• Node.js instalado localmente (se recomienda la última versión LTS).
• Una clave API de uno de los muchos proveedores de LLM compatibles con Pi Agent (usaremos una clave API de OpenAI en esta guía).
• Una cuenta de Bright Data con una clave API. Sigue la guía oficial para generar una clave API de Bright Data.

Aunque no es estrictamente necesario, también ayuda estar familiarizado con cómo funciona MCP y con las herramientas de Bright Data Web MCP.

Paso #1: Instalar Pi

Instala Pi a través de npm ejecutando el siguiente comando:

npm install -g, ignore-scripts @earendil-works/pi-coding-agent

Esto instala el paquete @earendil-works/pi-coding-agent de forma global, que registra el comando pi en tu sistema.

Si prefieres un método de instalación diferente, como PowerShell, el instalador cURL, pnpm, Yarn o Bun, consulta la documentación oficial.

Una vez completada la instalación, lanza Pi Coding Agent con:

pi

La primera vez que ejecutes el comando, deberías ver algo como esto:

El mensaje devuelto indica que actualmente no hay proveedores de IA configurados en Pi. ¡En el siguiente paso, aprenderás cómo conectar y configurar uno!

Paso #2: Configurar un LLM

Configura un LLM en Pi Coding Agent ejecutando:

/login

Pi te pedirá que selecciones un método de autenticación para tu proveedor de LLM preferido. En este caso, selecciona “Use an API key”:

A continuación, elige tu proveedor de IA. En esta guía, usaremos OpenAI:

Pega tu clave API de OpenAI cuando se te solicite:

Si todo va como se espera, Pi se autenticará con OpenAI y almacenará de forma segura tu clave API en su configuración. Luego, seleccionará automáticamente un modelo predeterminado para ti (gpt-5.4 en este ejemplo).

Deberías ver un mensaje de confirmación similar al siguiente:

Para cambiar el modelo más tarde, ejecuta:

/model

Luego selecciona el modelo que deseas usar de las opciones disponibles:

¡Bien hecho! Pi está ahora instalado y configurado en tu máquina.

Paso #3: Agregar la Extensión Pi MCP Adapter

Por defecto, Pi viene con una configuración mínima y no incluye soporte MCP de forma predeterminada. Para habilitar la integración MCP, instala la extensión pi-mcp-adapter con este comando:

pi install npm:pi-mcp-adapter

Una vez instalada la extensión, reinicia Pi. La extensión pi-mcp-adapter espera un archivo de configuración MCP ubicado en:

• .mcp.json en tu directorio de proyecto, o
• ~/.config/mcp/mcp.json (%USERPROFILE%/.config/mcp/mcp.json en Windows).

Ese archivo contiene la configuración de tus servidores MCP. Puedes crear el archivo de configuración manualmente, o dejar que Pi lo genere por ti ejecutando:

/mcp setup

Luego, selecciona la opción “Scaffold project .mcp.json”:

Pi creará un archivo .mcp.json en tu directorio de proyecto. Ábrelo y verás:

{
  "mcpServers": {}
}

¡Perfecto! Pi Coding Agent ahora puede actuar como cliente MCP y exponer herramientas MCP al agente de IA subyacente.

Paso #4: Comenzar con Web MCP de Bright Data

Antes de conectar Web MCP de Bright Data a Pi Agent, verifica que el servidor MCP se ejecuta correctamente en tu máquina. Para más detalles, consulta la documentación de Web MCP.

Comienza instalando Web MCP de forma global con:

npm install -g @brightdata/mcp

En Linux, macOS o WSL, inicia el servidor Bright Data Web MCP con:

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

Alternativamente, en PowerShell:

$Env:API_TOKEN="<YOUR_BRIGHT_DATA_API>"; npx -y @brightdata/mcp

Reemplaza <YOUR_BRIGHT_DATA_API> con tu clave API de Bright Data. Este comando establece la variable de entorno API_TOKEN requerida y lanza el servidor Web MCP localmente a través del paquete @brightdata/mcp.

Si todo está configurado correctamente, deberías ver una salida similar a la siguiente:

Durante el primer inicio, el paquete @brightdata/mcp crea automáticamente dos APIs en tu cuenta de Bright Data:

• mcp_unlocker: Usado para acceder a la API Web Unlocker de Bright Data (y la API SERP).
• mcp_browser: Usado para interactuar con la API del Navegador de Bright Data.

Juntas, estas APIs potencian las más de 70 herramientas disponibles a través de Web MCP. Si es necesario, también puedes definir nombres de API personalizados, como se describe en el repositorio oficial.

Para confirmar que las APIs fueron creadas, accede a la página “Web Access > Web Access API” en el panel de control de Bright Data. Deberías encontrar ambas APIs listadas en la tabla “My APIs”:

Ten en cuenta que el nivel gratuito de Web MCP (modo Rapid) proporciona acceso solo a un subconjunto de herramientas.

Para desbloquear el conjunto completo de más de 70 herramientas, habilita el modo Pro estableciendo la variable de entorno PRO_MODE="true":

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

O, en Windows:

$Env:API_TOKEN="<YOUR_BRIGHT_DATA_API>"; $Env:PRO_MODE="true"; npx -y @brightdata/mcp

Nota: El modo Pro no está incluido en el nivel gratuito y [genera cargos adicionales](https://github.com/brightdata/brightdata-mcp?tab=readme-ov-file#-pricing, modes).

¡Excelente! Has confirmado que Bright Data Web MCP se ejecuta en tu máquina. En el siguiente paso, lo conectarás a Pi Agent.

Paso #5: Configurar Web MCP en Pi Agent

Para configurar la integración de Bright Data Web MCP en Pi, agrega la siguiente configuración a tu archivo .mcp.json (o ~/.config/mcp/mcp.json):

{
  "mcpServers": {
    "bright-data-web-mcp": {
      "command": "npx",
      "args": ["-y", "@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<YOUR_BRIGHT_DATA_API_KEY>",
        "PRO_MODE": "true"
      }
    }
  }
}

Al iniciarse, la extensión pi-mcp-adapter leerá el archivo. Luego, iniciará el servidor Web MCP local ejecutando el comando npx -y @brightdata/mcp mientras establece estas variables de entorno:

• API_TOKEN (requerido): Tu clave API de Bright Data.
• PRO_MODE (opcional): Configúralo en true para habilitar las funciones Pro. Configúralo en false o elimínalo por completo para ejecutar Web MCP en modo Rapid (gratuito).

A partir de ahora, Pi se conectará a una instancia local de Web MCP. ¡Perfecto!

Paso #6: Verificar la Integración de Web MCP

Verifica que las herramientas expuestas por Web MCP estén disponibles reiniciando Pi y ejecutando:

/mcp tools

Si configuraste Web MCP en modo Pro, deberías ver la lista completa de herramientas disponibles:

Observa que la lista incluye las más de 70 herramientas. Si usas el modo Rapid, solo aparecerán las herramientas incluidas en el nivel gratuito. Esto confirma que Pi puede conectarse exitosamente a tu instancia local de Web MCP y acceder a las herramientas que expone.

¡Excelente! Tu integración de Pi Agent + Bright Data Web MCP está ahora completamente configurada. Lo único que queda es verla en acción.

Paso #7: Probar el Agente de IA Mejorado

Supongamos que quieres construir un sitio web de comercio electrónico y necesitas inspiración para su diseño. Un buen enfoque es comenzar con un mockup basado en una tienda en línea exitosa.

Por ejemplo, puedes pedirle a tu agente de IA que visite una página de categoría de productos de Nike, capture una captura de pantalla y luego genere un mockup estático en HTML/CSS inspirado en los patrones de diseño y maquetación de la página.

Para lograrlo, escribe el siguiente prompt:

Search online for the Nike men's shoes & sneakers page. Open the page and take a full viewport screenshot from a US IP. Then, create a mock e-commerce webpage using plain HTML and CSS that replicates the same visual style, layout structure, and overall design patterns shown in the screenshot. Do not copy brand assets or proprietary text,only reproduce general layout, spacing, and styling.

Esta es una excelente prueba de las capacidades web añadidas a través de Web MCP, ya que implica búsqueda web y automatización del navegador. Estas capacidades son proporcionadas por Bright Data Web MCP (en modo Pro).

Nota: El prompt solicita explícitamente una dirección IP de EE. UU. para evitar los banners de cookies GDPR de la UE, que pueden limitar la vista en la captura de pantalla de la página y dificultar que el agente de IA analice correctamente la estructura de la página.

Abre Pi y ejecuta el prompt. La ejecución debería verse algo así:

Esto es lo que Pi Coding Agent hizo en segundo plano:

1. Usó la herramienta Web MCP search_engine para localizar la página “Men’s Shoes & Sneakers” de Nike mediante una consulta de búsqueda en Google basada en EE. UU. Internamente, esta solicitud está impulsada por la API SERP de Bright Data.
2. Abrió la página usando la herramienta Web MCP scraping_browser_navigate con geolocalización de EE. UU. Esta capacidad es proporcionada por la API del Navegador de Bright Data.
3. Verificó que la página se cargó correctamente y confirmó el título y la URL de la página.
4. Capturó una captura de pantalla de la página usando la herramienta Web MCP scraping_browser_screenshot.
5. Analizó la captura de pantalla para comprender la maquetación, estructura y patrones de diseño del sitio.
6. Planificó un mockup de comercio electrónico neutro en cuanto a marca, inspirado en la página original, evitando el uso de marca y activos propietarios.
7. Diseñó una estructura de página responsive con barra de utilidades, menú de navegación, banner promocional, barra lateral de filtros y cuadrícula de productos.
8. Generó un archivo src/index.html autónomo usando HTML y CSS simples.

Este flujo de trabajo destaca el poder de los agentes habilitados con Web MCP. Un LLM independiente no puede realizar estas tareas porque carece de acceso directo a motores de búsqueda y navegadores web en la nube. Además, sitios web como Nike.com utilizan sofisticados sistemas anti-bot que bloquean el tráfico automatizado.

Otra gran ventaja de Web MCP es que está construido sobre la infraestructura de proxies de Bright Data. Esto permite al agente enrutar solicitudes a través de países específicos e incluso ubicaciones a nivel de ciudad. Como resultado, el agente puede acceder y analizar versiones regionales de sitios web con mucha mayor fiabilidad.

¡Fantástico! Veamos el resultado generado.

Paso #8: Analizar los Resultados

Después de que el agente completa la tarea, la estructura de tu proyecto debería verse así:

├── .mcp.json
└── src/
    └── index.html

Abre el archivo generado src/index.html en tu navegador y verás un resultado similar al siguiente:

Compáralo con la página original de Nike “Men’s Shoes & Sneakers” usada como inspiración:

Observa cómo la página generada coincide estrechamente con la maquetación original, el espaciado, la estructura de navegación, la cuadrícula de productos y la jerarquía visual general, evitando el uso de la marca Nike, contenido propietario y activos con derechos de autor.

¡Et voilà! Este sencillo ejemplo demuestra cuánto más capaz se vuelve Pi Agent cuando se conecta a Bright Data Web MCP.

Al combinar búsqueda web, scraping y automatización del navegador junto con la generación de código impulsada por IA, el agente puede completar flujos de trabajo complejos que serían imposibles para un LLM básico.

Ahora es tu turno de experimentar. ¡Prueba diferentes prompts y explora los muchos casos de uso habilitados por las más de 70 herramientas disponibles a través de Web MCP!

Conclusión

En esta publicación del blog, aprendiste qué es Pi y las capacidades que ofrece. En detalle, viste cómo extenderlo integrándolo con Web MCP de Bright Data.

Esta integración proporciona a Pi Agent las herramientas necesarias para gestionar escenarios de búsqueda web, descubrimiento, scraping y automatización del navegador. Estas capacidades le ayudan a gestionar flujos de trabajo de automatización y codificación más complejos. Explora la gama completa de servicios web para IA en el ecosistema de Bright Data.

¡Regístrate hoy en una cuenta de Bright Data y comienza a explorar nuestras herramientas web listas para IA!