CLI

Necesita Node.js 20 o posterior. Instálala una vez:

npm i -g @spreva/cli

O ejecuta cualquier comando sin instalarla:

npx -y @spreva/cli overview

Crea una clave en SPREVA en Desarrollo y luego Claves de API, y ponla en el entorno en el que se ejecuta la CLI:

export SPREVA_API_KEY=POST_API_KEY_...
export SPREVA_URL=https://dev-app.spreva.ai

SPREVA_URL apunta la CLI a otra dirección de SPREVA, como una de pruebas, y SPREVA_CONNECTOR=publishing la limita a SPREVA Publishing. Omite las dos para usar SPREVA con todas las herramientas.

spreva overview

El espacio de trabajo de un vistazo: zona horaria y hora, lo que necesita atención, lo próximo que se publica, cuentas, colas y campañas.

spreva search <query...> [key=value ...]

Encuentra publicaciones, archivos, campañas, cuentas y más, por palabras o por lo que muestra una imagen.

spreva search "launch teaser"

spreva fetch <link-or-id>

Lee un elemento completo a partir de su enlace o su ID.

spreva tools

Enumera las herramientas que tu clave puede llamar, con lo que acepta cada una.

spreva call <tool> [--json '<object>'] [key=value ...] [--raw]

Llama a cualquier herramienta, con sus argumentos como pares clave=valor o como JSON, y muestra su respuesta. Termina con el código 1 cuando la respuesta es un error.

spreva call save_post caption="Winter Blend is here" accounts=instagram when=draft request_id=wb-1

spreva docs [page]

Muestra una página de la referencia de SPREVA para agentes, como lo que acepta una red.

spreva docs platforms/tiktok

spreva mcp [--publishing]

Ejecuta un servidor MCP local mediante stdio que transmite cada llamada a SPREVA, para apps que solo inician servidores en tu equipo. --publishing usa SPREVA Publishing.

spreva skill install [--target <agent>] [--dir <path>]

Instala la Agent Skill de SPREVA donde tu agente busca las skills. Sin --target, la instala para cada agente que encuentra en este equipo.

spreva skill install --target claude

spreva skill print

Muestra la skill, para instalarla a mano.

spreva whoami

Muestra el espacio de trabajo y el conector a los que llega tu clave.

spreva doctor

Comprueba tu clave y la conexión con SPREVA, e indica qué corregir.

spreva mcp habla MCP mediante stdio. Añádelo a la configuración de una app que solo inicia servidores locales:

{
  "mcpServers": {
    "spreva": {
      "command": "npx",
      "args": [
        "-y",
        "@spreva/cli",
        "mcp"
      ],
      "env": {
        "SPREVA_API_KEY": "POST_API_KEY_...",
        "SPREVA_URL": "https://dev-app.spreva.ai"
      }
    }
  }
}

Ofrece las mismas herramientas que la URL del conector, con los mismos permisos.

spreva skill install pone la Agent Skill de SPREVA donde tu agente busca las skills, para que sepa cuándo usar la CLI y cómo. Consulta Agent Skill.

Cuando algo no funcione, empieza por aquí. Comprueba tu clave y la conexión con SPREVA, e indica qué corregir.

spreva doctor