SosoAPI-Einrichtungsanleitung

Wähle deinen Ausgangspunkt

SosoAPI bietet dem bereits genutzten Agenten eine Verbindung zu deinen Social-Media-Konten. Dein Agent hilft beim Schreiben und Prüfen von Inhalten; SosoAPI übernimmt unterstützte Kontooperationen, Planung und Veröffentlichungsergebnisse. Du kannst dieselben Beiträge in der App prüfen oder die API aus deinem eigenen Code nutzen.

Diese Anleitung beginnt mit einer Person und einem Social-Media-Konto. Du verbindest einen lokalen oder gehosteten MCP-Client, wählst Zugriff, prüfst ein Social-Media-Konto, bereitest einen Beitrag vor und gibst ihn frei und liest das tatsächliche Ergebnis. Die fortgeschrittene Anleitung behandelt CLI und HTTP-API. Die Einrichtung selbst erfordert keinen Testbeitrag.

• Claude Code oder Codex die Einrichtung überlassen: Schritt 1
• MCP-Client selbst konfigurieren: Schritt 3
• Terminal oder Backend nutzen: Schritt 9
• Eine Verbindung reparieren: Schritt 10

Bevor du startest

Du brauchst einen MCP-kompatiblen KI-Client, ein SosoAPI-Konto und ein Social-Media-Konto, das du verwalten darfst. Du kannst das SosoAPI-Konto erstellen, wenn die Anmeldung geöffnet wird. Halte einen echten Inhalt bereit.

Lokales MCP benötigt Node.js 20 oder höher mit npm/npx und deinen gewählten KI-Client. Hosted MCP benötigt einen Client mit Remote-MCP, OAuth und automatischer Clientregistrierung; eine lokale Node.js-Installation ist nicht nötig. Clientfunktionen können vom Tarif und den Administratoreinstellungen abhängen.

SosoAPI verbindet Instagram, Threads, Facebook Pages, YouTube und X. Wähle ein Konto, dessen Typ, Berechtigungen und Beitragsformat zu deiner Aufgabe passen. Ein berechtigtes Threads-Konto ist ein nützliches erstes Beispiel für reine Textbeiträge. Instagram und YouTube benötigen geeignete Medien für ihre unterstützten Veröffentlichungsformate. Eine Plattform im Verbindungsmenü bedeutet nicht, dass jede Aktion für jedes Konto verfügbar ist.

Prüfe bei der Einrichtung die kontospezifischen Funktionen. Lies deinen aktuellen Tarif und das Kontingent in der App, bevor du einen Stapel planst; X hat ein separates Credit-Kontingent der Organization. Ein Beispiel für eine Plattform belegt keine Unterstützung auf einer anderen.

• Unterstützte Plattformen
• Veröffentlichungsfunktionen und Kontoanforderungen

1. Deinem Agenten die Einrichtungsanfrage geben

Füge dies in deine bestehende Unterhaltung mit Claude Code oder Codex ein.

Der Agent sollte zuerst nach einer funktionierenden SosoAPI-Verbindung suchen und sie wiederverwenden. Andernfalls folgt er der Einrichtungsanleitung und sagt dir, wenn Browseranmeldung oder Client-Neustart nötig ist. Erwartetes Ergebnis: SosoAPI-Werkzeuge sind in dieser Unterhaltung nutzbar. Eine Installationsmeldung allein belegt das nicht. Fahre mit Anmeldung und Kontoprüfung fort oder nutze Schritt 3 zur manuellen Einrichtung.

Richte SosoAPI anhand von https://sosoapi.ai/setup.md ein. Behalte meine aktuellen Inhalte und meine Aufgabe bei. Ich melde mich an und genehmige den Zugriff, wenn ich gefragt werde. Veröffentliche während der Einrichtung nichts.

2. Anmelden und den Zugriff deines Agenten wählen

Nutze dein vorgesehenes Konto: Fahre mit Google fort oder registriere dich per E-Mail und schließe die Verifizierung ab. Schließe angezeigte Konto- oder Workspace-Einrichtungen ab. Wenn du mehreren Workspaces angehörst, wähle die vorgesehene Marke oder das Projekt. Prüfe die angeforderten Workspaces und Aktionen vor der Freigabe und kehre dann zur selben Unterhaltung zurück.

Behalte den vom Agenten bereitgestellten Anmeldelink, damit der Browser zur ausstehenden Autorisierung zurückkehren kann. Du kannst zuerst in der App beginnen und dann zum Agenten zurückkehren. Ersetze keinen ausstehenden Freigabelink durch einen anderen Anmeldelink.

Workspace-Rollen und Plattformberechtigungen gelten weiterhin: Ein viewer wird nicht zum editor, nur weil ein Agent Veröffentlichungszugriff hat. Veröffentlichungszugriff gilt innerhalb des erteilten Umfangs dauerhaft; SosoAPI benötigt keine neue Browserfreigabe für jeden Beitrag. Sage deinem Agenten, wann er für die Inhaltsprüfung pausieren soll. Normale OAuth-Einrichtung erfordert nicht, ein Social-Media-Passwort oder einen API-Schlüssel in den Agenten einzufügen.

Erwartetes Ergebnis: Die Anmeldung wird mit deiner vorgesehenen Identität abgeschlossen und der Agent kann die von dir autorisierten Workspaces abrufen. Nutze die Fehlerbehebung, wenn das falsche Browserprofil geöffnet wird.

• In der SosoAPI-App beginnen

3. Deinen Agenten bei Bedarf manuell verbinden

Wähle eine Verbindungsmethode. Überspringe diesen Abschnitt, wenn dein Agent bereits eine funktionierende Verbindung eingerichtet hat. Prüfe für lokales MCP zuerst Node.js und npx. Node.js muss Version 20 oder höher haben.

node --version
npx --version

Lokales MCP: Claude Code oder Codex

Führe nur den Befehl für deinen Client aus: Der erste ist für Claude Code, der zweite für Codex. Das core-Profil deckt alltägliche Veröffentlichungen ab. Profile ändern die angezeigten Werkzeuge, erteilen aber keine Berechtigungen. Behalte eine funktionierende full-Profil-Verbindung, wenn du bereits eine hast.

Verbinde neu oder starte neu, wenn der Client darum bittet, und prüfe dann, ob SosoAPI-Werkzeuge in der aktuellen Unterhaltung verfügbar sind. Der erste authentifizierte Aufruf startet bei Bedarf die Browseranmeldung.

claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

Andere lokale MCP-Clients

Füge bei Clients mit mcpServers-JSON diesen Eintrag der bestehenden Konfiguration hinzu und behalte andere Server. Andere Konfigurationsformate sollten denselben Befehl, dieselben Argumente und dieselbe Umgebungsvariable über die eigenen MCP-Einstellungen des Clients erhalten.

{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}

• Installationsreferenz und Paketauswahl

Hosted MCP: kompatible Browser- oder Remote-Clients

Füge in den Einstellungen für eigene Connectors oder Remote-MCP deines Clients eine Verbindung namens SosoAPI mit der unten stehenden Server-URL hinzu. Wähle OAuth mit automatischer Clientregistrierung, wenn angeboten. Melde dich bei SosoAPI an, wähle erlaubte Workspaces und Aktionen, kehre zur Unterhaltung zurück und aktiviere die Verbindung bei Bedarf. Bitte den Agenten, autorisierte Konten zu prüfen.

Nutze https://sosoapi.ai für eine neue gehostete Verbindung. Der bisherige Endpunkt https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp bleibt unterstützt. Behalte eine funktionierende lokale oder gehostete Verbindung; du musst sie nicht ersetzen, nur um ihre URL zu ändern.

Es müssen kein API-Schlüssel, keine Client-ID und kein Client-Secret eingefügt werden. Eigene ChatGPT-MCP-Apps hängen vom Tarif, Entwicklermodus und den Administratoreinstellungen des Clients ab. Diese Anleitung beschreibt eine eigene Verbindung, keinen Eintrag im App-Verzeichnis. Hosted MCP kann keine lokalen Dateien lesen; nutze einen öffentlichen URL-Import oder lokales MCP für lokale Datei-Uploads.

https://sosoapi.ai

• Eigene OAuth-Clientregistrierung und Token-Anleitung

Optionale Anmeldeprüfung im Terminal

Führe bei einer lokalen Verbindung zuerst auth status aus. Führe auth login nur aus, wenn du laut Status nicht angemeldet bist. Schließe den Browserablauf ab und prüfe den Status erneut. Token werden nicht ausgegeben. Dies prüft die lokale CLI-Authentifizierung, nicht die Anmeldung eines separaten gehosteten Connectors.

npx -y sosoapi auth status

npx -y sosoapi auth login

4. Dein Social-Media-Konto verbinden

Öffne „Konten verbinden“ oder nutze den lokalen Befehl unten. Ersetze threads bei Bedarf durch instagram, facebook, youtube oder x. Das öffnet den Verbindungsablauf; es veröffentlicht keine Inhalte.

Prüfe die angezeigte Organization und den Workspace. Wähle die Plattform, melde dich über ihre Autorisierungsseite an und wähle das genaue Konto, die Page oder den Kanal. Schließe bei der Rückkehr die Zustimmung und gegebenenfalls die Kontobestätigung ab. Bitte den Agenten danach, die verbundenen Konten für den vorgesehenen Workspace zu aktualisieren.

Verwende eine bestehende funktionierende Verbindung wieder. Gehört sie zu einer anderen Organization oder einem anderen Workspace, kläre diese Wahl in der App; die normale Einrichtung sollte sie weder trennen noch verschieben. Erwartetes Ergebnis: Das richtige Konto erscheint im vorgesehenen Workspace mit aktuellen Zustands- und Funktionsangaben. Ein erfolgreicher Callback allein belegt keine Veröffentlichungsberechtigung.

npx -y sosoapi connect threads

• Konten verbinden

5. Zugriff prüfen, ohne zu veröffentlichen

Füge Folgendes in die Unterhaltung mit dem verbundenen Agenten ein.

Der Agent kann sosoapi_get_workspace_context und sosoapi_list_connected_accounts nutzen, bekannten Kontext wiederverwenden und die gewählte workspace_id ausdrücklich übergeben. Die Kontoinitialisierung kann deinen ersten Workspace erstellen; diese Einrichtungsprüfung erstellt keinen Social-Media-Beitrag.

Bestätige vor dem Fortfahren Workspace und Ziel, deine Rolle und den Agentenzugriff sowie die Unterstützung des vorgeschlagenen Formats am Ziel. Nutze die Fehlerbehebung bei fehlgeschlagener Prüfung. Eine Paketneuinstallation behebt keine fehlende Plattformberechtigung.

Prüfe meine SosoAPI-Einrichtung, ohne etwas zu veröffentlichen oder zu planen.
Zeige die Workspaces, die ich nutzen kann, und die Social-Media-Konten im von mir gewählten Workspace.
Zeige für das von mir gewählte Konto Plattform, Kontobezeichnung, Verbindungszustand und Veröffentlichungsfunktionen für mein vorgeschlagenes Format.
Wenn mehrere Workspaces oder Konten passen könnten, frage mich, welches du verwenden sollst.
Behalte interne IDs für Werkzeugaufrufe; bitte mich nicht, sie zu suchen oder zu erfinden.

6. Deinen ersten Beitrag vorbereiten und freigeben

Beginne mit einem echten Beitrag und einem Ziel. Ersetze die Felder in eckigen Klammern in dieser Entwurfsanfrage. Der Agent schreibt; SosoAPI stellt die Verbindung und Veröffentlichungsoperationen bereit. Prüfe Aussagen, Rechtschreibung, Links und Medien selbst.

Nutze für einen zukünftigen Beitrag ein ausdrückliches Datum, eine lokale Uhrzeit und eine IANA-Zeitzone. Ist eine lokale Uhrzeit wegen der Sommerzeit mehrdeutig, wähle vor der Einreichung das gewünschte Vorkommen. Erwartetes Ergebnis dieser Phase: ein genauer Entwurf zur Prüfung, ohne eingereichte Veröffentlichungsanfrage.

Hilf mir, mit SosoAPI eine Produktankündigung vorzubereiten.

Produkt: [öffentlicher Produktname]
Bestätigte Fakten: [was heute verfügbar ist]
Zielgruppe: [wem dies hilft]
Ziel: [Kontobezeichnung und Plattform]
Sprache: [Sprache]
Gewünschtes lokales Datum und Uhrzeit: [YYYY-MM-DD HH:mm]
Zeitzone: [IANA-Zeitzone, zum Beispiel Asia/Hong_Kong]
Medien: [keine, eine lokale Datei oder eine öffentliche Medien-URL]

Nutze nur die von mir bereitgestellten Fakten. Prüfe die Formatanforderungen des Ziels.
Zeige den genauen Entwurf, die Medien, das Ziel, Datum, Uhrzeit und Zeitzone zur Prüfung.
Noch nicht planen oder veröffentlichen.

Den genauen Beitrag vor dem Planen freigeben

Wenn alle Angaben stimmen, gib mit der folgenden Vorlage eine konkrete Anweisung. Das erstellt eine echte Planung, die öffentlich veröffentlichen kann. Nutze Inhalte und ein Konto, auf dem du veröffentlichen möchtest. Auch sofortiges Veröffentlichen benötigt nach der Prüfung derselben Angaben eine ausdrückliche Anweisung.

Erwartetes Ergebnis: eine Scheduled Post-ID, das vorgesehene Ziel, der angenommene Zeitpunkt und der aktuelle Status. Eine angenommene Planung bedeutet nicht, dass der Anbieter sie veröffentlicht hat.

Plane den unten genau freigegebenen Beitrag für das benannte Konto zum angegebenen Datum, zur Uhrzeit und Zeitzone.

[Füge endgültigen Inhalt, Medien, Ziel, Datum, Uhrzeit und Zeitzone ein.]

Prüfe zuerst, ob bereits eine passende Planung vorhanden ist. Reiche diesen Beitrag einmal ein und lies das gespeicherte Ergebnis zurück. Gib ID, Ziel, angenommenen Zeitpunkt und aktuellen Status zurück. Ist das Ergebnis ungewiss, prüfe die bestehende Anfrage vor einer weiteren Aktion.

7. Ergebnis prüfen, neu planen oder abbrechen

Bitte den Agenten, denselben Scheduled Post mit sosoapi_get_scheduled_post zu lesen. Du kannst auch https://app.sosoapi.ai/scheduled-posts/<post-id> öffnen, nachdem du dich mit einem berechtigten Konto angemeldet hast. Prüfe bei Anfragen für mehrere Konten jedes Ziel einzeln; manche können erfolgreich sein, während andere Aufmerksamkeit brauchen.

Lies das aktuelle Ergebnis von Scheduled Post [zurückgegebene ID].
Zeige Ziel, geplanten Zeitpunkt, aktuellen Status und Veröffentlichungsergebnis.
Wenn die Veröffentlichung bestätigt ist, füge den öffentlichen Link hinzu, sofern verfügbar.
Nicht erneut versuchen, neu planen oder einen weiteren Beitrag erstellen.

Einen ausstehenden Beitrag verwalten und später zurückkehren

Gib zum Ändern eines ausstehenden Beitrags seine ID und die neuen Angaben an. Der Agent muss vor einer unterstützten Änderung oder Stornierung die aktuelle Version und die verfügbaren Aktionen lesen. Ob ein Abbruch möglich ist, hängt vom Zustellungsstand ab; nach Beginn der Zustellung ist er möglicherweise nicht mehr verfügbar. Das Abbrechen einer Planung entfernt keinen bereits veröffentlichten Anbieterbeitrag.

Nachdem du die gespeicherten Angaben für eine zukünftige Planung erhalten hast, kannst du die Unterhaltung verlassen und später zum selben Beitrag zurückkehren. Eine geschlossene Agentenunterhaltung verspricht nicht, sich selbst zu aktivieren oder dich zu benachrichtigen, sofern dies nicht separat konfiguriert wurde.

8. Bilder oder Videos hinzufügen und den Ablauf wiederverwenden

Bringe den Ablauf für einen einzelnen Beitrag zum Laufen, bevor du einen größeren Stapel vorbereitest. Sage dem Agenten, ob die Medien eine lokale Datei, eine öffentliche URL oder ein vorhandenes SosoAPI-Asset sind.

Lokale Dateien: Lokales MCP kann sosoapi_upload_asset nutzen. Die Datei muss in einem erlaubten Upload-Ordner liegen; bei einem Pfad außerhalb dieser Grenzen nennt das Werkzeug die erlaubten Orte. Hosted MCP kann keine Dateien auf deinem Computer lesen.

Öffentliche URLs: Nutze sosoapi_import_asset_url und danach sosoapi_get_asset_import_status mit include_asset=true. Warte, bis das Asset bereit ist. Prüfe bei einem vorhandenen Asset, ob es zum vorgesehenen Workspace gehört und für das gewählte Format bereit ist.

Die normale Planungsanfrage verwendet die registrierte Asset-ID und die kanonische Asset-URL gemeinsam. Eine temporäre Vorschau-URL oder die ursprüngliche externe Quell-URL ersetzt sie nicht. Für den unterstützten Ablauf mit einer Bild-URL kombiniert sosoapi_post_image_url Import und Einreichung. Das ist eine Veröffentlichungsoperation: Gib zuerst den vollständigen Beitrag frei. Behalte während der Verarbeitung die ID des angenommenen Beitrags; starte keinen weiteren Import, um ihn fortzusetzen.

X unterstützt einen eigenen TEXT-Beitrag ohne Medien oder VIDEO mit genau einem bereiten, registrierten MP4-Video-Asset, mindestens 0.5 Sekunden lang und innerhalb der Upload-Grenze von 500 MiB. Video benötigt bestätigtes can_publish_video für das genaue Konto; Textzugriff allein reicht nicht. Eine ältere Verbindung kann deine Zustimmung zur erneuten Verbindung mit Video-Upload-Berechtigung benötigen. Text, Hashtags und Link müssen in die gewichtete Textgrenze von X passen. Fotos, Antworten, Zitate, Reposts und Thread-Veröffentlichungen werden nicht unterstützt. Ein angenommener Upload oder eine angenommene Videoverarbeitung ist kein veröffentlichtes Ergebnis.

Lies vor einer X-Einreichung sosoapi_get_x_usage für die vorgesehene workspace_id und den endgültigen Text. Kontingent und Kosten sind vom allgemeinen Tarifkontingent getrennt. Umgehe keine Credit-Grenze mit wiederholten Einreichungen; gleiche eine ungewisse Veröffentlichung vor einem erneuten Senden ab.

Einen geprüften Stapel vorbereiten und Leistung ehrlich bewerten

Probiere nach deinem ersten erfolgreichen Beitrag die folgende Produkteinführungsanfrage aus. Prüfe nach deiner Freigabe der genauen Tabelle den Stapel gegen die Tarifgrenzen. Melde angenommene und abgelehnte Ziele getrennt und behalte die Identität jedes angenommenen Beitrags.

Veröffentlichungszugriff und Analysezugriff können sich unterscheiden. Wenn du später eine Leistungsanalyse anforderst, müssen nicht verfügbare Kennzahlen als nicht verfügbar gemeldet werden. Erfinde keine Nullwerte und leite aus einer Veröffentlichung nicht ab, dass jede Kennzahl lesbar ist.

Bereite mit derselben geprüften Einrichtung sieben Produktankündigungsentwürfe aus meinen öffentlichen Fakten vor, einen pro Tag. Zeige eine Prüftabelle mit Entwurf, Ziel, Medien, lokalem Datum, Uhrzeit und Zeitzone für jede Zeile. Behalte alle sieben als Entwürfe, bis ich die genaue Tabelle freigebe.

9. CLI- und API-Anleitung

Nutze diesen optionalen Weg für ausdrückliche Anfragedateien oder eine Backend-Integration. Agentennutzer können ihn überspringen. Die Beispiele nutzen dieselben Konto-, Workspace- und Veröffentlichungsberechtigungen wie MCP.

Prüfe zuerst die Hilfe und den eingebetteten Vertrag des installierten Pakets; Vertragsprüfung benötigt keine Anmeldung. Sie zeigt die mit diesem Paket gelieferten Operationen und Schemas. Nutze diese Feldnamen statt des Anfrageformats eines anderen Anbieters.

npx -y sosoapi --help
npx -y sosoapi api contract --summary
npx -y sosoapi api contract --route /studio-api/scheduled-posts/

CLI: Deine erste authentifizierte Kontextanfrage

Schließe auth login ab. Speichere mit einem Texteditor workspaces.json mit dem JSON unten und führe dann den Befehl aus. Nutze Dateien für Anfrageinhalte, statt Inhalte in Shell-Befehle einzusetzen.

Die CLI liefert schema_version, http_status und body. Eine erfolgreiche Antwort enthält body.active_workspace_id und body.workspaces. Wähle aus dieser Antwort den vorgesehenen Workspace; der aktive Workspace legt nicht stillschweigend das Ziel einer neuen Aufgabe fest. Der erste Aufruf eines neuen Kontos kann seinen ersten Workspace initialisieren.

Prüfe http_status und body, nicht nur den Shell-Exitcode. Ein Befehl kann eine HTTP-Fehlerhülle zurückgeben, ohne dass die API-Operation erfolgreich war.

{}

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

CLI: Das verbundene Social-Media-Konto wählen

Speichere accounts.json mit der für dein Konto zurückgegebenen Workspace-ID und führe dann den Befehl aus. Wähle das vorgesehene Konto aus body.accounts. Seine SosoAPI-Konto-ID ist die beim Planen verwendete social_account_id; ein Nutzername oder eine Anbieter-Page-ID ersetzt sie nicht.

{
  "workspace_id": "<YOUR_WORKSPACE_ID>"
}

npx -y sosoapi api post /identity-api/user/social-accounts/list < accounts.json

CLI: Einen freigegebenen Threads-Textbeitrag planen

Dies ist eine Anfragevorlage, kein sofort ausführbarer Beitrag. Speichere post.json mit einem Dateieditor und ersetze jeden Wert in eckigen Klammern durch eigene autorisierte Werte. Wähle einen zukünftigen ISO-Zeitstempel mit ausdrücklichem UTC-Offset oder Z für UTC. display_timezone ist eine IANA-Zeitzone zur Anzeige; sie vervollständigt keinen mehrdeutigen lokalen Zeitstempel.

Erzeuge einen eindeutigen idempotency_key, etwa eine UUID, und speichere ihn mit dem genauen Anfrageinhalt. Wiederhole eine identische Anfrage mit demselben Schlüssel; eine verzögerte Antwort ist kein Grund für einen neuen Schlüssel. Ein geänderter Beitrag ist eine andere Anfrage: Prüfe das ursprüngliche Ergebnis, bevor du eine neue Identität wählst.

Führe nach der Bestätigung von Inhalt, Konto, Zeitpunkt, Berechtigungen und aktuellem Kontingent den create-Befehl aus. Damit planst du einen echten Beitrag. Behalte bei Annahme body.post.id und lies body.post.status, body.post.scheduled_at und body.post.destination. body.deduped zeigt, ob eine bestehende Anfrage wiederverwendet wurde. Annahme ist keine vom Anbieter bestätigte Veröffentlichung.

{
  "workspace_id": "<YOUR_WORKSPACE_ID>",
  "social_account_id": "<YOUR_THREADS_ACCOUNT_ID>",
  "caption": "<YOUR_APPROVED_POST_TEXT>",
  "hashtags": [],
  "media": [],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {
      "post_type": "TEXT"
    }
  },
  "scheduled_at": "<FUTURE_ISO_8601_TIME_WITH_OFFSET>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<NEW_STABLE_REQUEST_KEY>"
}

npx -y sosoapi api post /studio-api/scheduled-posts/create < post.json

CLI: Den gespeicherten Beitrag und sein Ergebnis lesen

Speichere post-status.json mit der zurückgegebenen ID. Lies body.post, body.delivery, body.actions und body.outcomes. Bestätige ein veröffentlichtes Ergebnis, bevor du Erfolg meldest. Wenn die create-Antwort verloren ging, stelle die ursprüngliche Anfrage anhand ihrer gespeicherten Identität wieder her; erstelle keine weitere Planung mit einem neuen Schlüssel.

{
  "id": "<RETURNED_POST_ID>"
}

npx -y sosoapi api post /studio-api/scheduled-posts/get < post-status.json

CLI: Nur abbrechen, wenn das aktuelle Ergebnis es erlaubt

Wenn der letzte Abruf einen Abbruch erlaubt und du abbrechen möchtest, speichere cancel.json mit der zurückgegebenen ID und der aktuellen numerischen body.post.version. Die Beispielversion 1 ist nur zur Veranschaulichung: Ersetze sie durch die gerade gelesene Version. Führe dann den Befehl aus und bestätige das Ergebnis.

Wenn sich die Version geändert hat oder Abbrechen nicht verfügbar ist, lies denselben Beitrag erneut und nutze seine tatsächlich verfügbaren Aktionen. Umgehe keinen Versionskonflikt und verwechsle Abbrechen nicht mit dem Löschen eines bereits veröffentlichten Beitrags.

{
  "id": "<RETURNED_POST_ID>",
  "expected_version": 1
}

npx -y sosoapi api post /studio-api/scheduled-posts/cancel < cancel.json

HTTP: Aus deinem eigenen Backend aufrufen

Erstelle für eine serverseitige Integration einen API-Schlüssel unter Connection → API und speichere das Geheimnis in der Geheimniskonfiguration deines Servers. Der aktuelle Bildschirm fragt nach einem Namen; er bietet keine Workspace- oder Funktionsauswahl. Ein vom Nutzer erstellter Schlüssel hat standardmäßig operate, publish und engage für die für diesen Nutzer zugänglichen Workspaces. Prüfe, ob diese Berechtigung zu deiner Integration passt. Der API-Vertrag unterstützt ausdrücklich begrenzte capabilities und workspace_ids für einen eingeschränkten Schlüssel.

Die normale Agenteneinrichtung nutzt OAuth und benötigt diesen API-Schlüsselschritt nicht. Im Beispiel ist SOSOAPI_ACCESS_TOKEN deine serverseitige Beispielvariable mit dem Schlüssel; sie ist keine SosoAPI-CLI-Einstellung. Die optionale CLI-Variable für persönliche Zugriffstoken heißt VICKY_API_KEY.

Nutze die Datei workspaces.json von oben. Direktes HTTP liefert den Endpunktinhalt ohne die CLI-Hülle http_status/body; lies den tatsächlichen HTTP-Status und JSON. Bewahre Zugangsdaten im Backend auf, nicht in Browsercode, Prompts, Screenshots oder geteilten Anfragedateien.

Das Einbetten sozialer Verbindungen in ein Produkt für deine eigenen Kunden ist eine separate Integrationsaufgabe. Diese Anleitung für ein einzelnes Konto belegt nicht, dass dieser Kunden-Onboarding-Ablauf bereit ist.

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer ${SOSOAPI_ACCESS_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data-binary @workspaces.json \
  'https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/workspace/list'

• API-Schlüssel verwalten: Connection → API
• API-Referenz
• API-Schlüsselerstellung und ausdrückliche Berechtigung
• Authentifizierung und Berechtigungen
• CLI-Referenz

10. Fehlerbehebung

Nutze den tatsächlichen Fehler und die Verbindung, die du untersuchst. Mehr Berechtigungen oder eine wiederholte Einreichung beheben nicht jeden Fehler.

Aktualisieren, Zugriff widerrufen oder Hilfe anfordern

Der erste Befehl unten prüft die Hilfe des neuesten Pakets, ohne den MCP-Server zu starten. Wenn der Client eine Version in seinem gespeicherten Befehl festlegt, aktualisiere diesen Befehl bewusst. Das Aktualisieren einer separaten globalen Installation aktualisiert nicht die festgelegte Client-Kopie.

Widerrufe ein lokales Gerät über Connection → Agent oder den folgenden Befehl auth logout. Widerrufe für einen gehosteten Connector die passende gehostete Autorisierung unter Connection → Agent. API-Schlüssel werden separat unter Connection → API verwaltet. Das Widerrufen des Agentenzugriffs bricht bereits angenommene Planungen nicht ab; verwalte diese Beiträge getrennt.

Gib für Hilfe die Client- und Paketversion, den fehlgeschlagenen Schritt, den angezeigten Fehler und Zeitpunkt/Zeitzone an. Teile relevante Anfrage- oder Beitrags-IDs bei Bedarf privat mit dem Support. Sende keine Zugangsdaten, Autorisierungslinks oder Rohprotokolle, die Token enthalten könnten.

npx -y sosoapi@latest --help

npx -y sosoapi auth logout

• Agent-Clients verwalten: Connection → Agent
• API-Schlüssel verwalten: Connection → API
• Referenz zur Fehlerbehebung
• SosoAPI-Support kontaktieren

Checkliste zum Abschluss der Einrichtung

Du kannst die Verbindung einrichten, ohne einen Beitrag einzureichen. Wenn du veröffentlichst, nutze die separate Ergebnisprüfung, um diesen ersten Veröffentlichungsablauf zu bestätigen.

• Mein Client kann SosoAPI-Werkzeuge nutzen oder meine CLI/API kann eine autorisierte Anfrage stellen.
• Ich habe mich mit dem vorgesehenen Konto angemeldet und den richtigen Workspace gewählt.
• Mein Social-Media-Konto erscheint mit den für die Aufgabe benötigten Funktionen.
• Ich verstehe, ob mein Agent nur Arbeit vorbereiten oder auch planen und veröffentlichen kann.
• Ich kann einen Entwurf vorbereiten und Ziel, Inhalt und Zeitpunkt genau prüfen.
• Falls ich einen Beitrag eingereicht habe, habe ich seine ID behalten und kann Annahme von bestätigter Veröffentlichung unterscheiden.
• Ich weiß, wie ich einen Fehler prüfe, eine ausstehende Planung verwalte und Zugriff widerrufe.