Skip to main content
Glama
xlreon
by xlreon

Chrome Actuator

Compañero no oficial: controla la ventana de Chrome que ya tienes abierta desde un agente (probado con Grok Build). El nuevo trabajo aterriza en un grupo de pestañas rosa llamado Actuator en la sesión actual, no en una nueva ventana de Chrome.

tabs_create → snapshot → press @e12 / fill @e5 "text" → settle

v1 es un actuador, no un chatbot de panel lateral. El agente permanece en la terminal. La extensión ve la página, asigna referencias @eN y hace clic/escribe. Tus cookies e inicios de sesión permanecen en Chrome.

No afiliado, respaldado ni patrocinado por xAI. "Grok" y "Grok Build" son marcas de xAI, utilizadas aquí solo para describir compatibilidad. Consulta NOTICE.

Estado

Las fases 0–3 están incluidas. pnpm gauntlet cubre pruebas unitarias, el actuador de script de contenido y una pestaña de Chromium en vivo controlada a través de mensajería nativa.

Fase

Qué

Estado

0

Espacio de trabajo, id de extensión estable, panel lateral

hecho

1

Latido de mensajería nativa

hecho

2

snapshot / press / fill en una pestaña real

hecho

3

Plugin de agente + /chrome + habilidad

hecho

Related MCP server: login-mcp

Cargar la extensión

cd /path/to/chrome-actuator
pnpm install
pnpm --filter @chrome-actuator/extension build
  1. Abre chrome://extensions

  2. Activa el Modo desarrollador

  3. Cargar descomprimida → packages/extension/dist

  4. Fija la extensión y haz clic en ella (o Cmd+Mayús+G)

Luego registra el host nativo (una vez) y cierra Chrome por completo:

node packages/host/dist/install.js

--trust en la instalación del plugin permite que el agente opere este perfil de Chrome. Solo hazlo si confías en el agente.

grok plugin install ./packages/plugin --trust

El panel lateral debería mostrar conectado una vez que el host MCP esté en ejecución.

pnpm gauntlet   # unit + L3 + live native-messaging L4

Id de extensión descomprimida estable (de la clave de manifiesto confirmada key): lgkcgenkjaalkfnpmglgpfclkaokblfj

Decisiones que no reabriremos

  • Cerebro en el agente, cuerpo en Chrome. Sin bucle LLM dentro de la extensión en v1.

  • Mensajería nativa, no WebSocket, no Playwright, no agente-dispositivo-el-binario.

  • Contrato agente-dispositivo solo (snapshot / press / fill).

  • Sin chrome.debugger en v1 (sin barra de información amarilla).

  • Implementación independiente. No copies la marca, marcas o internos de ingeniería inversa de otro proveedor en este árbol.

Diseño

packages/shared      protocol, snapshot grammar, target parser
packages/extension   MV3 side panel + service worker
packages/host        MCP + native host
packages/plugin      Grok Build plugin (compatibility layer)

Pruebas

pnpm --filter @chrome-actuator/shared test

Licencia

MIT. Consulta LICENSE y NOTICE.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    A
    maintenance
    Enables MCP agents to drive an already signed-in Chrome or Edge browser through a local extension bridge, controlling existing tabs and opening task-related HTTP(S) tabs without remote debugging or profile copying.
    23
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables agents to reuse a human-completed Chrome login session to open confirmed origins, read visible page text, and perform single click, fill, or key press actions without ever handling passwords or exposing cookies.
    6
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP agents to drive the user's already-open Chrome profile through a Manifest V3 extension and loopback bridge, listing and controlling existing tabs, capturing screenshots, and sending clicks, typing, drags and key holds via an independent on-page cursor without moving the system mouse. It also supports form filling, console and network inspection, read-only or confirmed JavaScript execution, file and PDF downloads, and game-style screenshot/action loops with snapshot recovery and an emergency stop.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables reading and acting on pages in an existing Chrome profile through a local extension and Native Messaging host, without moving login data. It exposes 12 tools to list and claim tabs, snapshot visible text and targets, and click, fill, select, or scroll using snapshot IDs.
    PolyForm Noncommercial 1.0.0