sncro.net

oficial

Depuración en vivo del navegador para asistentes de IA — DOM, consola, red a través de MCP.

GitHub

¿Qué puedes hacer con Sncro Net MCP?

Crear una sesión de depuración — pídele a tu asistente de IA que llame a create_session para que puedas conectar una pestaña del navegador en vivo al relay.
Inspeccionar la página actual — solicita una instantánea completa del DOM de la pestaña del navegador conectada usando get_page_snapshot.
Consultar un elemento específico — pídele al asistente que recupere detalles sobre un elemento del DOM mediante query_element.
Capturar la salida de la consola — haz que el asistente muestre los registros y errores de la consola que agent.js envió desde el navegador.
Integrar sncro en una aplicación FastAPI o Flask — incorpora el middleware proporcionado para que tu servidor de desarrollo local inyecte agent.js automáticamente.

Documentación

sncro-relay

Componentes de código abierto de sncro — el relay MCP, el agente del lado del navegador y los plugins del framework que permiten a los asistentes de codificación con IA inspeccionar un navegador en vivo.

Qué contiene este repositorio

Ruta	Qué es
`relay/`	Aplicación FastAPI que expone un servidor MCP más endpoints de long-poll para agent.js
`relay/static/agent.js`	Script del lado del navegador inyectado por el middleware; envía datos de consola y DOM al relay
`middleware/sncro_middleware.py`	Plugin para FastAPI / Starlette — middleware directo para aplicaciones FastAPI
`middleware/sncro_flask.py`	Plugin para Flask — middleware directo para aplicaciones Flask
`trysncro/`	`try.sncro.net` — una app demo deliberadamente rota para probar sncro de extremo a extremo

Cómo funciona

 ┌──────────────┐    MCP     ┌──────────┐   long-poll   ┌─────────────┐
 │ Claude Code  │──tools────▶│  relay   │◀──────────────│  agent.js   │
 │ (or other    │            │ (relay/) │   snapshots   │ (injected   │
 │  MCP client) │◀──results──│          │──────────────▶│  by plugin) │
 └──────────────┘            └──────────┘               └─────────────┘
                                                              ▲
                                                              │ same-origin
                                                              │ cookies
                                                       ┌─────────────┐
                                                       │  your app   │
                                                       │ (plugin is  │
                                                       │  installed) │
                                                       └─────────────┘

Claude llama a create_session (herramienta MCP) → el relay devuelve una clave de sesión de 9 dígitos + URL
El usuario visita la URL en el navegador donde se ejecuta su aplicación → confirma mediante "¿Permitir depuración de sncro?"
El plugin establece una cookie, agent.js se inyecta en las respuestas HTML subsiguientes en ese origen
agent.js envía datos de referencia (consola, errores) y realiza long-polling para consultas bajo demanda (query_element, get_page_snapshot, etc.)

Uso de sncro

La mayoría de los usuarios no necesitan ejecutar el relay por sí mismos — la versión alojada en relay.sncro.net es amigable con el nivel gratuito. Registra tu proyecto en sncro.net y obtén tu clave de proyecto.

FastAPI: coloca middleware/sncro_middleware.py en tu proyecto, luego:

from middleware.sncro_middleware import SncroMiddleware, sncro_routes

app = FastAPI(debug=True)  # sncro only loads when debug=True
if app.debug:
    app.include_router(sncro_routes)
    app.add_middleware(SncroMiddleware, relay_url="https://relay.sncro.net")

Flask: coloca middleware/sncro_flask.py en tu proyecto, luego:

from sncro_flask import init_sncro

app = Flask(__name__)
if app.debug:
    init_sncro(app, relay_url="https://relay.sncro.net")

Ambos middlewares solo se activan en modo debug — cero sobrecarga en producción.

Contribuciones

Nos encantan los nuevos plugins de framework. CONTRIBUTING.md tiene la especificación completa de lo que debe hacer un plugin — cookies, rutas, cabeceras de seguridad — además de la plantilla de prueba. Django, Rails, Express, Next.js, ASP.NET, Go — todos son bienvenidos.

Informes de errores y problemas de seguridad: consulta SECURITY.md.

Licencia

MIT. Consulta LICENSE.

El panel de control en sncro.net (gestión de proyectos, facturación, administración) reside en un repositorio propietario separado.