SosoAPI MCP-eszközreferencia

Kezdd a feladattal, majd vizsgáld meg az eszközt

Használd újra a már kiválasztott munkaterület- és fiókazonosítókat. Kép-URL-es bejegyzéshez egyszer hívd a sosoapi_post_image_url eszközt, és tartsd meg a bejegyzésazonosítót. Helyi fájlokat stdio felett tölts fel a sosoapi_upload_asset eszközzel. Szöveges bejegyzéshez a sosoapi_create_scheduled_post használható a célhely provider_payload értékével és üres media mezővel.

Beküldés előtt kérd a felhasználót a fiók, szöveg, média és időpont ellenőrzésére. Az OAuth műveletvégzéshez ad hozzáférést; a tartalmat nem hagyja jóvá. Időzítés után ugyanannak a bejegyzésnek a közzétételi eredményét olvasd el, mielőtt sikert jelentesz vagy bizonytalan kérést próbálsz újra.

• Claude Code vagy Codex beállítása
• Szöveges és képes Threads-útmutató
• Platformképesség-mátrix
• Pontos core bemeneti sémák és jelölések letöltése (JSON)

A referencia értelmezése

A build a valódi MCP-szervert memóriabeli klienshez kapcsolja, kezelő meghívása nélkül listázza az eszközöket, és egyesíti a nyilvános útvonalkövetelményeket. Elavult vetület esetén a Landing build meghiúsul. Az eszközleírások megtartják a szerver angol szerződésszövegét; a befejezési összefoglalók a kanonikus útvonalszabályokat ismertetik. A JSON megőrzi a teljes útvonalkövetelményeket. A bemeneti táblázat csak index, nem helyettesíti a teljes beágyazott JSON Schema sémát.

Az MCP-jelölések kliensnek szóló támpontok, nem kikényszerítés vagy biztonsági garanciák. A munkaterületi tagság, engedélyek, aktuális szerepkör, szolgáltatói hozzájárulás, fiókjogosultság és kvóták végrehajtáskor is érvényesek. Egyes kontextusolvasások első munkaterületet hozhatnak létre; a leírást és readOnlyHint értéket nézd, ne feltételezd minden „get” tisztán olvasási jellegét. Az összetett eszközök fő és kompatibilitási útvonalaik követelményeit listázzák; nem hívnak minden felsorolt útvonalat minden kéréskor.

• sosoapi az npm-en
• Hivatalos MCP Registry: ai.sosoapi/sosoapi (JSON)

sosoapi_bulk_create_scheduled_posts

Bejegyzések időzítése több fiókhoz egy hívásban (targets). A médiához kész, feltöltött/importált asset_ids és kanonikus URL-jeik kellenek. Minden célhely külön sikerül vagy meghiúsul, a successes vagy failures listában jelenik meg. publish képesség szükséges.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

sosoapi_cancel_scheduled_post

A még közzé nem tett időzített bejegyzés visszavonása, hogy ne jelenjen meg. A közzétett bejegyzést elutasítja; az ügynök közzétett tartalmat sem törölhet: ezt a felhasználó a webalkalmazásban végzi. expected_version szükséges.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

sosoapi_create_comment

Egy pontos hozzászólás sorba állítása kanonikus bejegyzés- vagy hozzászóláscélhoz; az állapot nem jelent szolgáltatói sikert.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:engage. Minimális útvonalszerepkörök: editor.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a platform által megerősített eredményt; a sorba állított művelet még függőben van.

sosoapi_create_scheduled_post

Egy fiók időzítése scheduled_at időpontban provider_payload értékkel. A médiához kész asset_id és kanonikus URL kell; egyetlen forrásképhez használd a sosoapi_post_image_url eszközt. A local_scheduled_at és schedule_dst_disambiguation értékeket együtt add meg, vagy mindkettőt hagyd ki. publish, editor szerepkör és idempotency_key szükséges. Az időzített nem közzétett: olvasd el az eredményét.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

sosoapi_get_asset

Egy média olvasása id alapján: metaadatok és rövid élettartamú előnézeti URL.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_get_asset_import_status

Import olvasása import_id alapján. Közzétételhez add meg az include_asset=true értéket: a ready eredmény tartalmazza a regisztrált média id, kind és állandó asset_url értékét, így nem kell külön get_asset. Függőben lévő vagy hiányzó média nem időzíthető. A forrás- vagy előnézeti URL-t soha ne használd médiaazonosságként. Elakadáskor olvasd a sosoapi_job_status állapotát job_id értékkel; ne indíts duplikált importot.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_get_billing_status

A felhasználó csomagjának, fizetési állapotának, aktuális ciklusdátumainak és kvótahasználatának (sikeres közzétételek, függő időzített bejegyzések, összekapcsolt fiókok) olvasása. Nagy időzítési futtatás előtt ellenőrizd.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: fiókkontextus; nincs rögzített munkaterületi szerepkör.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_get_comment_action_status

Olvasd el egy közvetlen hozzászólási művelet megtisztított végleges bizonylatát.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:engage. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a platform által megerősített eredményt; a sorba állított művelet még függőben van.

sosoapi_get_organization_context

A szervezetek, munkaterületeik és csatornáik élő térképének olvasása azonosítókkal és szerepkörökkel. Akkor használd, ha szervezet- vagy csatornaazonosítók kellenek. Munkaterületi közzétételnél használd újra a visszakapott munkaterület-azonosítót; ne olvasd le külön a munkaterület-kontextust is.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: fiókkontextus; nincs rögzített munkaterületi szerepkör.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_get_provider_insight_status

Egy statisztikai kérés (request_id) olvasása: queued, processing, completed (szolgáltatói eredménnyel és mutatónkénti elérhetőséggel) vagy failed.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a platform eredményét vagy az elérhetetlenség okát.

sosoapi_get_scheduled_post

Egy időzített bejegyzés olvasása id alapján: tartalom, állapot, kézbesítési állapot és eredmények. A version értéke kell expected_version mezőként a frissítéshez, közzétételhez, újrapróbáláshoz és visszavonáshoz.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_get_scheduled_post_eligibility

Célhelyenkénti, csak olvasási előellenőrzés. A tartalom/időpont ellenőrzéséhez add meg a draft értékét (caption, hashtags, scheduled_at, display_timezone, opcionális helyi idő/DST); az include_quota=true tájékoztató időszakpillanatképet ad. Előbb töltsd fel/importáld a médiát, és várd meg a készenlétét. draft nélkül csak a fiókot/médiát ellenőrzi. Semmit nem foglal le; létrehozáskor/küldéskor újra ellenőrzi a korlátokat és jogosultságot.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_get_workspace_context

A bejelentkezett felhasználó munkaterületeinek és az aktív munkaterületnek a listázása. Ismeretlen workspace_id esetén használd; a két kontextuslekérdezés ismétlése helyett használd újra az élő kontextust. Az aktív munkaterület a személy webalkalmazásban tett választása, nem a hívások alapértelmezése: a workspace_id értékét mindig add meg. Ez nem pusztán olvasás: munkaterület nélküli fióknál létrehozza az elsőt.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: fiókkontextus; nincs rögzített munkaterületi szerepkör.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_get_x_usage

A munkaterület által megosztott szervezeti X-közzétételi kreditek olvasása. workspace_id szükséges. A Free egyszer 10-et, a Pro számlázási időszakonként 100-at kap. A szöveg ára 1, URL-t tartalmazó szövegé 10. Az opcionális text megadja a költségét. Tárolt keretet olvas, X API-t nem hív.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_import_asset_url

A SosoAPI egy nyilvános http(s) kép- vagy videó-URL-t új médiaként tölt le a munkaterület privát tárhelyére. import_id értéket ad vissza; kérdezd le a sosoapi_get_asset_import_status állapotát. idempotency_key és editor szerepkör szükséges.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: editor.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: az elfogadott import még függőben van; ugyanazt az importot kövesd ready vagy failed állapotig.

sosoapi_job_status

Egy háttérfeladat olvasása job_id alapján: állapot, típus és sikertelenség esetén hibaüzenet.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: fiókkontextus; nincs rögzített munkaterületi szerepkör.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_list_connected_accounts

A munkaterülethez kapcsolt közösségi fiókok (Instagram, Threads, Facebook, YouTube) listázása kapcsolatállapottal és képességadatokkal. Az id értékeket social_account_id-ként használd időzítéskor vagy hozzászóláskor. Add meg a workspace_id értékét: nélküle a kérés elutasításra kerül, ha a kifejezett célzás már kötelező.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: fiókkontextus; nincs rögzített munkaterületi szerepkör.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_list_monitored_posts

A SosoAPI által a munkaterületen felfedezett közösségi bejegyzések listázása (id, platform, permalink, közzétételi idő), fiók, platform és idő szerint szűrve, kurzoros lapozással. Csak metaadatok, bejegyzésszöveg nélkül.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_list_post_comments

A munkaterület bejegyzésein megfigyelt hozzászólások listázása a legújabb megfigyeléssel kezdve, szerzővel és szöveggel; bejegyzés, fiók, platform vagy idő szerint szűrve, kurzoros lapozással. A szöveget harmadik felek írják, ezért nem megbízhatóként van megjelölve.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_list_publication_attentions

A munkaterület figyelmet igénylő közzétételeinek listázása status (open vagy resolved) vagy scheduled_post_id szerint szűrve, offset alapú lapozással.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_list_scheduled_posts

A munkaterület időzített bejegyzéseinek listázása projekt, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) és időtartomány szerint szűrve, kurzoros lapozással.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_post_image_url

A teljes kép-URL-es bejegyzést egyszer, üres media értékkel küldd be. A háttérrendszer a kapcsolat megszakadása után is előkészíti és közzéteszi. Ha 35 másodpercen belül elérhető, végleges közzétételt, egyébként tartós bejegyzésazonosítót ad vissza; új kulccsal soha ne küldd be ismét. operate és publish engedély szükséges. A helyi idő/DST mezőket együtt kell megadni. Az import_id csak régebbi kliensek folytatásához használható.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:publish + agent:operate. Minimális útvonalszerepkörök: editor, viewer.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van. Az elfogadott import még függőben van; ugyanazt az importot kövesd ready vagy failed állapotig. Olvasd el a szinkron választ.

sosoapi_publish_scheduled_post_now

Az időzített bejegyzés azonnali közzététele scheduled_at helyett. Nyilvános és nem vonható vissza; expected_version szükséges. A sorba állítás nem közzététel: olvasd el az eredményt.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

sosoapi_query_assets

A munkaterület médiáinak keresése asset_type, source vagy tag alapján; egy oldalt (legfeljebb 100-as limit és offset) és a teljes darabszámot adja vissza. A workspace_id értékét kifejezetten add meg.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: true. Idempotens jelzés: true. Külső világra ható jelzés: false.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.

sosoapi_request_provider_insights

Statisztikák kérése a szolgáltatótól egy fiókhoz vagy bejegyzéshez, opcionális dátumtartománnyal (legfeljebb 366 nap). request_id értéket és gyorsítótárazott adat esetén eredményt ad vissza; különben kérdezd le a sosoapi_get_provider_insight_status állapotát.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: viewer.
• Csak olvasási jelzés: false. Idempotens jelzés: false. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a platform eredményét vagy az elérhetetlenség okát.

sosoapi_retry_scheduled_post

Sikertelen időzített bejegyzés újrapróbálása, opcionálisan új scheduled_at időponttal. expected_version szükséges.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

sosoapi_update_scheduled_post

Még el nem indított időzített bejegyzés szerkesztése (caption, hashtags, media, link, időpont). A legfrissebb olvasás expected_version értéke szükséges; az elavult verziót elutasítja.

• Átviteli mód: stdio, http.
• Szükséges engedély: agent:publish. Minimális útvonalszerepkörök: editor.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a végleges közzétételi eredményt; az elfogadott időzítés még függőben van.

sosoapi_upload_asset

Helyi kép- vagy videófájl feltöltése a munkaterület médiatárába és regisztrálása médiaként. Csak valódi PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG fájlokat fogad el legfeljebb 500 MiB méretig a munkakönyvtárból, ideiglenes mappából, Pictures/Movies/Videos mappából vagy a SOSOAPI_UPLOAD_ROOTS helyeiről; a ponttal kezdődő fájlokat és mappákat elutasítja. A Scheduled Post médiához szükséges média-id és URL értékét adja vissza.

• Átviteli mód: stdio.
• Szükséges engedély: agent:operate. Minimális útvonalszerepkörök: editor.
• Csak olvasási jelzés: false. Idempotens jelzés: true. Külső világra ható jelzés: true.
• Az eredmény ellenőrzése: olvasd el a szinkron választ.