CLI

Precisa do Node.js 20 ou posterior. Instale-a uma vez:

npm i -g @spreva/cli

Ou execute qualquer comando sem a instalar:

npx -y @spreva/cli overview

Crie uma chave no SPREVA em Desenvolvimento, depois Chaves de API, e coloque-a no ambiente em que a CLI é executada:

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

SPREVA_URL aponta a CLI para outro endereço do SPREVA, como um de testes, e SPREVA_CONNECTOR=publishing limita-a ao SPREVA Publishing. Omita os dois para usar o SPREVA com todas as ferramentas.

spreva overview

A área de trabalho num relance: fuso horário e hora, o que precisa de atenção, o que sai a seguir, contas, filas e campanhas.

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

Encontra publicações, ficheiros, campanhas, contas e mais, por palavras ou pelo que uma imagem mostra.

spreva search "launch teaser"

spreva fetch <link-or-id>

Lê um elemento na íntegra a partir da ligação ou do id.

spreva tools

Lista as ferramentas que a sua chave pode chamar, com o que cada uma aceita.

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

Chama qualquer ferramenta, com os argumentos como pares key=value ou em JSON, e mostra a resposta. Termina com 1 quando a resposta é um erro.

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

spreva docs [page]

Mostra uma página da referência do SPREVA para agentes, como o que uma rede aceita.

spreva docs platforms/tiktok

spreva mcp [--publishing]

Executa um servidor MCP local através de stdio que encaminha cada chamada para o SPREVA, para aplicações que só iniciam servidores no seu computador. --publishing usa o SPREVA Publishing.

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

Instala a Agent Skill do SPREVA onde o seu agente procura skills. Sem --target, instala-a para todos os agentes que encontrar neste computador.

spreva skill install --target claude

spreva skill print

Mostra a skill, para a instalar manualmente.

spreva whoami

Mostra a área de trabalho e o conector a que a sua chave chega.

spreva doctor

Verifica a sua chave e a ligação ao SPREVA, e diz o que corrigir.

spreva mcp fala MCP através de stdio. Adicione-o à configuração de uma aplicação que só inicia servidores locais:

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

Lista as mesmas ferramentas que o URL do conector, com as mesmas permissões.

spreva skill install coloca a Agent Skill do SPREVA onde o seu agente procura skills, para que saiba quando e como usar a CLI. Veja Agent Skill.

Quando algo não funciona, comece por aqui. Verifica a sua chave e a ligação ao SPREVA, e diz o que corrigir.

spreva doctor