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 會把 CLI 指向其他 SPREVA 位址（例如測試用的位址），SPREVA_CONNECTOR=publishing 則會把它限制在 SPREVA Publishing。兩者都不設定，就會使用包含所有工具的 SPREVA。

spreva overview

工作空間一覽：時區和目前時間、需要處理的事項、接下來要發布的內容、帳號、佇列和行銷活動。

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

依文字或圖片呈現的內容，找到貼文、檔案、行銷活動、帳號等。

spreva search "launch teaser"

spreva fetch <link-or-id>

依連結或 ID 完整讀取一個項目。

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]

輸出一頁給代理程式的 SPREVA 參考資料，例如某個社群平台接受的內容。

spreva docs platforms/tiktok

spreva mcp [--publishing]

透過 stdio 執行本機 MCP 伺服器，把每個呼叫轉送給 SPREVA，適合只會在你的電腦上啟動伺服器的應用程式。--publishing 會使用 SPREVA Publishing。

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

把 SPREVA 的 Agent Skill 安裝到你的代理程式尋找 Skill 的位置。沒有 --target 時，會為這部電腦上找到的每個代理程式安裝。

spreva skill install --target claude

spreva skill print

輸出 Skill 內容，以便手動安裝。

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"
      }
    }
  }
}

它列出的工具和連接器網址相同，權限也相同。

spreva skill install 會把 SPREVA 的 Agent Skill 放到你的代理程式尋找 Skill 的位置，讓它知道何時以及如何使用 CLI。請參閱 Agent Skill。

有東西無法運作時，先從這裡開始。它會檢查你的金鑰和與 SPREVA 的連線，並說明需要修正什麼。

spreva doctor