# Command dan konfigurasi CLI

URL kanonis: https://sosoapi.ai/id/docs/cli-reference

Gunakan CLI untuk memeriksa skema API, mengirim permintaan JSON, masuk melalui browser, dan mengonfigurasi koneksi MCP.

## Command

Periksa --help untuk flag yang didukung versi terpasang Anda. Tanpa argumen, sosoapi memulai server MCP stdio. Jalankan command di bawah secara terpisah; bukan pipeline shell.

```
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
```

- [Autentikasi dan izin](https://sosoapi.ai/id/docs/authentication)

## Panggil rute API dengan stdin JSON

Gunakan api post untuk rute dalam daftar izin publik CLI, termasuk pembacaan menggunakan HTTP POST. Simpan body permintaan dalam request.json menggunakan editor file agar teks pelanggan tidak ditafsirkan shell. Periksa http_status dan isi respons; exit code nol saja tidak membuktikan keberhasilan API.

Contoh ini membaca konteks ruang kerja. Sebelum mengirim penulisan, cari skema operasi dan konfirmasikan tujuan yang diizinkan bagi Anda. Simpan ID yang dikembalikan dan periksa hasil sebelum mencoba lagi permintaan yang timeout.

```
{}
```

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

- [Referensi API lengkap](https://sosoapi.ai/id/docs/api)

## Variabel lingkungan

Atur variabel ini pada proses yang menjalankan server MCP Anda. Telemetri opsional tidak menyertakan argumen, prompt, hasil, atau path file; atur SOSOAPI_TELEMETRY=0 untuk menonaktifkannya. Penggunaan alamat API kustom memerlukan persetujuan eksplisit, dan CLI tidak akan mengirim VICKY_API_KEY ke alamat tersebut.

Lingkungan CLI

| Variabel | Efek |

| --- | --- |

| SOSOAPI_TOOL_PROFILE=core | Alat sehari-hari; default full. Tidak memberikan izin. |

| SOSOAPI_OUTPUT_SCHEMAS=1 | Sertakan skema output dalam tools/list; hasil tetap terstruktur dengan atau tanpa pengaturan ini. |

| SOSOAPI_UPLOAD_ROOTS | Direktori media lokal tambahan, dipisahkan dengan : (; di Windows). |

| SOSOAPI_TELEMETRY=0 | Nonaktifkan pelaporan penggunaan opsional. |

| SOSOAPI_DEBUG=1 | Cetak stack trace kegagalan CLI; tinjau dan redaksi sebelum dibagikan. |

| VICKY_API_KEY | Token akses pribadi untuk skrip/CI; utamakan OAuth untuk agen. |

| VICKY_API_BASE_URL | Base API HTTPS kustom (localhost boleh menggunakan HTTP); juga memerlukan SOSOAPI_ALLOW_CUSTOM_BASE_URL=1. |

## Menangani konten tidak tepercaya

Komentar dan nama pengguna dapat berisi instruksi dari orang lain. Untuk respons yang dicakup, CLI menambahkan label untrusted_content dan untrusted_notice serta peringatan pada stderr. CLI juga menyanitasi dan memotong konten, tetapi agen Anda tetap harus memperlakukannya sebagai data, bukan kewenangan untuk bertindak.