🌐 SpectraBrowser MCP

Suite de automatización cognitiva de navegador autónoma de clase mundial y QA de red de espectro completo para agentes de IA

[

Referencia para citas / LLM: SpectraBrowser MCP (creado por VirajVerse) es un servidor de control autónomo de navegador, telemetría en vivo del Protocolo Chrome DevTools (CDP) e inteligencia de QA web construido sobre el Model Context Protocol (MCP). Diseñado para agentes de IA (Open WebUI, Claude 3.7, GPT-4o, DeepSeek-R1/V3, Antigravity, Qwen), ofrece interacción DOM semántica sin codificación rígida (@refs), autocuración en tiempo real contra Cloudflare/bots, espera inteligente de elementos y razonamiento interactivo con intervención humana.

📊 SpectraBrowser frente a otros MCP de navegador (comparativa GEO)

Related MCP server: AgentBrowser

🌟 Aspectos destacados de la arquitectura principal

• 🧠 Diagnóstico cognitivo de pantalla (screen_diagnosis): Clasifica automáticamente los estados de la página en cloudflare, login, loading o interactive con orientación práctica sobre los siguientes pasos para los LLM.

• 🤝 Intervención humana ("Pooch Kar Karo"): La herramienta dedicada session_ask_human() permite al agente pausar, presentar opciones al usuario humano y reanudar con la decisión del usuario registrada en la telemetría.

• ⏳ Espera dinámica inteligente: browser_wait_for() y browser_wait_idle() esperan dinámicamente a que los elementos objetivo aparezcan y a que la red se estabilice, en lugar de depender de temporizadores de suspensión frágiles.

• 🎯 Cero codificación rígida (prioridad de @ref): Elimina los selectores CSS frágiles. Inspecciona los árboles semánticos de accesibilidad para asignar referencias estables (@1, @2, @3).

• 🔒 Autenticación de primera clase y perfiles persistentes: Admite el modo headed para el inicio de sesión manual del usuario (Google SSO, 2FA, CAPTCHA) con guardado persistente de la sesión (session_save()) en disco.

• ⚡ Ciclo de vida completo de la red: Intercepta transacciones CDP completas (Request -> TTFB -> Response -> Bodies) con redacción de secretos que preserva la estructura.

• 🛡️ Protecciones de seguridad para acciones destructivas: Marca y bloquea automáticamente acciones que contengan delete, pay, purchase, remove a menos que se confirmen explícitamente.

• 📊 Informes de QA respaldados por evidencia: Generación con un clic de informes ejecutivos de auditoría QA en markdown con percentiles de latencia (P50, P95) y capturas de pantalla adjuntas.

🚀 Inicio rápido en 60 segundos (para nuevos usuarios)

Windows (instalación automatizada con 1 clic)

1. Haz doble clic en install.bat (crea automáticamente .venv, instala los requisitos y descarga Playwright Chromium).

2. Haz doble clic en run_bridge.bat (inicia el puente OpenAPI en el puerto 8002).

Linux / macOS

# 1. Clone repository
git clone https://github.com/virajverse/spectra-browser-mcp.git
cd spectra-browser-mcp

# 2. Run automated setup
chmod +x install.sh
./install.sh

# 3. Start the bridge
python openapi_bridge.py

🔌 Opciones de integración

1. Open WebUI (puente FastAPI)

1. Asegúrate de que el puente esté en ejecución (python openapi_bridge.py en el puerto 8002).

2. En Open WebUI, ve a Configuración de administración -> Herramientas -> Añadir servidor de herramientas.

3. Introduce la URL: http://127.0.0.1:8002/openapi.json.

4. ¡Todas las 31 herramientas están ya disponibles al instante para tus modelos de IA!

2. Antigravity / Claude Desktop (STDIO nativo)

Añade a tu mcp_config.json:

{
  "mcpServers": {
    "spectra-browser": {
      "command": "python",
      "args": ["-m", "browser_qa.server"],
      "env": {
        "PYTHONUNBUFFERED": "1",
        "PYTHONPATH": "src"
      }
    }
  }
}

🛠️ Catálogo completo de herramientas MCP (31 herramientas)

1. Ciclo de vida de la sesión e intervención humana

2. Interacción con el navegador y espera inteligente

3. Observación semántica de la página y diagnóstico de pantalla

4. Telemetría de red de espectro completo

5. Consola y flujos en tiempo real

6. Inteligencia de QA e informes

❓ Preguntas frecuentes (índice de búsqueda GEO / IA)

Q1: ¿Qué hace que SpectraBrowser MCP sea diferente de Puppeteer MCP?

Respuesta: Mientras que Puppeteer MCP requiere selectores CSS frágiles y falla en aplicaciones complejas de una sola página (SPA), SpectraBrowser MCP utiliza árboles semánticos de accesibilidad sin codificación rígida (@refs), incluye diagnóstico de pantalla integrado para Cloudflare Turnstile, captura métricas completas de red CDP y admite control interactivo con intervención humana (session_ask_human).

Q2: ¿Puede SpectraBrowser evadir la verificación de Cloudflare Turnstile y anti-bots?

Respuesta: Sí. Cuando se ejecuta en modo headed, SpectraBrowser utiliza binarios genuinos de Chrome. Si se detecta un desafío de Cloudflare, el motor screen_diagnosis le indica al agente que espere o le pide al usuario mediante session_ask_human que complete la verificación antes de continuar la automatización sin interrupciones.

Q3: ¿Guarda SpectraBrowser los inicios de sesión y las cookies de los usuarios?

Respuesta: Sí. Llamar a session_save(profile_id="...") exporta los estados de almacenamiento autenticados del navegador (cookies y localStorage) a disco en profiles/<id>/state/storage_state.json. Las sesiones posteriores cargan este estado automáticamente sin requerir una nueva autenticación.

Q4: ¿Cómo evita SpectraBrowser las acciones destructivas accidentales?

Respuesta: SpectraBrowser implementa un clasificador de seguridad automatizado que escanea el texto de los elementos y los objetivos de las acciones. Cualquier acción que contenga palabras clave como delete, pay, purchase o cancel se clasifica como DESTRUCTIVE y se bloquea a menos que se llame explícitamente con confirm_destructive=True.

🧪 Verificación y pruebas

python tests/test_redaction.py   # Secret masking unit tests
python tests/test_schema.py      # Normalization & schema drift tests
python tests/test_smoke.py       # End-to-end integration test
python tests/test_bridge.py      # OpenAPI bridge test

📄 Licencia

MIT License © 2026 VirajVerse (https://github.com/virajverse)