SosoAPI MCP-verktygsreferens

Börja med uppgiften och granska sedan verktyget

Återanvänd arbetsyte- och konto-ID:n som du redan har valt. För ett bild-URL-inlägg anropar du sosoapi_post_image_url en gång och behåller returnerat inläggs-ID. Ladda upp lokala filer med sosoapi_upload_asset via stdio. För ett textinlägg använder du sosoapi_create_scheduled_post med destinationens provider_payload och tomt media.

Be användaren granska konto, text, medier och tid före inskickning. OAuth ger åtkomst att utföra åtgärder; det godkänner inte innehållet. Läs samma inläggs publiceringsresultat efter schemaläggning innan du rapporterar framgång eller gör om ett anrop med osäkert resultat.

• Konfigurera Claude Code eller Codex
• Guide för text och bild på Threads
• Plattformsfunktionsmatris
• Ladda ned exakta core-indatascheman och annoteringar (JSON)

Så tolkar du referensen

Bygget ansluter den verkliga MCP-servern till en klient i minnet, listar dess verktyg utan att anropa någon hanterare och sammanfogar kraven för offentliga rutter. En inaktuell projektion får Landing-bygget att misslyckas. Verktygsbeskrivningarna behåller serverns engelska kontraktstext; slutförandesammanfattningarna förklarar de kanoniska ruttreglerna. JSON bevarar fullständiga ruttkrav. Indatatabellen är ett index, inte en ersättning för det fullständiga nästlade JSON Schema.

MCP-annoteringar är ledtrådar för klienter, inte tillämpning eller säkerhetsgarantier. Arbetsytemedlemskap, behörigheter, aktuell roll, leverantörssamtycke, kontobehörighet och kvoter gäller fortfarande vid körning. Vissa kontextläsningar kan skapa en första arbetsyta; granska beskrivningen och readOnlyHint i stället för att anta att varje ”get” är en ren läsning. Sammansatta verktyg listar krav för sina huvud- och kompatibilitetsrutter; de anropar inte varje listad rutt vid varje begäran.

• sosoapi på npm
• Officiella MCP Registry: ai.sosoapi/sosoapi (JSON)

sosoapi_bulk_create_scheduled_posts

Schemalägg inlägg för flera konton i ett anrop (targets). Medier behöver färdiga uppladdade/importerade asset_ids och deras kanoniska URL:er. Varje mål lyckas eller misslyckas separat och rapporteras i successes eller failures. Kräver funktionen publish.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

sosoapi_cancel_scheduled_post

Avbryt ett schemalagt inlägg som ännu inte publicerats så att det aldrig skickas. Ett publicerat inlägg avvisas och en agent kan inte heller ta bort publicerat innehåll: användaren gör det i webbappen. Kräver expected_version.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

sosoapi_create_comment

Köa en exakt kommentar mot ett kanoniskt mål i form av ett inlägg eller en kommentar; status är inte framgång hos leverantören.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:engage. Minsta roller för rutten: editor.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det plattformsbekräftade resultatet; en köad åtgärd väntar fortfarande.

sosoapi_create_scheduled_post

Schemalägg ett konto vid scheduled_at med provider_payload. Medier behöver ett färdigt asset_id och en kanonisk URL; använd sosoapi_post_image_url för en källbild. Para ihop local_scheduled_at med schedule_dst_disambiguation eller utelämna båda. Kräver publish, rollen editor och idempotency_key. Schemalagt är inte publicerat: läs resultatet.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

sosoapi_get_asset

Läs en mediefil via id: metadata och en kortlivad förhandsvisnings-URL.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_get_asset_import_status

Läs en import via import_id. För publicering anger du include_asset=true: ett ready-resultat innehåller registrerad mediefils id, kind och stabil asset_url, så att ett separat get_asset inte behövs. Väntande eller saknade mediefiler kan inte schemaläggas. Använd aldrig käll- eller förhandsvisnings-URL som medieidentitet. Om importen har stannat, läs sosoapi_job_status med job_id; starta aldrig en duplicerad import.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_get_billing_status

Läs användarens abonnemang, betalningsstatus, datum för aktuell period och kvotanvändning (lyckade publiceringar, väntande schemalagda inlägg, anslutna konton). Kontrollera före större schemaläggningskörningar.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: kontokontext; ingen fast arbetsyteroll.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_get_comment_action_status

Läs det sanerade slutkvittot för en direkt kommentarsåtgärd.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:engage. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det plattformsbekräftade resultatet; en köad åtgärd väntar fortfarande.

sosoapi_get_organization_context

Läs den aktuella kartan över dina organisationer, deras arbetsytor och kanaler med ID:n och roller. Använd den när organisations- eller kanal-ID:n behövs. För publicering i en arbetsyta återanvänder du ett returnerat arbetsyte-ID; läs inte även arbetsytekontexten.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: kontokontext; ingen fast arbetsyteroll.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_get_provider_insight_status

Läs en insiktsbegäran (request_id): queued, processing, completed (med leverantörens resultat och tillgänglighet per mätvärde) eller failed.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs plattformens resultat eller orsaken till att det inte är tillgängligt.

sosoapi_get_scheduled_post

Läs ett schemalagt inlägg via id: innehåll, status, leveransstatus och resultat. Dess version behövs som expected_version för update, publish, retry och cancel.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_get_scheduled_post_eligibility

Skrivskyddad förhandskontroll per destination. Inkludera draft (caption, hashtags, scheduled_at, display_timezone, valfri lokal tid/DST) för innehålls- och tidskontroller; include_quota=true lägger till en rådgivande periodbild. Ladda först upp/importera medier och invänta beredskap. Utan draft kontrolleras endast konto/medier. Reserverar ingenting; create/dispatch kontrollerar gränser och behörighet igen.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_get_workspace_context

Lista arbetsytorna som den inloggade användaren tillhör och vilken som är aktiv. Använd detta när workspace_id är okänt; återanvänd aktuell kontext i stället för att upprepa båda kontextläsningarna. Den aktiva arbetsyta som rapporteras är personens val i webbappen, inte ett standardval för dina anrop: ange workspace_id uttryckligen. Detta är inte enbart en läsning: för ett konto utan arbetsyta skapas den första.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: kontokontext; ingen fast arbetsyteroll.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_get_x_usage

Läs organisationens X-publiceringskrediter som delas av denna arbetsyta. Kräver workspace_id. Free får 10 en gång; Pro får 100 per faktureringsperiod. Text kostar 1, text som innehåller en URL kostar 10. Valfri text visar dess kostnad. Detta läser lagrat utrymme och anropar inget X API.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_import_asset_url

Be SosoAPI hämta en bild eller video från en offentlig http(s)-URL till privat lagring i arbetsytan som en ny mediefil. Returnerar ett import_id; polla sosoapi_get_asset_import_status. Kräver idempotency_key och rollen editor.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: editor.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: En accepterad import väntar fortfarande; följ samma import till ready eller failed.

sosoapi_job_status

Läs ett bakgrundsjobb via job_id: status, typ och felmeddelande vid misslyckande.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: kontokontext; ingen fast arbetsyteroll.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_list_connected_accounts

Lista de sociala konton (Instagram, Threads, Facebook, YouTube) som är anslutna till en arbetsyta, med anslutningshälsa och funktionsuppgifter. Använd deras id som social_account_id vid schemaläggning eller kommentarer. Ange workspace_id: en begäran utan detta avvisas när uttryckligt målval tillämpas.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: kontokontext; ingen fast arbetsyteroll.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_list_monitored_posts

Lista sociala inlägg som SosoAPI har hittat för en arbetsyta (id, plattform, permalänk, publiceringstid), med filtrering på konto, plattform och tid samt markörbaserad sidindelning. Endast metadata, inga bildtexter.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_list_post_comments

Lista kommentarer som observerats på arbetsytans inlägg, senaste observation först, med författare och text; filtrera på inlägg, konto, plattform eller tid, med markörbaserad sidindelning. Texten är skriven av tredje part och märks som obetrodd.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_list_publication_attentions

Lista publiceringar i en arbetsyta som kräver åtgärd, filtrerade på status (open eller resolved) eller scheduled_post_id, med offsetbaserad sidindelning.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_list_scheduled_posts

Lista en arbetsytas schemalagda inlägg med filtrering på projekt, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) och tidsintervall samt markörbaserad sidindelning.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_post_image_url

Skicka in det kompletta inlägget med bild-URL en gång, med tomt media. Servern förbereder och publicerar det även efter frånkoppling. Returnerar slutlig publicering om den är tillgänglig inom 35 sekunder, annars ett beständigt inläggs-ID; skicka aldrig in igen med en ny nyckel. Kräver behörigheterna operate och publish. Fält för lokal tid/DST hör ihop. import_id används endast för att återuppta för äldre klienter.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:publish + agent:operate. Minsta roller för rutten: editor, viewer.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande. En accepterad import väntar fortfarande; följ samma import till ready eller failed. Läs det synkrona svaret.

sosoapi_publish_scheduled_post_now

Publicera ett schemalagt inlägg omedelbart i stället för vid scheduled_at. Offentligt och oåterkalleligt; kräver expected_version. Köat är inte publicerat: läs resultatet.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

sosoapi_query_assets

Hitta en arbetsytas mediefiler efter asset_type, source eller tag; returnerar en sida (limit upp till 100, samt offset) och totalantalet. Ange workspace_id uttryckligen.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: true. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: false.
• Så kontrollerar du resultatet: Läs det synkrona svaret.

sosoapi_request_provider_insights

Be leverantören om insikter för ett konto eller ett inlägg över ett valfritt datumintervall (upp till 366 dagar). Returnerar request_id och, vid cacheträff, resultatet; annars pollar du sosoapi_get_provider_insight_status.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: viewer.
• Ledtråd för skrivskydd: false. Idempotensledtråd: false. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs plattformens resultat eller orsaken till att det inte är tillgängligt.

sosoapi_retry_scheduled_post

Försök igen med ett misslyckat schemalagt inlägg, eventuellt med en ny scheduled_at. Kräver expected_version.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

sosoapi_update_scheduled_post

Redigera ett schemalagt inlägg som inte har skickats för leverans (caption, hashtags, media, link, time). Kräver expected_version från den senaste läsningen; en inaktuell version avvisas.

• Transport: stdio, http.
• Obligatorisk behörighet: agent:publish. Minsta roller för rutten: editor.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det slutliga publiceringsresultatet; en accepterad schemaläggning väntar fortfarande.

sosoapi_upload_asset

Ladda upp en lokal bild- eller videofil till en arbetsytas mediebibliotek och registrera den som mediefil. Endast verkliga filer i formaten PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG upp till 500 MiB från arbetskatalogen, tempmappen, Pictures/Movies/Videos eller SOSOAPI_UPLOAD_ROOTS godtas; punktfiler och punktmappar avvisas. Returnerar mediefilens id och URL för Scheduled Post-medier.

• Transport: stdio.
• Obligatorisk behörighet: agent:operate. Minsta roller för rutten: editor.
• Ledtråd för skrivskydd: false. Idempotensledtråd: true. Ledtråd för omvärldspåverkan: true.
• Så kontrollerar du resultatet: Läs det synkrona svaret.