CLI

Ela precisa do Node.js 20 ou mais recente. Instale uma vez:

npm i -g @spreva/cli

Ou rode qualquer comando sem instalar:

npx -y @spreva/cli overview

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

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 teste, e SPREVA_CONNECTOR=publishing limita a CLI ao SPREVA Publishing. Deixe as duas de fora para usar o SPREVA com todas as ferramentas.

spreva overview

O espaço de trabalho em um relance: fuso horário e relógio, o que precisa de atenção, o que sai em seguida, contas, filas e campanhas.

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

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

spreva search "launch teaser"

spreva fetch <link-or-id>

Lê um item por completo a partir do link ou do id.

spreva tools

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

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

Chama qualquer ferramenta, com os argumentos como pares key=value ou como JSON, e imprime a resposta. Sai 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]

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

spreva docs platforms/tiktok

spreva mcp [--publishing]

Roda um servidor MCP local por stdio que repassa cada chamada ao SPREVA, para apps que só iniciam servidores na sua máquina. --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 para todos os agentes que encontrar nesta máquina.

spreva skill install --target claude

spreva skill print

Imprime a skill, para você instalar manualmente.

spreva whoami

Mostra o espaço de trabalho e o conector que a sua chave alcança.

spreva doctor

Verifica a sua chave e a conexão com o SPREVA e diz o que corrigir.

spreva mcp fala MCP por stdio. Adicione à configuração de um app 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"
      }
    }
  }
}

Ele 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 ele saber quando e como usar a CLI. Veja Agent Skill.

Quando algo não funcionar, comece por aqui. Ele verifica a sua chave e a conexão com o SPREVA e diz o que corrigir.

spreva doctor