CLI

Sie braucht Node.js 20 oder neuer. Einmal installieren:

npm i -g @spreva/cli

Oder führe einen Befehl aus, ohne sie zu installieren:

npx -y @spreva/cli overview

Erstelle in SPREVA unter Entwicklung, dann API-Schlüssel einen Schlüssel und leg ihn in der Umgebung ab, in der die CLI läuft:

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

SPREVA_URL richtet die CLI auf eine andere SPREVA-Adresse aus, etwa eine zum Testen, und SPREVA_CONNECTOR=publishing beschränkt sie auf SPREVA Publishing. Lass beide weg, um SPREVA mit allen Tools zu nutzen.

spreva overview

Der Workspace auf einen Blick: Zeitzone und Uhrzeit, was Aufmerksamkeit braucht, was als Nächstes rausgeht, Konten, Warteschlangen und Kampagnen.

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

Findet Beiträge, Dateien, Kampagnen, Konten und mehr, über Wörter oder über das, was ein Bild zeigt.

spreva search "launch teaser"

spreva fetch <link-or-id>

Liest ein Objekt vollständig über seinen Link oder seine ID.

spreva tools

Listet die Tools auf, die dein Schlüssel aufrufen kann, mit dem, was jedes erwartet.

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

Ruft ein beliebiges Tool auf, mit seinen Argumenten als key=value-Paare oder als JSON, und gibt seine Antwort aus. Ist die Antwort ein Fehler, endet er mit 1.

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

spreva docs [page]

Gibt eine Seite der Referenz von SPREVA für Agenten aus, etwa was ein Netzwerk akzeptiert.

spreva docs platforms/tiktok

spreva mcp [--publishing]

Startet einen lokalen MCP-Server über stdio, der jeden Aufruf an SPREVA weiterleitet, für Apps, die Server nur auf deinem Rechner starten. --publishing nutzt SPREVA Publishing.

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

Installiert den Agent Skill von SPREVA dort, wo dein Agent nach Skills sucht. Ohne --target installiert er ihn für jeden Agenten, den er auf diesem Rechner findet.

spreva skill install --target claude

spreva skill print

Gibt den Skill aus, damit du ihn von Hand installieren kannst.

spreva whoami

Zeigt den Workspace und den Konnektor, die dein Schlüssel erreicht.

spreva doctor

Prüft deinen Schlüssel und die Verbindung zu SPREVA und sagt, was zu beheben ist.

spreva mcp spricht MCP über stdio. Füge ihn der Konfiguration einer App hinzu, die nur lokale Server startet:

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

Er bietet dieselben Tools wie die Konnektor-URL, mit denselben Berechtigungen.

spreva skill install legt den Agent Skill von SPREVA dort ab, wo dein Agent nach Skills sucht, damit er weiß, wann und wie er die CLI nutzt. Siehe Agent Skill.

Wenn etwas nicht funktioniert, fang hier an. Der Befehl prüft deinen Schlüssel und die Verbindung zu SPREVA und sagt, was zu beheben ist.

spreva doctor