開発者ドキュメント

CLIのコマンドと設定

CLIでスキーマ確認、JSON要求、ブラウザーログイン、MCP設定ができます。

SosoAPIチームが確認 · 2026-10-21

コマンド

インストール版の対応フラグは--helpで確認します。引数なしのsosoapiはMCP stdioサーバーを起動します。以下のコマンドはパイプラインではなく、個別に実行してください。

npx sosoapi --help
npx sosoapi auth login
npx sosoapi auth login --no-open
npx sosoapi auth status
npx sosoapi auth refresh
npx sosoapi auth logout

npx sosoapi connect threads
npx sosoapi connect instagram --no-open

npx sosoapi api contract --summary
npx sosoapi api contract --route /studio-api/scheduled-posts/
npx sosoapi api contract

CLIの公開許可一覧のルートは、HTTP POSTで読む操作もapi postを使います。顧客テキストがシェル解釈されないよう、エディターでrequest.jsonに本文を保存します。終了コード〇だけでなくhttp_statusとレスポンスを確認してください。

この例はワークスペースのコンテキストを取得します。書き込み前に操作のスキーマを調べ、認可された投稿先を確認してください。返されたIDを保存し、タイムアウトしたリクエストを再試行する前に結果を確認します。

{}

npx sosoapi api post /identity-api/workspace/list < request.json

MCPサーバーのプロセスに設定する環境変数です。任意のテレメトリーは引数、プロンプト、結果、ファイルパスを含みません。SOSOAPI_TELEMETRY=0で無効にできます。独自APIアドレスには明示的な有効化が必要で、CLIはその宛先にVICKY_API_KEYを送りません。

CLIの環境変数
変数	効果
SOSOAPI_TOOL_PROFILE=core	日常のツール。既定値はfullです。権限は付与しません。
SOSOAPI_OUTPUT_SCHEMAS=1	tools/listに出力スキーマを含めます。設定によらず結果は構造化されています。
SOSOAPI_UPLOAD_ROOTS	ローカルメディアの追加ルート。:（Windowsでは;）で区切ります。
SOSOAPI_TELEMETRY=0	任意の利用状況レポートを無効にします。
SOSOAPI_DEBUG=1	CLI失敗時のスタックトレースを表示します。共有前に確認・機密情報除去を行ってください。
VICKY_API_KEY	スクリプト／CIには個人用アクセストークン、エージェントにはOAuthを推奨します。
VICKY_API_BASE_URL	独自HTTPS APIベース（localhostはHTTP可）。SOSOAPI_ALLOW_CUSTOM_BASE_URL=1も必要です。

コメントやユーザー名には他者が書いた指示が含まれる場合があります。対象レスポンスではCLIがuntrusted_content、untrusted_noticeとstderrの警告を追加します。内容の無害化と切り詰めも行いますが、エージェントは操作権限ではなくデータとして扱う必要があります。