CLI

La CLI nécessite Node.js 20 ou une version ultérieure. Installez-la une seule fois :

npm i -g @spreva/cli

Ou exécutez n’importe quelle commande sans l’installer :

npx -y @spreva/cli overview

Créez une clé dans SPREVA sous Développeurs, puis Clés API, et placez-la dans l’environnement où s’exécute la CLI :

export SPREVA_API_KEY=spreva_sk_...

SPREVA_URL fait pointer la CLI vers une autre adresse SPREVA, comme une adresse de test, et SPREVA_CONNECTOR=publishing la limite à SPREVA Publishing. Omettez les deux pour utiliser SPREVA avec tous les outils.

spreva overview

L’espace de travail en un coup d’œil : fuseau horaire et heure, ce qui demande votre attention, les prochaines publications, les comptes, les files d’attente et les campagnes.

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

Trouve des publications, des fichiers, des campagnes, des comptes et plus encore, par mots ou d’après ce que montre une image.

spreva search "launch teaser"

spreva fetch <link-or-id>

Lit un élément en entier à partir de son lien ou de son identifiant.

spreva tools

Liste les outils que votre clé peut appeler, avec ce que fait chacun.

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

Appelle n’importe quel outil, avec ses arguments sous forme de paires key=value ou en JSON, et affiche sa réponse. La commande se termine avec le code 1 quand la réponse est une erreur.

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

spreva docs [page]

Affiche une page de la référence de SPREVA pour les agents, par exemple ce qu’accepte un réseau.

spreva docs platforms/tiktok

spreva mcp [--publishing]

Lance un serveur MCP local via stdio qui transmet chaque appel à SPREVA, pour les applications qui ne démarrent que des serveurs sur votre machine. --publishing utilise SPREVA Publishing.

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

Installe l’Agent Skill de SPREVA là où votre agent cherche ses skills. Sans --target, la commande l’installe pour chaque agent trouvé sur cette machine.

spreva skill install --target claude

spreva skill print

Affiche le skill, pour l’installer à la main.

spreva whoami

Indique l’espace de travail et le connecteur qu’atteint votre clé.

spreva doctor

Vérifie votre clé et la connexion à SPREVA, et indique ce qu’il faut corriger.

spreva mcp parle MCP via stdio. Ajoutez-le à la configuration d’une application qui ne démarre que des serveurs locaux :

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

Il propose les mêmes outils que l’URL du connecteur, avec les mêmes autorisations.

spreva skill install place l’Agent Skill de SPREVA là où votre agent cherche ses skills, pour qu’il sache quand et comment utiliser la CLI. Voir Agent Skill.

Quand quelque chose ne fonctionne pas, commencez ici. Cette commande vérifie votre clé et la connexion à SPREVA, et indique ce qu’il faut corriger.

spreva doctor