CLI de Ezeo

Un paquete, un único registro de comandos. "ezeo <comando>" es el CLI y "ezeo mcp" sirve los mismos comandos a cualquier agente compatible con MCP, de modo que un comando que funciona en la terminal funciona igual dentro de Claude Code o Codex.

Es para cualquier propietario, administrador o miembro de una organización de Ezeo: tanto el equipo de Ezeo como los clientes de autoservicio. Las cuentas de cliente usan la aplicación web. El CLI actúa como el usuario que inició sesión, así que la seguridad a nivel de fila, la pertenencia a la organización y los límites de gasto controlan cada llamada, y nunca usa una clave de service role. "ezeo login" rechaza una cuenta de cliente y no guarda nada.

Si "ezeo whoami" indica que tu organización tiene cero proyectos, añade tu sitio en https://ezeo.ai/app o, si instalaste Ezeo con la app de Ezeo para Shopify, reclama tu tienda en https://ezeo.ai/app/shopify/link.

Requiere Node 22 o superior. Instala el paquete desde npm y después inicia sesión:

npm i -g @ezeo/cli

ezeo login
ezeo whoami

Después, cada comando se ejecuta como "ezeo <comando>". Vuelve a ejecutar el mismo comando de instalación para actualizar.

"ezeo login" sin opciones abre el inicio de sesión en el navegador (Google). Google siempre muestra su selector de cuentas, así que elige la cuenta cuyo acceso a Ezeo quieres que use el CLI. Después la terminal muestra con qué usuario iniciaste sesión.

ezeo login
ezeo login --password
ezeo whoami

"ezeo login --password" pide correo y contraseña en la terminal, para una máquina sin navegador; nunca se leen de los argumentos ni del entorno. La sesión se guarda en ~/.config/ezeo/credentials.json (modo 0600). "ezeo logout" la elimina.

Elige un proyecto, gana el de mayor prioridad: --project, luego la variable EZEO_PROJECT, luego project = "Nombre" en un .ezeo.toml buscado hacia arriba desde el directorio actual, y por último lo que guardó "ezeo use". Los nombres coinciden por prefijo; un prefijo ambiguo es un error que lista los candidatos.

Todos los comandos aceptan --json. La ausencia de dato se muestra como un guion en las tablas y como null en JSON, nunca como 0.

Clases de coste

• gratis Lee datos que Ezeo ya tiene. No se gasta nada.
• llm Una llamada a OpenRouter, cargada al proyecto.
• dfs Gasto de DataForSEO contra los límites mensuales compartidos.
• scrape Un rastreo de página con Firecrawl, cargado a Ezeo.
• pipeline Inicia o reanuda ejecuciones de artículos, cada una con gasto de LLM e imágenes.

Cada comando llm, dfs, scrape y pipeline imprime lo que costará antes de ejecutarse. En una terminal después se ejecuta, así que pulsa Ctrl-C si el coste no es el que quieres; cuando stdin no es una terminal, el comando necesita --yes. Si la política de costes rechaza un comando, termina con el código 5 antes de cualquier llamada de red, así que no se gastó nada.

Dentro de un cliente MCP no hay nadie a quien preguntar, así que una herramienta de pago primero devuelve una simulación y un código de confirmación, y solo se ejecuta cuando se vuelve a llamar con la misma entrada y ese código. El código está ligado a la herramienta y a su entrada exacta, y muere con el proceso del servidor. No es de un solo uso, por lo que cada llamada confirmada puede volver a gastar.

Los dos comandos approve requieren --hash, tomado de "ezeo articles show", que lo imprime junto al cuerpo del artículo. No hay valor por defecto ni búsqueda, así que un artículo no se puede aprobar sin haberlo leído. "ezeo articles cancel" no gasta nada pero no se puede deshacer.

"ezeo mcp" sirve el registro por stdio. "ezeo setup" lo registra en un agente por ti e imprime exactamente lo que ejecuta; añade --dry-run para imprimir sin cambiar nada.

ezeo setup claude
ezeo setup codex
ezeo setup grok
ezeo setup gemini
ezeo setup cursor
ezeo setup claude --dry-run

Instala la referencia para agentes como una skill de Claude para que el agente conozca las reglas antes de llamar a nada. "ezeo help --agent" imprime la referencia y "ezeo skill install" la escribe en ~/.claude/skills/ezeo/SKILL.md.

ezeo help --agent
ezeo skill install
ezeo skill install --dry-run

Por MCP, una llamada que sigue en curso tras 45 segundos devuelve STILL RUNNING y un id de trabajo; la herramienta ezeo_job recoge el resultado.

• 0: correcto
• 1: uso, por ejemplo una opción incorrecta o un proyecto ambiguo
• 2: sin sesión iniciada, o el rol es rechazado
• 3: el servidor respondió que no
• 4: la petición nunca llegó al servidor
• 5: rechazado localmente por la política de costes; no se gastó nada