# CLIのコマンドと設定

正規URL： https://sosoapi.ai/ja/docs/cli-reference

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

## コマンド

インストール版の対応フラグは--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
```

- [認証と権限](https://sosoapi.ai/ja/docs/authentication)

## JSON標準入力でAPIルートを呼ぶ

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

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

```
{}
```

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

- [完全なAPIリファレンス](https://sosoapi.ai/ja/docs/api)

## 環境変数

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の警告を追加します。内容の無害化と切り詰めも行いますが、エージェントは操作権限ではなくデータとして扱う必要があります。