Fejlesztői dokumentáció

CLI-parancsok és konfiguráció

A CLI-vel API-sémákat vizsgálhatsz, JSON-kéréseket küldhetsz, böngészőben bejelentkezhetsz és MCP-kapcsolatot állíthatsz be.

Olvasás Markdown formátumban

Ellenőrizte a SosoAPI csapata · 2026-10-21

Parancsok

A telepített verzió által támogatott kapcsolókat a --help mutatja. Argumentum nélkül a sosoapi az MCP stdio szervert indítja. Az alábbi parancsokat külön futtasd; nem shell-csővezetéket alkotnak.

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

Hitelesítés és engedélyek

API-útvonal hívása JSON stdin bemenettel

A CLI nyilvános engedélylistáján szereplő útvonalakhoz használd az api post parancsot, beleértve a HTTP POST-ot használó olvasásokat. Fájlszerkesztővel mentsd a kérés törzsét request.json fájlba, hogy az ügyfélszöveget ne értelmezze a shell. Ellenőrizd a http_status értékét és a válasz törzsét; a nulla kilépési kód önmagában nem igazol API-sikert.

Ez a példa a munkaterület-kontextust olvassa. Írás küldése előtt keresd ki a művelet sémáját, és erősítsd meg az engedélyezett célhelyet. Mentsd el a visszakapott azonosítót, és időtúllépéses kérés újrapróbálása előtt ellenőrizd az eredményt.

{}

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

Teljes API-referencia

Környezeti változók

Ezeket a változókat az MCP-szervert futtató folyamatban állítsd be. Az opcionális telemetria nem tartalmaz argumentumokat, promptokat, eredményeket vagy fájlútvonalakat; a SOSOAPI_TELEMETRY=0 kikapcsolja. Az egyéni API-cím kifejezett engedélyezést igényel, és a CLI nem küldi el oda a VICKY_API_KEY értékét.

CLI-környezeti változók
Változó	Hatás
SOSOAPI_TOOL_PROFILE=core	Mindennapi eszközök; alapérték full. Nem ad engedélyt.
SOSOAPI_OUTPUT_SCHEMAS=1	Kimeneti sémák hozzáadása a tools/list válaszhoz; az eredmények mindkét esetben strukturáltak.
SOSOAPI_UPLOAD_ROOTS	További helyi médiagyökerek, : jellel elválasztva (Windows esetén ;).
SOSOAPI_TELEMETRY=0	Opcionális használati jelentések kikapcsolása.
SOSOAPI_DEBUG=1	CLI-hibák veremkövetésének kiírása; megosztás előtt ellenőrizd és távolítsd el a bizalmas adatokat.
VICKY_API_KEY	Személyes hozzáférési token szkriptekhez/CI-hez; ügynökökhöz inkább OAuth használata ajánlott.
VICKY_API_BASE_URL	Egyéni HTTPS API-alapcím (localhost használhat HTTP-t); SOSOAPI_ALLOW_CUSTOM_BASE_URL=1 is kell.

Nem megbízható tartalom kezelése

A hozzászólások és felhasználónevek más emberek által írt utasításokat tartalmazhatnak. Az érintett válaszokhoz a CLI untrusted_content és untrusted_notice címkét ad, a stderr kimenetre pedig figyelmeztetést ír. A tartalmat tisztítja és rövidíti is, de az ügynöknek továbbra is adatként kell kezelnie, nem műveletre felhatalmazó utasításként.