Utvecklardokumentation

CLI-kommandon och konfiguration

Använd CLI för att granska API-scheman, skicka JSON-anrop, logga in via webbläsaren och konfigurera MCP-anslutningen.

Granskat av SosoAPI-teamet · 2026-10-21

Kommandon

Kontrollera --help för flaggorna som din installerade version stöder. Utan argument startar sosoapi MCP stdio-servern. Kör kommandona nedan separat; de är ingen shell-pipeline.

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

Autentisering och behörigheter

Anropa en API-rutt med JSON stdin

Använd api post för rutter på CLI:s offentliga tillåtelselista, inklusive läsningar som använder HTTP POST. Spara anropskroppen i request.json med en filredigerare så att kundtext inte tolkas av shell. Kontrollera http_status och svarskroppen; enbart avslutningskod noll fastställer inte API-framgång.

Detta exempel läser arbetsytekontext. Innan du skickar en skrivning, slå upp åtgärdens schema och bekräfta vilken destination du har behörighet att använda. Spara returnerat ID och kontrollera resultatet innan du gör om ett anrop som fått timeout.

{}

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

Fullständig API-referens

Miljövariabler

Ange dessa variabler i processen som kör din MCP-server. Valfri telemetri utesluter argument, promptar, resultat och filsökvägar; ange SOSOAPI_TELEMETRY=0 för att stänga av den. En egen API-adress kräver uttryckligt godkännande och CLI skickar inte VICKY_API_KEY till den adressen.

CLI-miljö
Variabel	Effekt
SOSOAPI_TOOL_PROFILE=core	Vardagsverktyg; standard är full. Ger inga behörigheter.
SOSOAPI_OUTPUT_SCHEMAS=1	Inkludera utdatascheman i tools/list; resultaten är strukturerade oavsett inställning.
SOSOAPI_UPLOAD_ROOTS	Ytterligare lokala mediemappar, åtskilda med : (; på Windows).
SOSOAPI_TELEMETRY=0	Inaktivera valfri användningsrapportering.
SOSOAPI_DEBUG=1	Skriv ut stackspår för CLI-fel; granska och maskera före delning.
VICKY_API_KEY	Personlig åtkomsttoken för skript/CI; välj helst OAuth för agenter.
VICKY_API_BASE_URL	Egen HTTPS-API-bas (localhost får använda HTTP); kräver också SOSOAPI_ALLOW_CUSTOM_BASE_URL=1.

Hantera obetrott innehåll

Kommentarer och användarnamn kan innehålla instruktioner skrivna av andra. För berörda svar lägger CLI till etiketterna untrusted_content och untrusted_notice och en varning på stderr. Det sanerar och kortar också innehållet, men din agent måste fortfarande behandla det som data och inte som behörighet att agera.