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.

Related MCP server: monkeysee

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.