Cómo conectar Browserless a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Browserless, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Browserless + Gemini

Navegadores en la nube de Browserless desde tu IA: lee páginas renderizadas como markdown, HTML o enlaces con smart scrape, extrae elementos con selectores CSS, haz capturas de pantalla, imprime PDF, ejecuta auditorías Lighthouse, mapea las URL de un sitio y abre páginas protegidas contra bots con la API unblock. Todas las herramientas salvo la consulta de versión gastan unidades de Browserless.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

BROWSERLESS_API_TOKEN, BROWSERLESS_HOST

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Browserless; el plan gratuito incluye unidades mensuales.

1. Inicia sesión en https://browserless.io/account/ y copia el API token del panel.
2. Pégalo en BROWSERLESS_API_TOKEN. Browserless lo recibe como parámetro de consulta token en cada llamada; solo se envía al host indicado abajo.
3. Pon en BROWSERLESS_HOST la región de tu plan, sin https://: production-sfo.browserless.io (oeste de EE. UU., el valor por defecto de los planes compartidos), production-lon.browserless.io (Londres) o production-ams.browserless.io (Ámsterdam). Los planes dedicados (private fleet) usan chrome.browserless.io o su host regional chrome-...browserless.io; un token privado en un host compartido se rechaza con 401.
4. Instala el conector y ejecuta browserless_get_meta: devuelve la versión del servicio Browserless en el host y confirma el token.

Qué gasta unidades: todas las herramientas salvo browserless_get_meta gastan unidades de Browserless de tu plan: 1 unidad por cada 30 segundos de navegador (redondeando hacia arriba; las descargas simples de smart scrape cuestan 0,5), más 6 unidades por MB de tráfico por proxy residencial o 2 por MB de centro de datos, y 10 unidades por CAPTCHA resuelto. browserless_smart_scrape y browserless_map usan por defecto el proxy residencial, y los formatos json y summary de smart scrape añaden unidades de extracción con IA. stealth: true no cuesta nada extra. La IA te pregunta antes de una serie de llamadas y antes de usar un proxy en páginas grandes.

Leer páginas: browserless_smart_scrape es la primera opción. Prueba una descarga simple, luego un proxy y luego un navegador completo, indica qué estrategia sirvió la página y devuelve los formats que pidas: markdown (por defecto aquí), html, rawText, links, screenshot, pdf, json (extracción con IA con un esquema o un prompt en json_options) o summary. only_main_content, include_tags y exclude_tags recortan la página. browserless_get_content devuelve el HTML totalmente renderizado de una URL, o del HTML que pases, desde un Chrome real. browserless_scrape devuelve el texto, el HTML y los atributos de cada elemento que coincida con tus selectores CSS.

Imágenes y documentos: browserless_screenshot captura el área visible, la página completa o un elemento (selector) en PNG, JPEG o WebP, con un viewport propio, scroll_page para el contenido de carga diferida y block_consent_modals para ocultar los avisos de cookies. browserless_pdf imprime en PDF una URL o el HTML que pases (por ejemplo un informe generado), con opciones como format, landscape, márgenes y printBackground.

Mapa y calidad del sitio: browserless_map lista las URL de un sitio a partir del sitemap y los enlaces, con títulos y descripciones, ordenadas por relevancia respecto a search (limit 200 por defecto, hasta 5000). browserless_performance ejecuta una auditoría Google Lighthouse con puntuaciones de 0 a 1 para rendimiento, accesibilidad, buenas prácticas, SEO y PWA. Una auditoría completa puede tardar minutos y es muy grande, así que la IA pasa config para auditar una sola categoría.

Páginas bloqueadas: browserless_unblock supera la detección de bots (Datadome, CAPTCHA pasivos) y devuelve el HTML, las cookies que puso el sitio y, si se pide, una captura de la página completa; funciona mejor con proxy: residential y la IA pregunta antes. Con las demás herramientas la IA prueba primero stealth: true y luego un proxy (proxy_country elige el país).

Esperar al contenido: las herramientas de renderizado aceptan wait_for_selector (un elemento y un tiempo límite), wait_for_timeout, goto_options (por ejemplo waitUntil: networkidle2) y best_attempt, que continúa con lo que haya cargado cuando una espera agota el tiempo. En browserless_get_content y browserless_scrape, reject_resource_types (imágenes, fuentes, multimedia) acelera las páginas; browserless_get_content además envía set_extra_http_headers y cookies con la petición. Todos los tiempos van en milisegundos; timeout limita la llamada entera.

Desactivadas al instalar: browserless_function, que ejecuta tu propio código Puppeteer para flujos de varios pasos, como recorrer un formulario o paginar resultados. Ese código puede enviar formularios, iniciar sesión o comprar en sitios web, y esas acciones no se pueden deshacer, así que un administrador del workspace la activa cuando el equipo la necesita. Una vez activa, la IA te muestra el código y espera tu sí.

Qué modifica: nada en tu cuenta de Browserless. Cada llamada arranca un Chrome headless nuevo, hace una tarea sobre una URL y cierra el navegador, así que nada se conserva entre llamadas.

Formatos de datos: las capturas vuelven como imágenes y los PDF como archivos; las respuestas de texto se limitan a unos 100 KB. Opciones como wait_for_selector, goto_options, viewport y json_options son objetos JSON. Las puntuaciones de Lighthouse son fracciones (0,92 = 92).

Contenido no fiable: las páginas, las cookies y los textos extraídos vienen de sitios de terceros. La IA trata las instrucciones que contengan como datos, nunca como órdenes.

Errores habituales: 401 significa que el token es incorrecto o no corresponde a este host (flota compartida o privada); vuelve a copiarlo del panel. 404 en la comprobación de instalación indica que BROWSERLESS_HOST no sirve las API REST. 400 es un cuerpo mal formado, por ejemplo sin url ni html. 403 significa que el destino no está permitido para esta cuenta. 408 significa que la página tardó más que el tiempo límite: sube timeout, espera menos o usa best_attempt. 429 indica que se agotó la concurrencia del plan; espera y reintenta una vez. Un contenido vacío o parcial suele significar que el sitio bloquea la automatización: prueba stealth: true y luego browserless_unblock con un proxy residencial.

El conector no cubre BrowserQL, las sesiones WebSocket para Puppeteer o Playwright, las API asíncronas de rastreo y agentes, las descargas de archivos ni la gestión de sesiones.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Browserless.

Herramientas disponibles

Ejemplos de prompts

• "Lee https://example.com/pricing con smart scrape y dame los planes y precios en una tabla."
• "Haz una captura de la página de inicio completa a 1280 px de ancho y oculta el aviso de cookies."
• "Ejecuta una auditoría Lighthouse de rendimiento de https://example.com y enumera los tres problemas principales."
• "Mapea las URL de https://example.com relacionadas con la documentación y lista las 50 primeras."
• "Convierte este informe HTML en un PDF A4 con colores de fondo y márgenes de 1 cm."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot