SosoAPI MCP-verktøyreferanse

Begynn med oppgaven, og undersøk deretter verktøyet

Gjenbruk arbeidsområde- og konto-ID-ene du allerede har valgt. For et bilde-URL-innlegg, kall sosoapi_post_image_url én gang og behold returnert innleggs-ID. Last opp lokale filer med sosoapi_upload_asset over stdio. For tekstinnlegg, bruk sosoapi_create_scheduled_post med målets provider_payload og tom media.

Be brukeren gjennomgå konto, tekst, medier og tidspunkt før innsending. OAuth gir tilgang til handlinger; det godkjenner ikke innholdet. Les samme innleggs publiseringsresultat etter planlegging før du rapporterer suksess eller prøver en forespørsel med usikkert resultat på nytt.

• Sett opp Claude Code eller Codex
• Threads-oppskrift for tekst og bilde
• Plattformens funksjonsmatrise
• Last ned nøyaktige core-inndataskjemaer og merknader (JSON)

Slik tolker du denne referansen

Bygget kobler den faktiske MCP-serveren til en minnebasert klient, viser verktøyene uten å kalle noen håndterer, og sammenstiller krav til offentlige ruter. En utdatert projeksjon gjør at Landing-bygget mislykkes. Verktøybeskrivelser beholder serverens engelske kontrakttekst; fullføringssammendrag forklarer regler for kanoniske ruter. JSON beholder de fullstendige rutekravene. Inndatatabellen er en indeks, ikke en erstatning for hele det nøstede JSON Schema.

MCP-merknader er hint for klienter, ikke håndheving eller sikkerhetsgarantier. Arbeidsområdemedlemskap, tillatelser, gjeldende rolle, leverandørsamtykke, kontokvalifikasjon og kvoter gjelder fortsatt ved kjøring. Noen kontekstlesinger kan opprette et første arbeidsområde; undersøk beskrivelse og readOnlyHint fremfor å anta at hver «get» er ren lesing. Sammensatte verktøy viser krav til hoved- og kompatibilitetsruter; de kaller ikke alle oppførte ruter ved hver forespørsel.

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

sosoapi_bulk_create_scheduled_posts

Planlegg innlegg for flere kontoer i ett kall (targets). Medier krever klare opplastede/importerte asset_ids og deres kanoniske URL-er. Hvert mål lykkes eller mislykkes uavhengig og rapporteres i successes eller failures. Krever funksjonen publish.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

sosoapi_cancel_scheduled_post

Avbryt et planlagt innlegg som ennå ikke er publisert, slik at det aldri sendes ut. Et publisert innlegg avvises, og en agent kan heller ikke slette publisert innhold: brukeren gjør det i nettappen. Krever expected_version.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

sosoapi_create_comment

Sett én nøyaktig kommentar i kø mot et kanonisk innlegg eller en kommentar; statusen bekrefter ikke suksess hos leverandøren.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:engage. Minsteroller for ruten: editor.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det plattformbekreftede resultatet; en handling i kø venter fortsatt.

sosoapi_create_scheduled_post

Planlegg én konto ved scheduled_at med provider_payload. Medier krever en klar asset_id og kanonisk URL; bruk sosoapi_post_image_url for ett kildebilde. Angi local_scheduled_at sammen med schedule_dst_disambiguation, eller utelat begge. Krever publish, editor-rollen og idempotency_key. Planlagt er ikke publisert: les resultatet.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

sosoapi_get_asset

Les én ressurs etter id: metadata og en kortvarig forhåndsvisnings-URL.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_get_asset_import_status

Les en import etter import_id. Ved publisering, oppgi include_asset=true: et klart resultat inneholder registrert ressurs-ID, kind og stabil asset_url, så et separat get_asset ikke trengs. Ventende eller manglende ressurser kan ikke planlegges. Bruk aldri kilde- eller forhåndsvisnings-URL som medieidentitet. Hvis importen står fast, les sosoapi_job_status med job_id; start aldri en duplisert import.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_get_billing_status

Les brukerens abonnement, betalingsstatus, datoer for gjeldende periode og kvotebruk (vellykkede publiseringer, ventende planlagte innlegg, tilkoblede kontoer). Kontroller dette før store planleggingskjøringer.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: kontokontekst; ingen fast arbeidsområderolle.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_get_comment_action_status

Les den rensede sluttkvitteringen for en direkte kommentarhandling.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:engage. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det plattformbekreftede resultatet; en handling i kø venter fortsatt.

sosoapi_get_organization_context

Les den oppdaterte oversikten over organisasjonene dine, arbeidsområdene og kanalene deres med ID-er og roller. Bruk dette når organisasjons- eller kanal-ID-er trengs. For innlegg i et arbeidsområde, gjenbruk en returnert arbeidsområde-ID; ikke les arbeidsområdekontekst i tillegg.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: kontokontekst; ingen fast arbeidsområderolle.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_get_provider_insight_status

Les en innsiktsforespørsel (request_id): queued, processing, completed (med leverandørresultat og tilgjengelighet per måling) eller failed.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les plattformens resultat eller grunnen til at det ikke er tilgjengelig.

sosoapi_get_scheduled_post

Les ett planlagt innlegg etter id: innhold, status, leveringstilstand og resultater. Versjonen brukes som expected_version ved oppdatering, publisering, nytt forsøk og avbryting.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_get_scheduled_post_eligibility

Skrivebeskyttet forhåndskontroll per mål. Ta med draft (caption, hashtags, scheduled_at, display_timezone, valgfri lokal tid/sommertid) for innholds- og tidskontroller; include_quota=true legger til et veiledende øyeblikksbilde av perioden. Last opp eller importer medier og vent til de er klare først. Uten draft kontrolleres bare konto og medier. Reserverer ingenting; oppretting og utsending kontrollerer grenser og autoritet på nytt.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_get_workspace_context

Vis arbeidsområdene den innloggede brukeren tilhører, og hvilket som er aktivt. Bruk dette når workspace_id er ukjent; gjenbruk gjeldende kontekst i stedet for å gjenta begge kontekstlesingene. Det aktive arbeidsområdet som oppgis, er valget en person har gjort i nettappen, ikke en standard for kallene dine: oppgi workspace_id eksplisitt. Dette er ikke bare en leseoperasjon: for en konto uten arbeidsområde opprettes det første.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: kontokontekst; ingen fast arbeidsområderolle.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_get_x_usage

Les organisasjonens X-publiseringskreditter som deles av dette arbeidsområdet. Krever workspace_id. Free får 10 én gang; Pro får 100 per faktureringsperiode. Tekst koster 1, tekst med en URL koster 10. Valgfri text beregner kostnaden. Dette leser den lagrede kvoten og kaller ikke X API.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_import_asset_url

Be SosoAPI laste ned en offentlig http(s)-URL for et bilde eller en video til privat lagring i arbeidsområdet som en ny ressurs. Returnerer en import_id; spør sosoapi_get_asset_import_status om status. Krever en idempotency_key og editor-rollen.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: editor.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: En akseptert import venter; følg samme import til ready eller failed.

sosoapi_job_status

Les én bakgrunnsjobb etter job_id: status, type og feilmeldingen hvis den mislyktes.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: kontokontekst; ingen fast arbeidsområderolle.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_list_connected_accounts

Vis kontoene i sosiale medier (Instagram, Threads, Facebook, YouTube) som er koblet til et arbeidsområde, med tilkoblingstilstand og funksjonsfakta. Bruk ID-ene deres som social_account_id ved planlegging eller kommentering. Oppgi workspace_id: en forespørsel uten avvises når eksplisitt målvalg håndheves.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: kontokontekst; ingen fast arbeidsområderolle.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_list_monitored_posts

Vis innlegg i sosiale medier som SosoAPI har funnet for et arbeidsområde (id, plattform, permalenke, publiseringstidspunkt), filtrert etter konto, plattform og tid, med markørbasert paginering. Bare metadata, ingen bildetekster.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_list_post_comments

Vis kommentarer observert på arbeidsområdets innlegg, nyeste observasjon først, med forfatter og tekst; filtrer etter innlegg, konto, plattform eller tid, med markørbasert paginering. Teksten er skrevet av tredjeparter og er merket som ikke-betrodd.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_list_publication_attentions

Vis publiseringer i et arbeidsområde som krever oppfølging, filtrert etter status (open eller resolved) eller scheduled_post_id, paginert med offset.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_list_scheduled_posts

Vis planlagte innlegg i et arbeidsområde, filtrert etter prosjekt, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) og tidsrom, med markørbasert paginering.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_post_image_url

Send inn det komplette bilde-URL-innlegget én gang, med tom media. Backend klargjør og publiserer det selv etter frakobling. Returnerer endelig publisering hvis tilgjengelig innen 35 sekunder, ellers en varig innleggs-ID; send aldri inn på nytt med en ny nøkkel. Krever operate- og publish-tillatelser. Felter for lokal tid/sommertid hører sammen. import_id brukes bare til å gjenoppta eldre klienter.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:publish + agent:operate. Minsteroller for ruten: editor, viewer.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt. En akseptert import venter; følg samme import til ready eller failed. Les det synkrone svaret.

sosoapi_publish_scheduled_post_now

Publiser et planlagt innlegg umiddelbart i stedet for ved scheduled_at. Offentlig og kan ikke angres; krever expected_version. I kø er ikke publisert: les resultatet.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

sosoapi_query_assets

Finn ressurser i et arbeidsområde etter asset_type, source eller tag; returnerer en side (limit opptil 100, pluss offset) og totalen. Oppgi workspace_id eksplisitt.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: true. Idempotens-hint: true. Ekstern verden-hint: false.
• Slik kontrollerer du resultatet: Les det synkrone svaret.

sosoapi_request_provider_insights

Be leverandøren om innsikt for en konto eller ett innlegg over et valgfritt datointervall (opptil 366 dager). Returnerer en request_id og resultatet når det er hurtigbufret; ellers spør sosoapi_get_provider_insight_status om status.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: viewer.
• Skrivebeskyttet-hint: false. Idempotens-hint: false. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les plattformens resultat eller grunnen til at det ikke er tilgjengelig.

sosoapi_retry_scheduled_post

Prøv et mislykket planlagt innlegg på nytt, eventuelt med en ny scheduled_at. Krever expected_version.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

sosoapi_update_scheduled_post

Rediger et planlagt innlegg som ikke er sendt til levering (caption, hashtags, media, link, time). Krever expected_version fra siste lesing; en utdatert versjon avvises.

• Transport: stdio, http.
• Påkrevd tillatelse: agent:publish. Minsteroller for ruten: editor.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det endelige publiseringsresultatet; en akseptert publiseringsplan venter fortsatt.

sosoapi_upload_asset

Last opp en lokal bilde- eller videofil til ressursbiblioteket i et arbeidsområde og registrer den som en ressurs. Bare faktiske filer i formatene PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG på opptil 500 MiB fra arbeidsmappen, temp-mappen, Pictures/Movies/Videos eller SOSOAPI_UPLOAD_ROOTS godtas; punktfiler og punktmapper avvises. Returnerer ressursens id og URL for medier i planlagte innlegg.

• Transport: stdio.
• Påkrevd tillatelse: agent:operate. Minsteroller for ruten: editor.
• Skrivebeskyttet-hint: false. Idempotens-hint: true. Ekstern verden-hint: true.
• Slik kontrollerer du resultatet: Les det synkrone svaret.