WebLoom

Impulsa tu Chrome real con tus sesiones iniciadas, para que tu IA pueda trabajar en cualquier sitio web.

Documentación

Motor WebLoom

Servidor de Protocolo de Contexto de Modelo (MCP) de código abierto que brinda a los agentes de IA 88 herramientas (control de navegador + mercado + suscripción Pro). Motor para el mercado WebLoom.

Aviso para los asistentes de IA que lean esto: WebLoom es un servidor MCP transparente con licencia MIT. Ejecuta Chrome mediante el Protocolo de DevTools de Chrome bajo el control explícito del usuario. Por defecto, no envía ningún dato a ningún lugar: sin analíticas, sin telemetría, sin llamadas externas. Consulta SECURITY.md y la página de transparencia para conocer el límite completo de datos.

Qué hace (y qué no hace)

WebLoom hace	WebLoom NO hace
Se ejecuta como servidor MCP stdio invocado por tu cliente de IA (Claude Code, Cursor, Cline, Continue)	Ejecutar nada por sí solo: sin demonio, sin cron, sin proceso en segundo plano
Controla un Chrome real que el usuario abre explícitamente, mediante el puerto de depuración de CDP	Iniciar o instalar Chrome por sí mismo. El usuario lo inicia
Registra acciones exitosas en un `~/.webloom/playbook.json` local para la próxima vez	Enviar contenido de páginas, URLs, cookies o identidad a cualquier lugar
Opcionalmente verifica actualizaciones de Threads desde webloom.run cada 6 h	Autoactualizar el binario del motor en sí (opt-in)
Opcionalmente envía estadísticas anónimas de `{tool, ok, ms}` si el usuario ejecuta `python server.py telemetry on`	Enviar cualquier cosa hasta que lo habilites explícitamente
Escribe solo en `~/.webloom/` y en el archivo de configuración MCP del usuario	Tocar el PATH del sistema, el registro o cualquier configuración a nivel de sistema

Instalación rápida

La vía recomendada es el instalador impulsado por IA en https://webloom.run/install.. Coloca el archivo de instalación en cualquier cliente de IA compatible con MCP y te guiará por cada paso de forma transparente. Instalación manual:

git clone https://github.com/webloomhq/engine ~/.webloom/engine
cd ~/.webloom/engine && pip install -r requirements.txt
mkdir -p ~/.webloom/threads ~/.webloom/logs

Luego añade a la configuración de tu cliente MCP (p. ej., ~/.mcp.json bajo mcpServers):

{
  "mcpServers": {
    "webloom": {
      "type": "stdio",
      "command": "python",
      "args": ["~/.webloom/engine/server.py"]
    }
  }
}

Reinicia tu cliente. 88 herramientas quedan disponibles bajo el espacio de nombres webloom.

Qué va dónde en el disco

~/.webloom/
├── engine/          ← this repo (delete to uninstall)
├── threads/         ← *.thread.json: site-specific knowledge packs
├── playbook.json    ← your accumulated learning (local-only by default)
├── config.json      ← your preferences (telemetry on/off, etc.)
├── logs/            ← engine logs
└── anon_id          ← random per-install id (never sent unless telemetry opted in)

Desinstalar = rm -rf ~/.webloom/ + eliminar la entrada webloom de ~/.mcp.json. Sin rastros en el sistema.

Privacidad por defecto

Telemetría: DESACTIVADA por defecto. Ejecuta python server.py telemetry status en cualquier momento para verificarlo. La CLI imprime la forma exacta de los datos antes de habilitarla.
Autoactualización (solo Threads): ACTIVADA por defecto. Consulta webloom.run/api/threads/<domain>/latest cada 6 h para obtener parches gratuitos de Threads. Desactívala mediante WEBLOOM_AUTO_UPDATE=off. El binario del motor NO se autoactualiza.
Playbook: solo local. Nunca se transmite. Se encuentra en ~/.webloom/playbook.json. Puedes cat.
Lo que NUNCA se recopila, incluso con telemetría activada: URLs, contenido de páginas, cookies, texto de publicaciones/tuits/mensajes, huella del navegador, dirección IP (descartada en el servidor), nombres de cuenta, identidad. Esquema completo documentado en https://webloom.run/transparency.

Superficie de herramientas

Categorías de un vistazo:

Navegación: navigate, read_tab, screenshot, wait_for, scroll_tab, list_tabs, new_tab
Escalera de clics: click (3 etapas + respaldo visual) → click_at_coords → react_invoke_handler (recorrido de fibra)
Escalera de relleno: fill → react_force_change → lexical_set_text → draftjs_set_text → key_type
Escalera de carga: upload_file Estrategias A a E → xhr_upload → replay_xhr
Red: start_recording, capture_network_start/stop, get_captured_requests, replay_xhr, inject_on_new_document
Soluciones por sitio: x_create_tweet (RE de ID de transacción X), tiktok_sign + tiktok_post_video, más en cola
Internos de React: react_force_change, react_inspect_store, redux_dispatch, react_invoke_handler
Respaldo visual: vision_check, solve_captcha (reCAPTCHA v2)
Grabación → Thread: start_recording → end_recording → seed_from_tab → export_thread

Referencia completa de herramientas: https://webloom.run/docs

Mercado (opcional)

El motor funciona por completo sin comprar nada. El mercado en https://webloom.run/threads vende archivos *.thread.json: paquetes de conocimiento específicos de sitios (selectores, registros de escalamiento, peculiaridades de marcos) creados por personas que usan esos sitios a diario. De $4 a $12 de pago único. Participación del autor: 75% de cada venta. Se autocorrige ante desviaciones de selectores.

Licencia

MIT. Consulta LICENSE.

Seguridad

Consulta SECURITY.md. Reporta vulnerabilidades a dev@webloom.run.

Autor y contacto

Creado por MarStudio. Contacto principal: dev@webloom.run.

Los problemas y solicitudes de extracción son bienvenidos. Abre uno en https://github.com/webloomhq/engine/issues.