Ir para o conteúdo

Referência

CLI

O SPREVA na linha de comando: para agentes que trabalham em um terminal, para scripts e como servidor MCP local para apps que só iniciam servidores na sua máquina.

Instalação

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

Terminal
npm i -g @spreva/cli

Ou rode qualquer comando sem instalar:

Terminal
npx -y @spreva/cli overview

A sua chave de API

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

Terminal
export SPREVA_API_KEY=spreva_sk_...

SPREVA_URL aponta a CLI para outro endereço do SPREVA, como um de teste. Sem SPREVA_URL, a CLI usa o próprio SPREVA.

Comandos

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 faz.
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
Roda um servidor MCP local por stdio que repassa cada chamada ao SPREVA, para apps que só iniciam servidores na sua máquina.
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 que a sua chave alcança.
spreva doctor
Verifica a sua chave e a conexão com o SPREVA e diz o que corrigir.

Como servidor MCP local

spreva mcp fala MCP por stdio. Adicione à configuração de um app que só inicia servidores locais:

JSON
{
  "mcpServers": {
    "spreva": {
      "command": "npx",
      "args": [
        "-y",
        "@spreva/cli",
        "mcp"
      ],
      "env": {
        "SPREVA_API_KEY": "spreva_sk_..."
      }
    }
  }
}

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

Com a Agent Skill

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.

Conferir a configuração

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.

Terminal
spreva doctor