Dokumentasi pengembang

Command dan konfigurasi CLI

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

Ditinjau tim SosoAPI · 2026-10-21

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

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

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.