Groundlane

English | 繁體中文

La capa de acceso web de confianza para agentes de IA.

Groundlane es un servidor MCP remoto de código abierto y neutral respecto al proveedor, diseñado para dar a los agentes de IA un acceso controlado a la web pública. Presenta una interfaz estable para búsqueda, recuperación y extracción determinista, enruta la búsqueda hacia proveedores sustituibles y escala las lecturas complejas de Markdown mediante un Jina Reader opcional antes de recurrir a un navegador local aislado o a Browserless.

[!IMPORTANT] Groundlane es una vista previa temprana. Sus contratos de herramientas y su modelo de despliegue aún están en evolución; no trates la versión actual como un servicio alojado ni como una solución universal contra el bloqueo automatizado.

Por qué Groundlane

• Neutral respecto al modelo: conéctate a cualquier cliente MCP HTTP Streamable en lugar de depender de la herramienta web integrada de un proveedor de modelos.

• Neutral respecto al proveedor: enruta entre APIs de búsqueda con cuotas mensuales gratuitas recurrentes bajo un único contrato de resultados normalizado.

• HTTP primero, navegador cuando sea necesario: mantén rápidas las lecturas habituales y reserva Chromium para JavaScript, condiciones de espera y señales de respaldo compatibles.

• Extracción determinista: selecciona campos con selectores CSS y recibe JSON estructurado sin un paso implícito de LLM.

• Seguridad primero: autentica el endpoint MCP y aplica límites de URL, redirecciones, red, tiempo de espera, salida y concurrencia.

• Despliegue autogestionado: ejecuta el plano de control y la carga de trabajo del navegador en tu propio entorno, incluidos Cloudflare Workers y Containers.

Related MCP server: agentfetch

Herramientas MVP

La automatización del navegador es un detalle de implementación interno llamado Groundlane Browser. Groundlane no expone sesiones de navegador persistentes en el MVP.

Inicio rápido

Requisitos previos

• Node.js 22 o superior

• pnpm 10

• Chromium para el respaldo con navegador

• Al menos una clave de proveedor de búsqueda gratuita mensual si quieres usar web_search (Tavily, Exa, Parallel, Browserbase, Brave, Firecrawl o SerpApi)

Ejecución local

Clona este repositorio y ejecuta:

pnpm install
pnpm exec playwright install chromium
cp .env.example .env
set -a
source .env
set +a
pnpm dev

Establece un GROUNDLANE_AUTH_TOKEN seguro en .env. Añade una o más claves de proveedor compatibles para habilitar la búsqueda. El servidor local escucha en el PORT configurado y sirve:

• POST /mcp — endpoint MCP HTTP Streamable autenticado

• GET /healthz — estado del proceso

• GET /readyz — disponibilidad del contenedor y estado de la configuración del servicio

Conexión de un cliente MCP

Configura un cliente MCP HTTP Streamable con la URL del servidor y el token de portador. Las formas de configuración del cliente varían, pero los valores de conexión son:

URL: http://localhost:8080/mcp
Authorization: Bearer <GROUNDLANE_AUTH_TOKEN>

Nunca pongas el token en una cadena de consulta ni lo confirmes en el control de versiones.

Con el servidor en marcha, abre otra terminal, carga el mismo .env y verifica el protocolo de enlace MCP y la ruta HTTP pública:

set -a
source .env
set +a
pnpm smoke

Establece GROUNDLANE_SMOKE_BROWSER=1 para incluir la ruta del navegador.

Configuración

Groundlane lee la configuración de variables de entorno. Consulta .env.example para ver una plantilla local completa.

La ausencia de credenciales de búsqueda no impide que web_fetch o web_extract funcionen. Solo deja indisponible al proveedor de búsqueda correspondiente.

Los presupuestos mensuales cuentan los intentos de solicitud a proveedores, incluidos los fallos reintentables, e impiden que una instancia de Groundlane seleccione un proveedor una vez superado su límite configurado. Son deliberadamente conservadores, pero no reflejan la facturación real: los contenedores se reinician, varias instancias no comparten contadores y algunos proveedores cobran créditos variables. Mantén habilitados los límites de gasto del proveedor y ajusta los presupuestos según tus planes reales.

Arquitectura

MCP client
    |
    v
Cloudflare Worker / Node HTTP edge
    |  authentication, limits, request identity
    v
tool registry
    |-- web_search  -> monthly-free provider router (7 adapters)
    |-- web_fetch   -> safe HTTP -> optional Jina Reader -> browser fallback
    `-- web_extract -> fetch pipeline -> deterministic DOM extraction

Las políticas y contratos principales no dependen de un proveedor ni del runtime del navegador. Los adaptadores se sitúan tras interfaces estrechas. El backend del navegador puede ser Playwright local en el contenedor o /content de Browserless; los campos de salida engine y backend revelan qué ruta produjo un resultado sin cambiar las herramientas MCP públicas. Los backends alojados reciben la URL pública solicitada, por lo que son opcionales y no silenciosos por defecto.

Lee Arquitectura para conocer los límites de los componentes, el flujo de solicitudes y las decisiones de diseño.

Seguridad

La recuperación web es una capacidad sensible a SSRF. Groundlane trata las URL de los usuarios, las redirecciones, los subrecursos del navegador y las URL de los proveedores de búsqueda como no confiables. Los despliegues deben mantener la autenticación habilitada, usar una política de red de salida y conservar los límites de recursos predeterminados.

El proyecto no promete resolución universal de CAPTCHA, automatización invisible ni acceso a contenido que no estés autorizado a recuperar. Los operadores son responsables de los términos de los sitios de destino, las políticas de robots, las obligaciones de privacidad y la legislación aplicable.

Consulta SECURITY.md para conocer el modelo de seguridad y el proceso privado de notificación de vulnerabilidades.

Despliegue

La topología de producción prevista usa un Cloudflare Worker como plano de control público y un Cloudflare Container para la carga de trabajo del navegador Node/Playwright. Para requisitos previos, secretos, pasos de despliegue y verificación, consulta Despliegue en Cloudflare.

Hoja de ruta

• Definir la superficie neutral de web_fetch, web_search y web_extract determinista

• Añadir backends de recuperación opcionales de Jina Reader y Browserless con procedencia

• Estabilizar los contratos MCP y publicar accesorios de compatibilidad

• Endurecer el despliegue de Cloudflare Worker + Container y la telemetría operativa

• Añadir adaptadores de caché y enrutamiento consciente de salud/coste del proveedor

• Añadir primitivas opcionales de lote/rastreo con presupuestos explícitos

• Evaluar sesiones de navegador con estado como una capacidad separada y segura en cuanto a ciclo de vida

La hoja de ruta es orientativa, no un compromiso de publicación. Consulta el archivo de investigación para ver la evidencia que respalda el alcance actual.

Documentación

• Arquitectura

• Requisitos de producto del MVP

• Despliegue en Cloudflare

• Política de seguridad

• Contribución

• Archivo de investigación

Contribución

Las incidencias y las solicitudes de extracción son bienvenidas. Antes de contribuir, lee CONTRIBUTING.md y el Código de conducta. Las vulnerabilidades de seguridad deben notificarse de forma privada como se describe en SECURITY.md.

Licencia

Groundlane está licenciado bajo la Apache License 2.0.