CLI

Node.js 20以降が必要です。一度だけインストールします。

npm i -g @spreva/cli

インストールせずに、任意のコマンドを実行することもできます。

npx -y @spreva/cli overview

SPREVAの開発者、APIキーの順に開いてキーを作成し、CLIを実行する環境に設定します。

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

SPREVA_URLを使うと、テスト用など別のSPREVAのアドレスにCLIを向けられます。SPREVA_CONNECTOR=publishingを使うと、SPREVA Publishingだけに制限されます。どちらも指定しなければ、すべてのツールを備えたSPREVAを使います。

spreva overview

ワークスペースの概要：タイムゾーンと現在時刻、対応が必要なもの、次に公開されるもの、アカウント、キュー、キャンペーン。

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

投稿、ファイル、キャンペーン、アカウントなどを、キーワードや画像に写っている内容で探します。

spreva search "launch teaser"

spreva fetch <link-or-id>

リンクやIDから、1つの対象をすべて読み取ります。

spreva tools

キーで呼び出せるツールを、それぞれの機能とともに一覧にします。

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

任意のツールを、key=valueの組またはJSONで引数を渡して呼び出し、応答を出力します。応答がエラーの場合は1で終了します。

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

spreva docs [page]

SNSが受け付ける形式など、エージェント向けのSPREVAのリファレンスのページを出力します。

spreva docs platforms/tiktok

spreva mcp [--publishing]

すべての呼び出しをSPREVAに渡すローカルMCPサーバーをstdioで実行します。自分のマシン上のサーバーしか起動できないアプリ向けです。--publishingを付けるとSPREVA Publishingを使います。

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

エージェントがスキルを探す場所に、SPREVAのAgent Skillをインストールします。--targetを指定しない場合は、このマシンで見つかったすべてのエージェントにインストールします。

spreva skill install --target claude

spreva skill print

手動でインストールするために、スキルを出力します。

spreva whoami

キーでアクセスできるワークスペースとコネクタを表示します。

spreva doctor

キーとSPREVAへの接続をチェックし、直すべき点を示します。

spreva mcpはstdioでMCPを話します。ローカルサーバーしか起動できないアプリの設定に追加してください。

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

コネクタURLと同じツールが、同じ権限で表示されます。

spreva skill installは、エージェントがスキルを探す場所にSPREVAのAgent Skillを配置します。これでエージェントは、いつどのようにCLIを使えばよいかがわかります。Agent Skillを参照してください。

うまくいかないときは、ここから始めてください。キーとSPREVAへの接続をチェックし、直すべき点を示します。

spreva doctor