agent-browser-mcp-codex

Expone las capacidades de agent-browser local como herramientas MCP y facilita la integración rápida con Codex.

Inicio rápido para Codex

Requisito previo: agent-browser debe estar ya instalado localmente.

1. Ejecuta npx agent-browser-mcp-codex init-codex

2. Reinicia Codex o abre una nueva sesión

Lo que agent-browser ya proporciona

agent-browser ya proporciona una amplia superficie de automatización del navegador, incluyendo:

• Navegación e interacción

• Controles de teclado, ratón, carga, descarga y desplazamiento

• Inspección de páginas y recuperación de información

• Pestañas, sesiones, almacenamiento y operaciones de red

• Depuración, comparación (diffing), grabación y streaming

• Comandos de autenticación, chat, panel de control y configuración

Lo que este wrapper MCP expone actualmente

Este paquete expone actualmente un subconjunto enfocado de comandos de agent-browser:

• Navegación: open, back, forward, reload

• Interacción: click, fill, type

• Lectura y estado de la página: get_title, get_text, get_html, snapshot, screenshot, wait

• Pestañas: tab_list, tab_new, tab_close

• Tiempo de ejecución: eval

• Almacenamiento y red: cookies_get, network_requests

• Sesiones y paso directo (raw passthrough): session_current, session_list, session_close, run_raw_command

Configuración manual

Si deseas conectar el plugin manualmente, las plantillas locales de Codex se encuentran en codex/plugin/.

Limitaciones

• Este paquete expone actualmente un subconjunto de la CLI de agent-browser original, no la superficie completa.

• Algunas familias de herramientas son intencionalmente limitadas en este momento.

• Es posible que se añada una mayor cobertura con el tiempo, pero la superficie actual debe tratarse como algo en evolución.

Desarrollo

Para la verificación local:

• npm test

• npm run typecheck

Lanzamiento

• Configura un secreto NPM_TOKEN en el repositorio de GitHub antes de la primera publicación automatizada.

• Crea y publica un GitHub Release para activar la publicación en npm para la versión actual del paquete.