Deine Kanäle.
Dein KI-Assistent.

In drei Schritten verbinden.

Mit MCP kann ein kompatibler KI-Client SocialBlaze-Tools nutzen. Du musst kein GraphQL schreiben, um über die benannten Tools Beiträge zu lesen, Entwürfe zu erstellen oder Veröffentlichungen zu planen.

https://backend.socialblaze.ai/api/developer/mcp

Client-Funktionen und Kontoverfügbarkeit können variieren. Eine benutzerdefinierte MCP-Verbindung bedeutet nicht, dass ein Connector im jeweiligen Marktplatz gelistet ist. Für eine persönliche Server-App verwende den API-Schnellstart; für andere Nutzer verwende die Registrierung einer OAuth-App.

Mit Claude verbinden

1. Öffne Anpassen > Konnektoren, wähle Add und dann Add custom connector. Nenne den Connector SocialBlaze, füge die obige MCP-Server-URL ein und fahre fort.
2. Prüfe die erkannten Authentifizierungseinstellungen. Wähle Sign in now und unter OAuth client die Option Register automatically. SocialBlaze nutzt die automatische Registrierung statt der veröffentlichten Identität von Claude. Melde dich bei SocialBlaze an, prüfe die angeforderten Berechtigungen, wähle Kanäle aus und schließe mit Add ab. Für diese OAuth-Verbindung brauchst du keinen API-Schlüssel.
3. Öffne in einem neuen Chat +, dann Connectors, und aktiviere SocialBlaze. Wenn Claude meldet, dass dieser Server bereits verbunden ist, verwende den bestehenden Eintrag unter Yours, statt einen weiteren Connector anzulegen.

Arbeitsbereichsadministratoren müssen den Connector möglicherweise zuerst hinzufügen. Lies den Leitfaden für benutzerdefinierte Claude-Connectoren für aktuelle Ansichten und Kontovoraussetzungen.

Ein verbundener Kanal fehlt in meiner KI

Prüfe, ob der Kanal in SocialBlaze freigeschaltet und zugänglich ist. Verbinde SocialBlaze dann aus deiner KI-App erneut, prüfe die angeforderten Berechtigungen und wähle den fehlenden Kanal aus. Ein hinzugefügter oder freigeschalteter Kanal wird nicht automatisch Teil einer bestehenden KI-Verbindung; deren Aktualisierung behält die Kanalauswahl bei. Behalte deine bestehende Verbindung, bis die neue funktioniert. Du musst Instagram oder Facebook nicht erneut verbinden, um nur die Kanalauswahl deiner KI-Verbindung zu ändern.

Wenn du Analyseberechtigungen hast und der Kanal sichtbar ist, aber kein gespeicherter Bericht vorliegt, ist das ein separates Problem der Datenverfügbarkeit. Eine geänderte Kanalauswahl erfasst oder aktualisiert keine Analysedaten.

Probiere hilfreiche, klar begrenzte Anfragen aus

Halte bei „den letzten 10 veröffentlichten Beiträgen“ jeden zurückgegebenen Kanalbeitrag getrennt, auch wenn Texte oder Artikellinks übereinstimmen. Die Ergebnisse umfassen die von dir autorisierten Kanäle, nicht unbedingt dein gesamtes Konto. Ein fehlender gespeicherter Bericht oder eine unbekannte Kennzahl bedeutet nicht null; das Lesen eines Berichts aktualisiert kein Netzwerk. Beitragsvorschaukarten befinden sich in der Vorschauphase. In ChatGPT kann die erste Anzeige fehlschlagen; wähle Try again, um die Karten zu laden. Wenn ein Bild nicht geladen werden kann, öffne den gespeicherten Beitrag in SocialBlaze. Die Verfügbarkeit in anderen KI-Apps variiert. Extern gehostete Bilder können nicht verfügbar sein; eine Vorschau repariert ihre Quelle nicht. Geplante oder angenommene Beiträge sind keine bestätigten Veröffentlichungen; prüfe den zurückgegebenen Status, bevor du Erfolg meldest.

Der Dienststatus hat eine eigene Seite.

Aktuelle Nachweise zu Kerndiensten, API und MCP sowie zur Netzwerkveröffentlichung findest du auf der Dienststatusseite.

Verfolge, woran wir arbeiten.

Bereits veröffentlichte Funktionen, laufende Verbesserungen und geplante Entwicklungen findest du auf der Roadmap-Seite.

Erstelle deine erste API-Anfrage.

Melde dich bei deinem SocialBlaze-Konto an, öffne die Entwicklerkonsole und erstelle einen Schlüssel. Wähle die Kanäle und Berechtigungen, die deine Integration benötigt. Kopiere das Geheimnis einmal und speichere es auf deinem Server.

curl -A 'SocialBlazeDeveloperClient/0.1 (+https://socialblaze.ai/api)' 'https://backend.socialblaze.ai/api/developer/graphql' \
  -H "Authorization: Bearer $SOCIALBLAZE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"query":"{ channels { id name service connected } }"}'

Die zurückgegebenen Kanal-IDs gehören zu deinem ausgewählten Zugriff. Verwende diese IDs beim Erstellen von Beiträgen. Die Konsole enthält einen ausführbaren Explorer, der seine Zugangsdaten während der Sitzung im Arbeitsspeicher hält.

Entwerfen. Prüfen. Planen. Veröffentlichen.

mutation Publish($key: String!, $channels: [ID!]!, $text: String!) {
  createPost(requestKey: $key, channelIds: $channels, text: $text,
    mode: publishNow) {
    accepted published
    posts { id channelId status publishingState publishedUrl
      failure { code message automaticRetrySafe } }
  }
}

Angenommen bedeutet nicht zugestellt. Lies post.allowedActions für Hinweise zum lokalen Bearbeiten und Stornieren innerhalb deiner Berechtigungen; jede Mutation prüft die aktuelle Version und den Veröffentlichungsstatus erneut. Lies jede zurückgegebene Beitrags-ID, um Status, Veröffentlichungs-URL und Fehlerdetails zu prüfen. Ein gemischter ungültiger Stapel speichert nichts. Wiederhole einen Schreibvorgang mit unklarem Ergebnis niemals mit einem neuen Anfrageschlüssel.

Bewahre contentItemId von createPost oder createThread auf. Beim Löschen eines Ziels kann der zugehörige Quellentwurf erhalten bleiben. Um die vollständige lokale Inhaltsgruppe zu entfernen, lies die aktuelle Version des Inhaltselements und verwende deleteContentItem; bestätige anschließend, dass die Gruppe und ihre Beiträge nicht mehr vorhanden sind.

Ein Datum oder eine Warteschlangenposition wählen

Nutze mode: schedule mit einem ausdrücklich zukünftigen dueAt für einen festen Zeitpunkt. Verwende addToQueue oder prioritize ohne Datum für die Platzierung in der nativen Kanalwarteschlange. Warteschlangenaktionen erfordern die Funktion für intelligente Warteschlangen in deinem Tarif und eine Veröffentlichungsberechtigung. Um einen bestehenden zukünftigen Beitrag zu verschieben, verwende movePostInQueue oder das benannte MCP-Tool move_post_in_queue mit der neuesten Version und einem stabilen Anfrageschlüssel.

Das Verschieben in der Warteschlange kann die Fälligkeit anderer Beiträge ändern. Lies danach die geplanten Beiträge des Kanals und ihre Versionen erneut. Wenn ein geeigneter, über die Warteschlange erstellter Beitrag ans Ende verschoben wird, kann die sicher zugeordnete Warteschlange in ihren bestehenden Zeitfenstern zusammenrücken; ein Beitrag mit festem Datum wird nicht allein durch einen gemeinsamen Zeitstempel Teil dieser Warteschlange. Unterschiedliche Eigentümer, ein unsicherer Veröffentlichungsstatus oder belegte feste Zeitfenster können eine Neuordnung verhindern. Die zurückgegebene Annahme ist kein Zustellnachweis.

mutation MoveInQueue($id: ID!, $version: String!, $key: String!) {
  movePostInQueue(id: $id, version: $version, requestKey: $key,
    position: "bottom") { id version deleted }
}
# Read the post's current version first. Use "top" for priority placement.
# Then read this channel's scheduled posts again to check actual due times.

Zugestellte Beiträge lesen, ohne Kanäle zusammenzufassen

Lies jeden Netzwerkbeitrag einzeln und behalte seine ID, seinen Kanal und die zurückgegebene URL bei. Die standardmäßige absteigende Sortierung nach Datensatz-ID entspricht dem Website-Feed innerhalb der für die Zugangsdaten autorisierten Kanäle. Eine Freigabe ausgewählter Kanäle zeigt nicht jeden Kanal des Arbeitsbereichs. Für eine Chronologie anhand geeigneter erfasster Zustellnachweise fordere sort: [{field: publishedAt, direction: desc}] und optional publishedAfter/publishedBefore an. Lies die nullable Felder publishedAt und publishedAtBasis. native_terminal_delivery_observed ist der Zeitpunkt der ersten lokalen Abschlussbestätigung, kein unabhängig bestätigter ursprünglicher Veröffentlichungszeitpunkt beim Anbieter; geplante, erstellte und bearbeitete Daten ersetzen niemals einen unbekannten Veröffentlichungszeitpunkt. Unbekannte Zeiten stehen zuletzt und können keine vollständige chronologische Aussage zu den letzten zehn Beiträgen begründen. Setze Cursor zurück, wenn sich Filter oder Sortierung ändern.

query {
  posts(first: 10, status: "delivered") {
    nodes { id channelId text publishedUrl publishedAt publishedAtBasis }
    pageInfo { endCursor hasNextPage }
  }
}
# Default order matches the website feed's descending record IDs.
# For known recorded publication times, use sort:[{field:publishedAt,direction:desc}].

Beitragslisten filtern und paginieren

Lasse statuses weg, um den Status nicht einzuschränken. Ein ausdrücklich leeres statuses: [] wählt keine Beiträge aus; GraphQL statuses: null lässt den Filter ebenfalls uneingeschränkt. Wenn du einen einzelnen status mit statuses angibst, bilden ihre Werte eine gemeinsame Auswahl; ein einzelner Status gilt also auch neben einem leeren Array. Diese Regeln gelten auch für die zugehörige Beitragsanzahl. Bei dueAt in aufsteigender Reihenfolge stehen Beiträge ohne geplantes Datum zuerst, bei absteigender Reihenfolge zuletzt. publishedAt lässt unbekannte Zeiten in beiden Richtungen zuletzt stehen. Verwende dueAtPresence: present für ausschließlich geplante Daten. Fahre mit dem zurückgegebenen pageInfo.endCursor fort; beginne erneut ohne after bei geänderten Filtern, anderer Sortierung oder geändertem ausgewähltem Zugriff sowie bei Ablehnung eines Cursors. Ein vor der Aktualisierung der Fälligkeitsreihenfolge gespeicherter Cursor kann nicht für eine Sortierung mit dueAt in aufsteigender Reihenfolge wiederverwendet werden.

Bilder, Videos und Dokumente

Füge JPEG-, PNG- oder WebP-Bilder innerhalb des Limits jedes Ziels oder ein MP4/MOV-Video hinzu. Standardbeiträge erlauben bis zu 10 Bilder auf Facebook, Instagram, Tumblr und WordPress; 20 auf LinkedIn und Threads; 35 auf TikTok; 4 auf Bluesky, Mastodon und Google Business Profile; und 1 auf Pinterest. YouTube erfordert ein Video. Tumblr akzeptiert ein H.264-MP4/MOV-Video mit bis zu zehn Minuten Länge innerhalb desselben Importlimits von 50 MB. Ein gemeinsamer Beitrag muss zu jedem ausgewählten Ziel passen. Gruppen aus mehreren Beiträgen und Threads behalten ein Gesamtlimit von acht Anhängen pro Anfrage. Bilder können eine separate geschützte thumbnailUrl für ihre SocialBlaze-Vorschau enthalten; sie ersetzt nicht das an ein Netzwerk gesendete Bild. Bilder akzeptieren außerdem eine separate geschützte animatedThumbnail: eine öffentliche GIF- oder WebP-Vorschau mit bis zu 1 MiB. Statische und animierte Vorschauen verwenden jeweils ihr eigenes Importkontingent und behalten separate URLs. Das Originalbild muss weiterhin die Bildregeln des Ziels erfüllen. Beim Lesen von Medien werden beide URLs zurückgegeben; isAnimated bleibt null, bis die Animation gemessen wurde; eine Vorschau-URL belegt daher nicht, dass das Originalbild animiert ist. LinkedIn akzeptiert auch ein PDF mit Titel und einer optionalen HTTPS-thumbnailUrl für die SocialBlaze-Vorschau. Vorschaubilder sind validierte JPEG-, PNG- oder WebP-Dateien mit maximal 1 MB; LinkedIn rendert seine eigenen Dokumentseiten. Bilder sind auf jeweils 8 MB, Videos auf 50 MB und PDFs auf 20 MB begrenzt. Kanalspezifische Validierung gilt weiterhin; prüfe configuration und channel.capabilities.

Gespeicherte PDF-Medien stellen die nullable Felder numPages (gemessene Seitenzahl) und filesize (Bytes aus dem validierten Import) bereit. Bei älteren Medien oder einer nicht verfügbaren Seitenzahl bleibt der Wert null, niemals eine erfundene Null; eine gemessene Größe kann auch bei unbekannter Seitenzahl verfügbar sein. Diese Werte beschreiben das gespeicherte importierte PDF, keine vom Anbieter gerenderte Kopie. Ihr Lesen lädt die Datei nicht erneut herunter und ergänzt keine älteren Medien nachträglich. Die benannten MCP-Tools get_post und list_posts enthalten die Felder. Verwende beim unveränderlichen Node-Client 0.1.14 eine ausdrückliche GraphQL-Auswahl, wenn du diese neueren Felder benötigst.

query SavedDocument($postId: ID!) {
  post(id: $postId) {
    id version
    assets { type title mimeType numPages filesize }
  }
}

Einen Beitrag mit Medien und ohne Text planen

Für ein unterstütztes Ziel akzeptieren createPost und das benannte Tool create_post als Wert text: "" mit gültigen Bildern oder einem Video. Leerer Text ohne Medien wird abgelehnt. Erforderliche Titel, netzwerkspezifische Optionen und Medienlimits gelten weiterhin; ein Beispiel für einen reinen Textentwurf zeigt diesen Ablauf nicht. In einer interaktiven Veröffentlichungsverbindung kann die vorbereitete Karte auch eine leere Bildunterschrift mit Medien beibehalten: Prüfe die ausgewählten Konten und Inhalte, bevor du Schedule oder Post wählst.

mutation ScheduleVideo($key: String!, $channel: ID!, $url: String!,
    $when: String!) {
  createPost(requestKey: $key, channelIds: [$channel], text: "",
    video: {url: $url}, mode: schedule, dueAt: $when) {
    contentItemId accepted published posts { id channelId status dueAt version }
  }
}
# Use a direct public HTTPS MP4/MOV URL and an eligible video channel.
# Choose a future ISO 8601 time with an explicit UTC offset.
# Check that channel's required publishing options before submitting.

Gemeinsam bearbeiten und eine Prüfung anfordern

Für einen einfachen, integrationseigenen Einzelkanalentwurf auf einem Kanal mit Freigabepflicht verwende updatePost mit approvalChange: request oder revert. Das benannte MCP-Tool edit_post unterstützt diese Optionen ohne Text. Gib die neueste Version, einen stabilen Anfrageschlüssel und drafts:write und posts:review an. Inhalt und Anhänge ändern sich atomar mit der Prüfanfrage. Eine Freigabe allein veröffentlicht nichts; reiche den unveränderten freigegebenen Entwurf anschließend ausdrücklich ein. Geänderte freigegebene Inhalte benötigen eine erneute Prüfung.

Eine zukünftige Veröffentlichungsmethode ändern

Nutze updatePost(publishingMethod: automatic) oder reminder oder das benannte Tool edit_post, um einen sicheren zukünftigen Beitrag unter Beibehaltung seiner ID umzustellen. Gib seine aktuelle Version und einen stabilen Anfrageschlüssel an. Dies erfordert sowohl Entwurfs- als auch Veröffentlichungsberechtigungen. Automatische Beiträge müssen eine zukünftige Planung haben; Erinnerungen müssen in der Warteschlange stehen und noch nicht versendet worden sein. Beiträge mit Veröffentlichungsversuchen, Prüfanforderungen oder Thread-Zugehörigkeit können nicht umgewandelt werden. Eine Erinnerung benötigt ein aktives mobiles Benachrichtigungsgerät mit angemeldetem Nutzer. Die Umwandlung prüft Ziel, Tarif, Medien und aktuellen Zugriff erneut; sie bestätigt keine Netzwerkzustellung.

Die Quelle im Composer nachverfolgen

createDraft, createPost, createThread und jeder createContentItemVariants als Eintrag akzeptieren das nullable Feld source, eine vom Aufrufer angegebene Tracking-Bezeichnung mit bis zu 250 Zeichen. Entsprechende benannte MCP-Erstellungstools unterstützen dies ebenfalls, einschließlich Prüfbeiträgen. Ein Thread verwendet dieselbe Bezeichnung für alle Einträge; Varianten können separate Bezeichnungen haben. Lies sie über post.provenance.composerSource und composerSourceBasis; die benannten get_post und Node getPost enthalten Herkunftsangaben. Gewöhnliche Listenabfragen enthalten diese ebenfalls; Listen mit gespeicherten Kennzahlen lassen Herkunftsangaben und Metadaten animierter Vorschauen aus, um dasselbe Abfragebudget einzuhalten. Lies einzelne Beiträge, wenn du beides benötigst. Weglassen oder null beim Erstellen lässt die Bezeichnung unbekannt. Entwurfs- und zukünftige Beitragsänderungen akzeptieren sie ebenfalls: Weglassen behält sie bei, null löscht sie. Diese Bezeichnung verändert weder den erfassten Erstellungsweg noch Berechtigungen und beweist keine KI-Urheberschaft.

KI-Unterstützung deklarieren

Änderungen an Entwürfen und zukünftigen Beiträgen akzeptieren das nullable Feld aiAssisted, einschließlich der benannten MCP-Tools edit_post. False bleibt false, null löscht die Deklaration des Aufrufers und Weglassen behält sie bei. Dies ändert weder den Erstellungsweg noch erkennt es, wer den Text verfasst hat. Verwende bei einer unveränderten Wiederholung die neueste Version und denselben Anfrageschlüssel.

Regeln für jedes Format

Lies configuration.services.contentRules oder channel.capabilities.contentRules für jedes automatische Beitragsformat und jeden Anhangstyp. Die Regeln umfassen die Zählweise für Text und Titel, Anhangszahlen, zulässige Dateitypen und Bytelimits, erforderliche Kanaloptionen und die Unterstützung erster Kommentare. Dieser Katalog beschreibt die Validierung durch SocialBlaze. Dein Tarif, aktuelle Berechtigungen, Abmessungen und Anbieterprüfungen gelten weiterhin; er bestätigt keine Zustellung. Reels benötigen ein Video, automatische Stories ein Bild oder Video.

Kanalmetadaten und Erwähnungen

Lies Mitgliedschaftszahlen des Arbeitsbereichs und native Tariflimits über account.organizations. Kanäle enthalten Ziel-IDs des Anbieters, sichere Profil-URLs, Netzwerksymbole und Veröffentlichungsfunktionen. Paginiere große Auswahlen mit channels(first, afterId); MCP list_channels liefert Paginierungsmetadaten.

Beitrags- und Bibliotheksmedien liefern gespeicherte Werte für mimeType, width und height bei bekannten Werten; unbekannte Werte bleiben null. Zum Lesen ist kein Mediendownload erforderlich. Strukturierte Erwähnungen von Facebook-Seiten und auf LinkedIn verwenden channelOptions.mentions mit Start- und Längenangaben in Unicode-Codepoints sowie einer passenden Bezeichnung. Lies post.annotations für validierte Erwähnungen und unveränderte Links. Ungültige oder überlappende Bereiche werden abgelehnt; geänderte Beitragstexte müssen aktualisierte Erwähnungspositionen enthalten.

Erfasste Herkunft und Kontostatus

Lies post.provenance für den erfassten Erstellungsweg und optional die vom Aufrufer deklarierte KI-Unterstützung. Setze aiAssisted ausdrücklich, wenn bekannt; Unbekanntes bleibt null. Eine Anfrage über einen KI-Client beweist nicht, dass KI den Beitragstext geschrieben hat. Die Video-Kennzeichnung beim Anbieter verwendet ihre separate Kanaleinstellung.

account.preferences liefert deine gespeicherten Codes für Kalender- und Zeitanzeige, sofern bekannt. Kanalabfragen unterscheiden queuePaused, workspacePublishingPaused und credentialsExpired; das Pausieren der Veröffentlichung bedeutet nicht automatisch, dass die Anbieter-Zugangsdaten abgelaufen sind.

Textzählung in den Netzwerken

Bluesky verwendet kompakte sichtbare URL-Bezeichnungen und behält die vollständigen Ziele in Link-Facets mit UTF-8-Byteindizes bei. Gespeicherte Beitragstexte behalten ihre ursprünglichen URLs. Mastodon verwendet die konfigurierten Instanzmetadaten sowie die offiziellen Regeln für Grapheme, reservierte URLs und entfernte Erwähnungen; Inhaltswarnungen zählen wörtlich. Lies textLimitsBasis, textLimitsMetadataAvailable und charactersReservedPerUrl in den Veröffentlichungsfunktionen, um aktuelle Instanzmetadaten vom konservativen Ersatzwert zu unterscheiden. Metadatenabfragen sind begrenzt und werden zwischengespeichert.

TikTok-Fotos, Videos und Zustellung

Fototexte erlauben 4,000 UTF-16-Einheiten mit einem optionalen Titel von bis zu 90 Einheiten. Videotexte erlauben 2,200 Einheiten. Setze channelOptions.isAiGenerated für die Video-Kennzeichnung ausdrücklich; true wird bei Fotos abgelehnt. Zukünftige Änderungen an Videometadaten behalten ein ausdrückliches false bei. Lies tiktokPostingChoices(channelId) oder MCP get_tiktok_posting_choices für die tatsächlichen Datenschutzoptionen, Interaktionsbeschränkungen und Videolängen des ausgewählten Creators. Diese Abfragen können einen bis zu 60 Sekunden alten Cache verwenden; bei der Veröffentlichung erfolgt eine erneute Validierung. Wähle Zielgruppe und Zustimmung ausdrücklich. Eine zurückgegebene Veröffentlichungs-ID bestätigt die Annahme: Entwicklerbeiträge bleiben in Verarbeitung, bis ein verifizierter Anbieter-Callback oder eine begrenzte Anbieter-Statusabfrage die Zustellung für denselben ursprünglichen Versuch bestätigt. Die Statusprüfung reicht keine weitere Veröffentlichung ein. Eine öffentliche Beitrags-URL kann unbekannt bleiben.

Erwähnungen in Instagram-Bildern

Setze images[].userTags mit einem öffentlichen handle ohne @ sowie numerischen Koordinaten x/y im Bereich von 0 bis 1. Verwende bis zu zwanzig eindeutige Handles pro Bild. Feed-Bilder und Karussell-Kindelemente unterstützen positionierte Erwähnungen; Karussell-Elternelemente und automatische Stories nicht. Entferne positionierte Erwähnungen, bevor du eine automatische Story planst. Diese Felder gelten nur für Instagram; ungültige oder doppelte Handles und Koordinaten werden abgelehnt. Bibliotheksvorlagen behalten Bilderwähnungen bei der Wiederverwendung bei. Es handelt sich nicht um interne Inhaltstags.

Erinnerungen für manuelle Veröffentlichungen

Setze publishingMethod: reminder für deine ausgewählten Kanäle. Jeder erhält eine eigene Erinnerung. Aktiviere zuerst Benachrichtigungen in der angemeldeten SocialBlaze-Smartphone-App. Die Erinnerung hält einen vorbereiteten Entwurf bereit und öffnet dessen Inhalt zur Fälligkeit; sie veröffentlicht niemals automatisch. Unterstützt werden ein ausdrückliches Datum, der nächste manuelle Warteschlangenplatz und Priorität. changeReminder plant sie neu, storniert sie oder erfasst deine eigene Veröffentlichungsbestätigung. Bei Instagram-Erinnerungen kann stickerFields Musik, Produkte, Text, Themen und andere Hinweise zur Fertigstellung mit jeweils bis zu 2,000 Zeichen enthalten. Der angemeldete Erinnerungsbildschirm zeigt sie an und kopiert sie. Ergänze diese Details selbst in Instagram; automatische Veröffentlichung lehnt ausgefüllte Fertigstellungsfelder ab. Eine gesendete Benachrichtigung oder manuelle Bestätigung ist kein Netzwerk-Zustellnachweis. Eine Mehrkanalanfrage teilt importierte Medien und speichert entweder die gesamte Gruppe oder nichts. Das Löschen ihres Inhaltselements storniert alle ausstehenden Erinnerungen. Setze für eine Teamprüfung außerdem requestApproval: true mit posts:review und ausdrücklicher Zustimmung zu posts:publish. Die Erinnerung wartet auf die native Freigabe, bleibt vor automatischer Veröffentlichung geschützt und wird storniert, wenn die Prüfung zurückgezogen wird oder die Freigabe veraltet.

YouTube-Videoeinstellungen

Wähle privacy und madeForKids ausdrücklich. Frage configuration.youtubeCategories für Kategorie-IDs des Anbieters ab und setze categoryId bei Bedarf. Die optionalen Werte embeddable, license (youtube oder creativeCommon), notifySubscribers und isAiGenerated werden an den nativen YouTube-Upload übergeben. Ausdrückliche false-Werte bleiben erhalten. Du kannst diese Einstellungen bei einem zukünftigen Beitrag über updatePost.channelOptions bearbeiten, ohne sein Video zu ersetzen. Die KI-Kennzeichnung bezieht sich auf realistisch veränderte oder synthetische Inhalte; beachte die Kennzeichnungsanforderungen von YouTube.

Videocover

Setze für ein einzelnes Instagram-, TikTok- oder Pinterest-Video thumbnailOffset in den Kanaloptionen auf den Millisekundenversatz des Cover-Frames. Er muss innerhalb der importierten Videodauer liegen. Bei einem sicheren zukünftigen Beitrag kann updatePost bei einem bestehenden mandanteneigenen Import das Cover ändern oder das Video ersetzen und sein Cover in derselben Anfrage wählen. Bestehende native Beiträge können diese Bearbeitung nutzen, wenn ihre Medien ein unterstützter mandanteneigener Import sind; beliebige externe Video-URLs erlauben keine reine Cover-Änderung. Weggelassene Medien und Planungsangaben behalten das gespeicherte Medium und die Zeit bei. Verwende nach einer unklaren Antwort denselben Anfrageschlüssel erneut. Pinterest erhält den Frame-Versatz in ganzen Sekunden und akzeptiert ein importiertes MP4/MOV-Video mit bis zu 50 MB; das Video wird hochgeladen und verarbeitet, bevor der Pin erstellt wird. Instagram Reels akzeptieren außerdem shareToFeed, einschließlich eines ausdrücklichen false. Andere Kanäle und Instagram Stories lehnen diese Optionen ab.

Änderungen an zukünftigen Beiträgen benötigen die aktuelle Beitragsversion und einen mehr als zwei Minuten entfernten Termin. Beiträge in laufender Verarbeitung und zugestellte Beiträge können nicht geändert werden. Eine Änderung der Feed-Freigabe eines Reels behält Video und Cover bei, wenn diese Felder fehlen. Bearbeite bei Pinterest channelOptions.destinationUrl zum Ändern des Ziellinks; ein ausdrückliches null löscht den gespeicherten Link. Beitragsabfragen liefern diesen Wert sowohl in destinationUrl als auch in den Kanaloptionen. Diese Änderungen veröffentlichen nicht sofort.

Linkkarten

Gib für Standardbeiträge auf Facebook, LinkedIn, Bluesky oder Threads ohne andere Anhänge linkUrl in den Kanaloptionen an. LinkedIn und Bluesky akzeptieren außerdem linkTitle und linkDescription. Facebook und Threads verwenden die Vorschau der Zielwebsite. LinkedIn und Bluesky akzeptieren außerdem linkThumbnailUrl zusammen mit der Link-URL: eine direkte öffentliche JPEG-, PNG- oder WebP-Datei mit bis zu 1,000,000 Bytes, mit acht unterschiedlichen Vorschauen pro Anfrage. Sie wird geschützt importiert und beim Anbieter hochgeladen; ein Uploadfehler stoppt den Vorgang vor der Veröffentlichung. Speichere eine neue Vorschau vor dem Einreichen im Entwurf. Null löscht eine gespeicherte Vorschau. HTTPS-Links dürfen keine Zugangsdaten enthalten. Es erfolgt kein serverseitiges Scraping. Bearbeite zukünftige Karten mit updatePost.channelOptions; ein ausdrückliches null für linkUrl löscht die Karte samt Titel und Beschreibung. Das Löschen und gleichzeitige Ersetzen von Medien in derselben Anfrage ist atomar. Entwurfsoptionen führen ausdrücklich geänderte Felder zusammen; eine leere Liste setzt jede Auswahl zurück.

Orte und Threads-Themen

Instagram-Feed-/Reel- und Threads-Beiträge akzeptieren eine numerische Anbieter-ID als locationId und optional locationName. Instagram-Karussell-Kindelemente erhalten die Markierung nicht. Automatische Instagram Stories lehnen diese Option ab. Threads akzeptiert außerdem ein topic mit bis zu 50 UTF-16-Einheiten, ohne kaufmännisches Und oder Punkt. Weggelassene Optionen bleiben bei zukünftigen Änderungen erhalten; null löscht sie.

Inhaltswarnungen und KI-Kennzeichnung

Mastodon akzeptiert spoilerText; die Warnung wird wörtlich gezählt und teilt sich mit dem vorbereiteten Beitragstext das konfigurierte Zeichenkontingent der Instanz. Die Zählregeln der Instanz für URLs und entfernte Erwähnungen gelten für den Beitragstext, nicht für die Warnung. Verwende null, um eine gespeicherte Warnung zu löschen. Instagram, YouTube und TikTok-Video akzeptieren isAiGenerated. Instagram sendet dies nur im übergeordneten Mediencontainer. Nicht unterstützte Netzwerkoptionen werden abgelehnt, bevor Beiträge gespeichert werden.

Erste Kommentare

Erste Kommentare haben separate UTF-16-Limits: Facebook 5,000, Instagram 2,200, LinkedIn 1,250 und Threads 500. Lies maxFirstCommentLength und firstCommentLengthUnit in der Kanalfunktion. Emoji können als zwei Einheiten zählen. Nicht unterstützte Ziele und Stories lehnen Kommentare ab; Text wird niemals stillschweigend gekürzt. Bestehende Tarifberechtigungen gelten weiterhin.

Textlimits

Die meisten Entwickler-Beitragstexte verwenden UTF-16-Einheiten, wobei viele Emoji als zwei zählen. LinkedIn-HTTP(S)-URLs zählen als 24 Einheiten; logische Zeilenumbrüche auf Instagram als zwei. Facebook-Texte erlauben 5,000, Instagram 2,196; Pinterest- und YouTube-Titel erlauben 100. Google Business behält sein natives Limit von 1,500 bei. Mastodon verwendet begrenzte Instanzmetadaten mit einem konfigurierten konservativen Ersatzwert; die Funktionsfelder geben die aktuelle Grundlage und Metadatenverfügbarkeit an. Bluesky zählt Grapheme nach kompakten sichtbaren Linkbezeichnungen und behält vollständige URL-Ziele in Link-Facets bei. Ursprünglich gespeicherte Beitragstexte bleiben unverändert. Lies die Kanalfunktionen für das aktuelle Limit und die Zähleinheit.

Google Business-Beiträge

Nutze channelOptions.businessPost für Standardupdates, Veranstaltungen und Angebote. Veranstaltungen und Angebote benötigen einen Titel sowie lokale Start- und Enddaten. Optionale zusammengehörige Uhrzeiten verwenden HH:mm; ohne beide gilt der gesamte lokale Tag. Die UTC-Veröffentlichungsplanung bleibt separat. Standardupdates und Veranstaltungen unterstützen Aktionsschaltflächen; Angebote verwenden Gutschein, Einlöselink und Bedingungen. Anrufschaltflächen verwenden die geschäftliche Telefonnummer ohne Aktions-URL. Andere Schaltflächen benötigen HTTPS-URLs. Diese Optionen erfordern automatische Veröffentlichung, behalten die bestehenden Kurztext- und Bildlimits bei und bedeuten niemals eine bestätigte Anbieterzustellung.

Instagram-Audio

Durchsuche lizenzierte Musik und Originalsounds über die Audiokatalog-Abfragen. Facebook Login ist erforderlich. Gib für ein Reel mit einem einzelnen Video eine Audio-ID und optionale Lautstärken in den Kanaloptionen an. Vorschauen laufen ab; Berechtigungsfehler und unvollständige Ergebnisse werden ausdrücklich angezeigt. Gespeicherte Entwurfsoptionen bleiben beim späteren Einreichen erhalten.

Geordnete Threads

Bluesky, Mastodon und Threads unterstützen 2–25 Einträge. Antworten warten auf die bestätigte Zustellung des übergeordneten Beitrags. Das Neuplanen oder Stornieren des Stammbeitrags hält seine sicheren zukünftigen Antworten zusammen. Bluesky- und Threads-Einträge akzeptieren außerdem linkUrl; Bluesky akzeptiert linkTitle, linkDescription und eine geschützte linkThumbnailUrl. Karten können nicht mit anderen Medien kombiniert werden; Threads verwendet die Vorschau der Zielwebsite. Mastodon lehnt Karten ab. Threads erlauben acht Anhänge über die gesamte Anfrage und höchstens 100 Zielbeiträge.

mutation {
  createThread(requestKey: "launch-thread-001", channelIds: ["YOUR_CHANNEL_ID"],
    mode: schedule, dueAt: "2026-11-01T14:00:00+00:00",
    entries: [{text: "First part"}, {text: "The follow-up"}]) {
    contentItemId accepted posts { id status thread { rootPostId parentPostId position total } }
  }
}

Anhänge eines zukünftigen Threads bearbeiten

Nutze updateContentItem.threadEntries oder das benannte Tool edit_content_item zum Ersetzen oder Löschen von Anhängen und Linkoptionen für den gesamten bestehenden Thread. Gib jeden Eintrag in Reihenfolge, seinen Text, die aktuelle Gruppenversion und einen stabilen Anfrageschlüssel an. Weggelassene Anhänge bleiben unverändert; images: [] oder clearMedia: true entfernt sie. Gemeinsame Uploads werden pro Eintrag kanalübergreifend einmal importiert. Für jedes Ziel darf noch kein Versuch und keine Veröffentlichung erfolgt sein; sein Termin muss mehr als zwei Minuten in der Zukunft liegen. Die gesamte Änderung wird atomar gespeichert. Behalte dieselbe Eintragszahl bei und ändere die Planung separat; Größenänderungen und kombinierte Medien-/Planungsänderungen werden nicht unterstützt.

Inhaltsgruppenfilter

Filtere contentItems nach draftContent oder postContent und sortiere nach createdAt und updatedAt. Die Suche ist standardmäßig auf deine Integration begrenzt. Ein ausdrückliches discovery: workspace erfordert ein separat genehmigtes content:read zusammen mit posts:read; bestehende Zugangsdaten erhalten dies nicht automatisch. Damit werden auch Gruppen gelesen, die unter deinen nativen Arbeitsbereichsberechtigungen und ausgewählten Kanälen sichtbar sind. Gruppen mit einem nicht zugänglichen Ziel werden einschließlich ihres gemeinsamen Texts und ihrer Medien ausgeschlossen. Prüfe managedByCurrentIntegration; integrationsübergreifende Gruppenänderungen bleiben blockiert, während einzelne Beitragsänderungen ihre separaten Autorisierungsprüfungen behalten. Cursor sind an Suchbereich, Filter, Reihenfolge und Kanalzugriff gebunden; setze die Paginierung bei Änderungen zurück. SDK0.1.14 bietet contentItems(options) und contentItem(id, options) als Lesehilfen.

Teamprüfung

Nutze posts:review und requestApproval: true zum Erstellen von Beiträgen mit ausgesetzter Veröffentlichung. requestPostApproval sendet einen bestehenden unveröffentlichten Beitrag zur Prüfung. withdrawPostApproval setzt ihn nur dann auf einen Entwurf zurück, wenn deine nativen Freigabeberechtigungen dies erlauben. Eine Prüfberechtigung gewährt niemals automatische Veröffentlichung.

Passe jedes Ziel an.

Nutze createContentItemVariants für kanalspezifische Texte, Titel, Anhänge, native Optionen oder Zeitpläne. Gib unterschiedliche ausgewählte Kanal-IDs in posts an. Die Gruppe unterstützt bis zu 25 Ziele und insgesamt acht Anhänge innerhalb deiner bestehenden Medien- und Veröffentlichungslimits. Identische Medieneinträge teilen sich einen geschützten Import.

mutation Campaign($key: String!, $posts: [ContentVariantInput!]!) {
  createContentItemVariants(requestKey: $key, title: "Product launch", posts: $posts) {
    contentItemId accepted published
    posts { id channelId text title status isDraft publishingMethod
      manualReminder { state providerDeliveryConfirmed } dueAt version }
  }
}
# Each posts entry supplies its own channelId, text, optional media,
# channelOptions, mode and dueAt. Read real channel IDs first.

Validierung und Speicherung sind atomar: Eine fehlgeschlagene Variante speichert keine Teilkampagne. Jeder Eintrag verwendet standardmäßig die Warteschlange oder seinen angegebenen Termin. Verwende mode: publishNow nur für ein beabsichtigtes sofortiges Einreichen. Setze requestApproval: true für eine ausgesetzte Teamprüfung. Die Annahme ist weiterhin keine bestätigte Zustellung.

Lies contentItem.hasChannelVariants und die Gruppenversion; lies anschließend einzelne Beitrags-IDs für vollständige Details. Bearbeite einen einzelnen Beitrag, um unterschiedliche Texte beizubehalten. Eine Gruppenänderung an Text oder Medien wendet dieselbe Änderung bewusst auf jedes sichere zukünftige Ziel an. Gruppen- und Einzelversionen unterscheiden sich.

Einen bestehenden Entwurf in Kanalbeiträge umwandeln

Lies einen integrationseigenen, noch nicht eingereichten Entwurf ohne Kanal und seine aktuelle Gruppenversion. Rufe promoteContentItemDraft mit einer nicht leeren posts als Liste an, um dasselbe Inhaltselement in unterschiedliche Kanalbeiträge umzuwandeln. Jeder Eintrag enthält seine eigene Kanal-ID, ausdrücklichen Text und optional Medien, native Optionen und einen Zeitplan. Quelltext und Anhänge bleiben gespeichert; fehlende Medien eines Eintrags werden nicht daraus übernommen.

mutation Promote($id: ID!, $version: String!, $key: String!,
    $posts: [ContentVariantInput!]!) {
  promoteContentItemDraft(id: $id, version: $version, requestKey: $key,
    posts: $posts) {
    contentItemId accepted published
    posts { id channelId text status isDraft publishingMethod
      manualReminder { state providerDeliveryConfirmed } dueAt version }
  }
}
# Each entry needs its channelId and explicit text, plus any media/options.
# Read the existing draft's ID/version first; do not mix posts and channelIds.

Verwende entweder kanalbezogene posts oder die bestehende gemeinsame channelIds Form. Kombiniere sie nicht miteinander und mische Eintragsoptionen nicht mit Planungsoptionen auf oberster Ebene. Ein fehlgeschlagenes Ziel speichert keine teilweise Umwandlung. Verwende für eine unveränderte Wiederholung denselben Anfrageschlüssel; ein eingereichter Entwurf kann nicht unter einem neuen Schlüssel erneut umgewandelt werden. Eine Prüfanfrage benötigt drafts:write und posts:review; automatisches Einreichen benötigt posts:publish. Native Teamfreigaberegeln gelten weiterhin. Einträge verwenden ContentVariantInput. Jeder Eintrag akzeptiert das nullable Feld aiAssisted: false bleibt false, null oder Weglassen lässt die Unterstützung unbekannt, und geänderter Eintragstext übernimmt niemals die Deklaration des ursprünglichen Entwurfs. Jedes Ziel kann ein Entwurf bleiben, automatisch veröffentlicht werden oder eine manuelle Erinnerung nutzen. Behalte contentItemId für das vollständige Bereinigen der Gruppe bei.

Automatische URL-Kürzung nach Workflow

Die Kürzung erfolgt vor dem endgültigen Speichern über die konfigurierten Connectoren des Autors. Einstellungen werden niemals stillschweigend deaktiviert. Die Unterstützung hängt von Workflow, Anhang und nativen Kanaloptionen ab; nicht unterstützte Kombinationen liefern einen Fehler mit Handlungshinweis.

Das grundlegende Textprofil umfasst Facebook, Bluesky, LinkedIn, Threads, Tumblr, Google Business Profile, Mastodon und WordPress. Bildprofile innerhalb nativer Limits umfassen auch Instagram und Pinterest; Videoprofile umfassen das nativ unterstützte YouTube/TikTok und andere validierte Dienste. Einheitliche geplante Umwandlungen und bestehende gespeicherte/native Übergänge haben separate validierte Optionskataloge; die obigen Regeln für gemischte Gruppen erlauben keine beliebigen Optionen. Ausdrücklich gespeicherte Datenschutz-/Zustimmungsangaben und die aktuelle native Validierung bleiben erforderlich. Speichern aktiviert niemals Arbeit, und Prüfung gewährt niemals Veröffentlichung. Lies allowedActions und aktuelle Versionen; ziehe ausstehende Prüfungen vor dem Löschen zurück, wenn diese Aktion angeboten wird. Die Annahme der Vorbereitung und die Kürzung bestätigen keine Netzwerkzustellung.

Ein Ziel vor dem Planen speichern

Setze saveToDraft: true bei einem Eintrag, um einen kanalgebundenen Entwurf zu speichern. Dies benötigt drafts:write, ohne Veröffentlichungsberechtigung oder erneute Veröffentlichungsanmeldung. Speichern allein erstellt weder einen Veröffentlichungszeitplan noch eine Smartphone-Erinnerung. Modus- und Datumswerte eines gespeicherten Eintrags planen ihn nicht und werden nicht zu wiederverwendbaren Planungsanweisungen; wähle einen neuen Modus und ein neues Datum, wenn du ihn später ausdrücklich planst. Null wird nicht akzeptiert für saveToDraft.

mutation SaveForChannel($key: String!, $channel: ID!, $text: String!) {
  createContentItemVariants(requestKey: $key, posts: [{
    channelId: $channel, text: $text, saveToDraft: true
  }]) {
    contentItemId accepted published
    posts { id channelId isDraft publishingMethod version }
  }
}

Lies die Ziel-ID und ihre neueste Version und verwende dann armDestinationDraft oder das benannte Tool arm_destination_draft zum Planen desselben Beitrags. Das benannte Tool nennt die ID postId. Wähle publishNow, schedule mit dueAt, addToQueue oder prioritize. Wenn du den Modus weglässt, wählt ein angegebenes Datum die Planung; andernfalls wird die Warteschlange verwendet. Automatische Veröffentlichung prüft aktuelle Veröffentlichungsberechtigung, Kanalzugriff, Medien, Freigabeanforderungen und Anmeldestatus erneut.

mutation ScheduleSavedDraft($id: ID!, $version: String!, $key: String!,
    $when: String!) {
  armDestinationDraft(id: $id, version: $version, requestKey: $key,
    mode: schedule, dueAt: $when) {
    id version deleted
  }
}
# Use the destination post ID and its latest version, not the group ID.
# Then read the post to check publishing state; this is not a delivery receipt.

Ein zukünftiges Ziel zum Entwurf zurücksetzen

Bei einem vom Eigentümer verwalteten automatischen Ziel, dessen Veröffentlichung noch nicht begonnen hat, kann updatePost(saveToDraft: true) mit derselben Ziel-ID, Quellgruppe und denselben Anhängen dessen einzelne zukünftige Planung deaktivieren. Gib die aktuelle Version und einen stabilen Anfrageschlüssel an und verfüge sowohl über Veröffentlichungs- als auch Entwurfsberechtigungen. Der Termin muss mehr als zwei Minuten entfernt sein. Setze es zuerst zurück und bearbeite dann den aktuellen Entwurf separat; Prüf-, Erinnerungs-, Thread- und bereits versuchte Veröffentlichungszustände behalten ihre eigenen Abläufe. Aktiviere den Entwurf ausdrücklich erneut, wenn er bereit ist.

Einen gespeicherten Entwurf prüfen

Kombiniere auf einem Kanal mit Freigabepflicht saveToDraft: true mit requestApproval: true. Dies benötigt Entwurfs- und Prüfberechtigungen. Der Entwurf bleibt nach der Freigabe inaktiv: Plane anschließend die unveränderte freigegebene Version ausdrücklich. Eine Bearbeitung erfordert eine neue Freigabe. Wenn du dagegen beim ausdrücklichen Planen eines automatischen Beitrags eine Prüfung anforderst, wird dieser Zeitplan bis zur Freigabe ausgesetzt.

Manuelle Veröffentlichung ausdrücklich wählen

Setze bei einem Eintrag publishingMethod: reminder für eine Veröffentlichung, die jemand auf seinem Smartphone abschließt. Ein gespeicherter Entwurf behält diese Auswahl bei, ohne ein Gerät zu benötigen. Wenn du ihn später planst, bleibt die gespeicherte Auswahl bei weggelassener Veröffentlichungsmethode erhalten; eine ausdrückliche Methode wählt diese erneut. Null wird nicht akzeptiert. Das Planen einer Erinnerung benötigt Entwurfs- und Veröffentlichungsberechtigungen, ein aktives angemeldetes Benachrichtigungsgerät und jede erforderliche Freigabe. publishNow stellt eine sofort fällige Erinnerung in die Warteschlange; es veröffentlicht nicht automatisch im Netzwerk.

Lies isDraft, publishingMethod und manualReminder.state gemeinsam. Ein Eintrag mit ausstehender gespeicherter Prüfung bleibt ein Entwurf, und eine gespeicherte Erinnerungsoption hat noch keine aktive Erinnerung. providerDeliveryConfirmed: false ist kein Beleg für eine Netzwerkzustellung. Gemischte Gruppen können gespeicherte, geplante und Erinnerungseinträge enthalten; ihre Aktionen pro Beitrag bleiben getrennt. Verwende edit_post mit draft: true zum Bearbeiten eines sicheren gespeicherten Ziels und das kanonische deleteContentItem oder delete_content_item zum Bereinigen der gesamten Gruppe. Ziehe ausstehende Prüfungen zuerst zurück. Eine beanspruchte oder unklare Veröffentlichung erfordert einen Abgleich statt blindes Löschen.

Benannte Tools für KI-Clients

get_publishing_configuration und get_channel zeigen die tatsächlichen Medien- und Zustimmungsanforderungen. Verwende list_content_items, get_content_item, create_content_item_draft, promote_content_item_draft und create_content_item_variants ohne selbst GraphQL zu schreiben. Tools zum Bearbeiten, Löschen und Zuordnen behalten dieselben Berechtigungs-, Versions- und Wiederholungsprüfungen.

Verwende deine gespeicherten Inhalte erneut.

Durchsuche, erstelle und bearbeite Vorlagen in deiner tatsächlichen SocialBlaze-Inhaltsbibliothek. Verwende Text-, Bild-, Video- und PDF-Vorlagen in Entwürfen erneut. Das Bearbeiten benötigt die aktuelle Version. Beim Entfernen einer Vorlage bleiben gemeinsam genutzte hochgeladene Dateien erhalten.

query {
  libraryItems(first: 20) {
    nodes { id title text description emoji visibility version assets { type url title altText } }
    pageInfo { endCursor hasNextPage }
  }
}

Nutze createDraftFromLibraryItem mit ID, Version, Anfrageschlüssel und ausgewählten Kanälen. Der Bibliothekszugriff folgt deinem aktuellen Tarif und deinen Teamberechtigungen.

Vorlagen akzeptieren eine optionale Beschreibung mit bis zu 1,000 Zeichen, Emoji mit bis zu 32 Zeichen und die Sichtbarkeit: internal für deinen Arbeitsbereich oder private für ihren Ersteller. Bestehende Vorlagen und eine weggelassene Sichtbarkeit bleiben intern. Nur der Ersteller kann eine gemeinsame Vorlage privat machen; private Vorlagen sind für andere Mitglieder in der API, nativen Bibliothek und bei mobilen Abfragen verborgen. Filtere libraryItems(visibility: private) oder internal. Es gibt keinen öffentlich kuratierten Vorlagenkatalog. Null löscht Beschreibung oder Emoji; weggelassene Felder bleiben bei Änderungen erhalten. Native Änderungen behalten diese Optionen bei.

Erstelle den Bericht, den du brauchst.

Ausdrückliche TikTok-Anbieterabfragen erfassen nur öffentliche Videos. enumerationComplete beschreibt diese Quellenerfassung; complete bleibt false, weil Fotos und private Videos ausgeschlossen sind. Lies basis und note in Berichten, aggregierten Referenzen und der Ranking-Abdeckung, bevor du Summen oder leere Ergebnisse interpretierst.

Gewöhnliche Kanalberichte, einzelne Beitragskennzahlen, Rankings und aggregierte Abfragen verwenden ausschließlich vorhandene SocialBlaze-Website-Daten und gespeicherte Momentaufnahmen. Eine Leseanfrage kontaktiert keinen Anbieter, plant keine Erfassung und aktualisiert keine fehlenden Daten. Verfügbare Kennzahlen unterscheiden sich nach Netzwerk; nicht verfügbare Werte bleiben unbekannt, niemals als Zahlenwert null.

query Report($channel: ID!, $start: String!, $end: String!, $report: ID,
    $first: Int = 20, $after: String) {
  channelReport(channelId: $channel, startDate: $start,
    endDate: $end, reportId: $report) {
    id state complete basis note enumerationComplete metricsUpdatedAt expiresAt errorCode
    metrics { key value status basis }
    posts(first: $first, after: $after) { nodes { externalId text publishedAt publicationDate publicationTimeBasis
      metrics { key value status } }
      pageInfo { endCursor hasNextPage } }
  }
}

Lies readMode, storedAnalytics und verfügbare gespeicherte Zeiträume, wenn kein normalisierter Bericht verfügbar ist. Native Abschnitte behalten ihre ursprünglichen Bezeichnungen und Messgrundlagen. Der Aktualisierungszeitstempel einer Zeile beweist nicht, dass jede Kennzahl zu diesem Zeitpunkt erfasst wurde. Fehlende Daten bleiben nicht verfügbar; der Ablauf eines Veröffentlichungstokens allein verhindert keinen autorisierten historischen Lesezugriff. Zeiträume bleiben durch die verfügbare Kontohistorie begrenzt. Prüfe complete, den Status jeder Kennzahl als status und ihre Grundlage als basis vor der Interpretation von Summen. Jeder Kanalbericht und jede aggregierte Referenz benennt seinen Netzwerkdienst. Das aggregierte Feld metricsUpdatedAt ist der neueste bekannte beitragende Zeitstempel; oldestMetricsUpdatedAt gibt den ältesten beitragenden Zeitpunkt an und bleibt null, wenn bei einer bereiten Quelle die Aktualität unbekannt ist.

Optionale LinkedIn-Videostatistiken enthalten pro Beitrag eindeutige viewers und totalTimeWatched in Minuten. Eindeutige Zuschauer werden niemals über Beiträge hinweg summiert. Instagram follows ist eine zugeordnete Anzahl für geeignete Feed-Beiträge und Stories, nicht für Reels oder das Netto-Followerwachstum. Diese Werte hängen von Anbieterzugriff und Verfügbarkeit ab; nicht verfügbare Werte bleiben null. Für Instagram wird keine Wiedergabezeit-Einheit abgeleitet.

Die Erfassung von LinkedIn-Berichten ist begrenzt. Wenn das Seitenlimit erreicht wird oder kein sicheres Fortfahren möglich ist, können nutzbare erfasste Zeilen mit teilweiser Abdeckung zurückgegeben werden. Ihre Summen beschreiben nur diese erfasste Teilmenge, niemals alle Beiträge des Kontos. Lies den Berichtshinweis und den Erfassungsstatus, bevor du Kanäle vergleichst.

Leistungszeilen können publicationDate und publicationTimeBasis getrennt von publishedAt anzeigen. Ein historischer nativer Kalendertag mit unbekannter Zeitzone behält publishedAt: null; erfinde keinen Veröffentlichungszeitpunkt um Mitternacht UTC. Halte einzelne Netzwerkbeiträge getrennt, statt Beiträge mit demselben Artikellink zusammenzufassen.

Gespeicherte Analyseabschnitte der Website lesen

Nutze storedChannelAnalytics oder das benannte MCP-Tool get_stored_channel_analytics mit analytics:read, einem autorisierten Kanal und genauen Start-/Enddaten. Jeder Abschnitt benennt Quelle, Verfügbarkeit und Datumsgrundlage. availableRanges listet gespeicherte Zeiträume auf; es ersetzt nicht die von dir angeforderten Daten durch einen davon. Ein nicht verfügbarer oder zu großer Rohabschnitt beweist nicht, dass keine Beiträge vorhanden sind; prüfe seinen Fehlercode und die paginierte channelReport als Projektion.

Bei TikTok, Pinterest, Tumblr und WordPress kann der Abschnitt report eine bereits gespeicherte ausdrückliche Erfassung anzeigen, gekennzeichnet als saved_developer_report. Das sind gespeicherte Berichtsdaten, kein Beleg dafür, dass eine native Website-Erfassung sie erzeugt hat. Ohne passenden gespeicherten Bericht sind sie nicht verfügbar; die Leseanfrage erfasst keinen. Ein Bericht kann bereit sein, während complete oder enumerationComplete false ist. Behalte beim Berichten der Ergebnisse die teilweise Abdeckung und nicht verfügbare Kennzahlen bei.

query StoredAnalytics($channel: ID!, $start: String!, $end: String!) {
  storedChannelAnalytics(channelId: $channel, startDate: $start, endDate: $end) {
    channelId service state complete basis note errorCode
    metricsUpdatedAt recordUpdatedAt freshness
    availableRanges { startDate endDate recordUpdatedAt }
    sections { name available source data rangeBasis startDate endDate
      metricsUpdatedAt recordUpdatedAt freshness errorCode note }
  }
}
# This reads saved data only. Use actual channel IDs and the requested dates.
# availableRanges does not silently replace a missing requested date range.

Behalte für die Paginierung normalisierter Berichte die zurückgegebene Berichts-ID, den Kanal und die Daten zusammen und übergib posts.pageInfo.endCursor als nächstes after. Beginne beim Wechsel von Momentaufnahmen ohne Cursor. Eine einzelne gespeicherte Beitragskennzahl und ein unvollständiger Kanalbericht können unterschiedliche Abdeckung haben; gib für jedes Ergebnis dessen eigenen Status und Grundlage an.

Neue Anbieterdaten nur auf Anfrage erfassen

Verwende ausdrücklich die Mutation refreshChannelReport oder das benannte MCP-Tool refresh_channel_report erst, wenn der Nutzer darum bittet, neue Anbieterdaten zu erfassen. Die Erfassung kann aktuelle Analyseberechtigungen beim Anbieter benötigen und verbraucht das separate Aktualisierungsbudget. Sie kann den Status queued zurückgeben; frage dieselbe zurückgegebene Berichts-ID und dieselben Daten mit channelReport ab. Gewöhnliche Leseanfragen melden sich niemals an, verbinden keine Konten erneut und starten diesen Vorgang nicht automatisch.

mutation CollectNewReport($channel: ID!, $start: String!, $end: String!) {
  refreshChannelReport(channelId: $channel, startDate: $start, endDate: $end) {
    id channelId state complete errorCode
  }
}
# Only run after an explicit request to collect new provider data.
# If queued, poll channelReport using the returned report ID and dates.

Gespeicherte Kennzahlen beim Lesen von Beiträgen einbeziehen

Setze includeMetrics: true bei post oder posts oder beim benannten MCP-Tool get_post und list_posts. Gib metricSnapshots mit einer Kanal-ID, Berichts-ID und passenden Start-/Enddaten für jeden Kanal an. Die Berechtigungen posts:read und analytics:read sind erforderlich. Dies liest nur bestehende Momentaufnahmen; es kontaktiert niemals ein Netzwerk und startet keine Berichtserfassung. Lies metricsState, metricsErrorCode, den Status und die Grundlage jeder Kennzahl sowie metricsUpdatedAt. Fehlende oder nicht verfügbare Kennzahlen bleiben null. Gespeicherte Historie kann veraltet sein; behalte die Veraltet- und Aktualitätsindikatoren des zugehörigen Berichts bei, statt sie als neu erfasst zu behandeln. Lasse die Option für gewöhnliche Beitragsabfragen weg; normale Auswahl- und Komplexitätslimits gelten.

Beim benannten MCP-Tool list_posts mit includeMetrics: true mit der vollständigen Standardauswahl und einer festgelegten Momentaufnahme liefert das Weglassen von first aktuell höchstens 18 Zeilen innerhalb des standardmäßigen Komplexitätslimits von 1,000 Punkten. Weitere Momentaufnahmen können diesen Standardwert senken. Ein ausdrücklich angegebenes first wird niemals stillschweigend reduziert: 19 vollständige Zeilen mit einer Momentaufnahme überschreiten dieses Limit. Gewöhnliche Beitragslisten verwenden weiterhin standardmäßig 20; eine Auswahl weniger Felder kann größere Seiten erlauben. Folge pageInfo.endCursor zur Fortsetzung der Abfrage, statt anzunehmen, dass eine Antwort jeden Beitrag enthält. Diese automatische Seitenanpassung gehört zum benannten Tool; eine ausdrückliche GraphQL-Abfrage muss eine zur Auswahl passende Seitengröße wählen.

query SavedPostMetrics($id: ID!, $pins: [PostMetricSnapshotInput!]!) {
  post(id: $id, includeMetrics: true, metricSnapshots: $pins) {
    id metricsState metricsErrorCode metricsUpdatedAt
    metrics { name value unit status basis comparisonBasis }
  }
}
# pins: [{channelId: YOUR_CHANNEL_ID, reportId: EXISTING_REPORT_ID,
#         startDate: MATCHING_START_DATE, endDate: MATCHING_END_DATE}]
# Supply these as JSON variables, using the snapshot's actual IDs and dates.

Lokale Veröffentlichungsdatensätze zählen

publishingActivity zählt aufbewahrte automatische Beitragsdatensätze nach dem ursprünglichen Erstellungsdatum in deiner gewählten Zeitzone. Jedes Ziel und jeder Thread-Eintrag zählt separat. Aggregierte Zählungen enthalten soft-gelöschte Datensätze, schließen Entwürfe und manuelle Erinnerungen aus und können endgültig gelöschte Datensätze oder reine Anbieterhistorie nicht wiederherstellen. Native Entwürfe können nach dem Einreichen ältere Erstellungsdaten behalten. Dies sind keine exakten historischen Einreichungs- oder Veröffentlichungsdaten; currentlyDelivered beschreibt den aktuellen Status dieser Datensätze. Halte die zurückgegebene Grundlage und den Hinweis sichtbar.

recordedCommitEvents zählt aufbewahrte native Versuche separat nach dem erfassten Bestätigungsdatum des Anbieters, unabhängig vom ursprünglichen Erstellungsdatum. Eine beabsichtigte erneute Veröffentlichung zählt erneut. Die Annahme kann vor Verarbeitung oder Zustellung erfolgen; dies sind daher keine Zustellzahlen. Halte commitEventBasis, commitEventCountUnit, commitEventNote und das auf false gesetzte Flag commitEventHistoryComplete sichtbar.

query {
  publishingActivity(startDate: "2026-09-01", endDate: "2026-09-30",
    timezone: "America/New_York") {
    count currentlyDelivered complete basis countUnit note
    recordedCommitEvents commitEventBasis commitEventCountUnit
    commitEventHistoryComplete commitEventNote
    channels { channelId service coverage count }
  }
}

Bekannte erfasste Veröffentlichungszeiten zählen

publishedActivity zählt aufbewahrte, aktuell zugestellte Zieldatensätze, deren geeignete nativ erfasste Zustellzeit in den angeforderten Kalenderzeitraum und die Zeitzone fällt. Es verwendet dieselben Zeitstempelregeln wie das nullable Feld post.publishedAt; Erstellungs-, Bearbeitungs-, Planungs- und Bestätigungsdaten ersetzen diese niemals. Jeder Netzwerkziel-/Thread-Datensatz zählt separat, einschließlich aggregierter soft-gelöschter Datensätze. Bewahre die Angaben zu rangeStartUtc, rangeEndUtcExclusive, basis, countUnit und complete: false. unknownTimeExcluded zählt alle ausgewählten aufbewahrten zugestellten Datensätze mit unbekannten Zeiten, nicht unbekannte diesem Monat zugeordnete Beiträge. Endgültig gelöschte, überschriebene und reine Anbieterhistorie bleiben außerhalb dieser Teilmenge bekannter Zeiten.

query {
  publishedActivity(startDate: "2026-09-01", endDate: "2026-09-30",
    timezone: "America/New_York") {
    count unknownTimeExcluded complete includesSoftDeleted
    rangeStartUtc rangeEndUtcExclusive basis countUnit unknownTimeExcludedBasis note
    channels { channelId service count unknownTimeExcluded coverage }
  }
}

Verwende das benannte MCP-Tool get_published_activity, Node publishedActivity oder CLI tools call get_published_activity. Dies liest lokale Datensätze ohne Anbietererfassung. Auf dem ursprünglichen Erstellungszeitpunkt basierende publishingActivity und bestätigungsbasierte recordedCommitEvents behalten ihre getrennten Bedeutungen.

Erfasste Leistung bewerten

rankedPosts benötigt eine ausdrückliche Kennzahl und entweder die Grundlage lifetime oder period_total als Grundlage. Unbekannte Werte und inkompatible Grundlagen werden ausgeschlossen; null als Zahlenwert bleibt ein echter Messwert. Die Abdeckung je Netzwerk unterscheidet vollständige, teilweise, wartende und nicht verfügbare Quellen. Verwende Berichts-IDs für stabile Vergleiche erneut. Jedes Ergebnis benennt seine Kennzahleneinheit; Interaktionsraten verwenden Prozenteinheiten und behalten ihre Vergleichsgrundlage. Unterschiedliche bekannte Ratenformeln werden nicht gemeinsam bewertet, und Raten werden niemals summiert. Die eindeutige LinkedIn-Reichweite wird nicht über Beiträge hinweg summiert. Facebook-Like-Reaktionen sind von Gesamtreaktionen getrennt, wenn der Anbieter sie zurückgibt; fehlende Werte bleiben null. Leistung beweist nicht, dass der Text das Ergebnis verursacht hat.

query {
  rankedPosts(startDate: "2026-09-01", endDate: "2026-09-30",
    metric: "reactions", metricBasis: "lifetime", first: 10) {
    state complete metric metricBasis note
    posts { channelId externalId text publishedAt publicationDate publicationTimeBasis value }
    channels { channelId service reportId coverage basis note enumerationComplete missingMetricPosts }
  }
}

Die benannten MCP-Tools sind get_publishing_activity und rank_posts. SDK-Methoden sind publishingActivity und rankPosts.

Mit OAuth verbinden.

Registriere einen öffentlichen PKCE-Client oder eine vertrauliche Server-App in der Konsole. Registriere exakte Callback-URLs, wähle Berechtigungsbereiche und gib die Datenschutz-URL deiner App an. Jeder Kunde wählt seine Kanäle und kann deine App trennen.

1. Erzeuge einen zufälligen Verifier und seine S256-Challenge. Bewahre einen zufälligen State-Wert auf, um den Callback zu verifizieren.
2. Öffne /api/developer/oauth/authorize mit Client-ID, registrierter Redirect-URI, Berechtigungsbereichen, State, Challenge, code_challenge_method=S256 und der angeforderten Ressource.
3. Tausche den zurückgegebenen Code bei /api/developer/oauth/token unter Angabe des ursprünglichen Verifiers und der Ressource aus. Vertrauliche Clients authentifizieren sich zusätzlich mit ihrem Geheimnis.
4. Speichere Zugangsdaten sicher. Zugriffstoken gelten eine Stunde; Aktualisierungstoken rotieren und laufen nach 30 Tagen ab. Verwende ein ersetztes Aktualisierungstoken niemals erneut.

Ressourcen sind https://backend.socialblaze.ai/api/developer oder die zugehörigen Endpunkte /graphql oder /mcp . Bestehende KI-Connector-Token verwenden eine separate Audience.

Mach dein Konto zugänglich.

Verwende eine benutzerdefinierte Remote-MCP-Verbindung in einem kompatiblen Assistenten oder Entwicklerclient. Der Endpunkt ist https://backend.socialblaze.ai/api/developer/mcp. Nutze die OAuth-Anmeldung, wenn dein Client sie unterstützt; dafür ist kein Entwicklerschlüssel erforderlich. Verwende einen Entwicklerschlüssel mit begrenzten Berechtigungen nur in Clients, die sichere Bearer-Authentifizierung unterstützen.

{
  "mcpServers": {
    "socialblaze": {
      "url": "https://backend.socialblaze.ai/api/developer/mcp",
      "headers": {"Authorization": "Bearer YOUR_DEVELOPER_KEY"}
    }
  }
}

Die Syntax der Client-Konfiguration variiert. Tools werden nach den gewährten Berechtigungsbereichen gefiltert. Verfügbare Tools umfassen Konto-/Kanalabfragen, Entwürfe, Veröffentlichung, Threads, Prüfung, Vorlagen und Berichte. Schemaressourcen und generische GraphQL-Tools verwenden dieselben Berechtigungen und Kontingente. Eine Auflistung hier bedeutet nicht, dass ein Connector im Marktplatz gelistet ist.

Diese Beispiele verwenden den Entwickler-MCP-Endpunkt und seinen aktuellen Toolkatalog mit begrenzten Berechtigungen. Eine interaktive SocialBlaze-Veröffentlichungsverbindung kann andere Tools und Kontoauswahlen bereitstellen. Wenn ein benanntes Tool fehlt, prüfe deine Verbindung und Berechtigungen; eine Veröffentlichungsverbindung bedeutet nicht automatisch Berichtszugriff.

Generische MCP-Anfrage- und Ergebnisformate

Übergib bei einem initialisierten MCP-Client das gezeigte Objekt {name, arguments} als Parameter von tools/call . execute_query benötigt eine wahrheitsgemäße summary mit höchstens 500 Zeichen und query; execute_mutation benötigt summary und mutation. Variablen und Operationsname sind optional. Die Kontoabfrage benötigt accounts:read; das Erstellen eines Entwurfs benötigt drafts:write.

{
  "name": "execute_query",
  "arguments": {
    "summary": "Read the connected account identifier.",
    "query": "query ConnectedAccount { account { id } }",
    "operationName": "ConnectedAccount"
  }
}

{
  "name": "execute_mutation",
  "arguments": {
    "summary": "Save an unpublished text draft.",
    "mutation": "mutation SaveDraft($key: String!) { createDraft(requestKey: $key, text: \"Draft for review\") { postId version published } }",
    "variables": {
      "key": "my-draft-001"
    },
    "operationName": "SaveDraft"
  }
}

MCP-Aufrufergebnisse können isError setzen und structuredContent.error oder Validierungsdetails bereitstellen; eine GraphQL-Antwort kann außerdem errors oder ein typisiertes MutationError enthalten. Rohes JSON-RPC enthält das Toolergebnis unter result und kann ein übergeordnetes error haben. Prüfe auch den zurückgegebenen Inhalt: HTTP 200 allein bedeutet keinen Erfolg.

Einen bestehenden Entwurf bearbeiten und anschließend lesen

Lies zuerst die aktuelle Entwurfs-ID und Version. Ersetze die Beispielplatzhalter durch tatsächliche Werte aus get_post ; übermittle die Platzhalter nicht unverändert. Die Bearbeitung eines eigenen Entwurfs verwendet edit_post mit draft: true, ausdrücklichen Text, einen stabilen Anfrageschlüssel und drafts:write. Lasse saveToDraft, mode und dueAt bei dieser Entwurfsbearbeitung weg. Sie liefert postId und version. Der Beitragseditor für zukünftige Planungen liefert dagegen id, version und deleted. Wähle nur Felder für diese Operation aus; lies Text und Medien separat über get_post mit posts:read.

{
  "name": "edit_post",
  "arguments": {
    "postId": "YOUR_DRAFT_ID",
    "version": "CURRENT_64_CHARACTER_VERSION",
    "requestKey": "my-draft-edit-001",
    "draft": true,
    "text": "Updated draft caption",
    "fields": "postId,version"
  }
}

{
  "name": "get_post",
  "arguments": {
    "postId": "YOUR_DRAFT_ID",
    "fields": "id,version,text,isDraft,assets.{type,url,altText}"
  }
}

Medien eines gespeicherten Entwurfs ersetzen

Lasse bei einem integrationseigenen, nicht eingereichten und ungeplanten Entwurf draft weg und setze saveToDraft: true. Gib seine aktuelle ID/Version, einen stabilen Anfrageschlüssel, drafts:write und Ersatzmedien an; lasse mode und dueAt weg. Kombiniere nicht draft: true mit saveToDraft: true. Dieser Beitragseditor-Endpunkt liefert id, version und deleted, nicht postId. Das LinkedIn-PDF-Beispiel ersetzt die Anhangsliste durch ein Dokument. Ersetze alle Platzhalter, einschließlich URL/Titel, und behalte deinen gewünschten Beitragstext bei. Lies den Beitrag erneut, um seine Medien und seinen Entwurfsstatus zu bestätigen. Diese Bearbeitung reicht den Entwurf weder ein noch plant oder veröffentlicht sie ihn.

{
  "name": "edit_post",
  "arguments": {
    "postId": "YOUR_OWNED_DRAFT_ID",
    "version": "CURRENT_64_CHARACTER_VERSION",
    "requestKey": "my-draft-media-edit-001",
    "saveToDraft": true,
    "text": "Current draft caption",
    "document": {
      "url": "https://YOUR_MEDIA_HOST/your-document.pdf",
      "title": "Your document title"
    },
    "fields": "id,version,deleted"
  }
}

n8n

Füge einen MCP-Client-Schritt hinzu, wähle HTTP Streamable und verwende https://backend.socialblaze.ai/api/developer/mcp. Wähle Bearer Auth und speichere deinen Schlüssel mit begrenzten Berechtigungen in einem n8n-Zugangsdatenobjekt. Wähle ein Tool und verwende dann JSON-Eingaben für verschachtelte Parameter. Beginne mit get_account oder einer Entwurfsmutation; behalte bei der Wiederholung eines Ereignisses denselben Anfrageschlüssel bei.

Zapier

Füge in deinen App-Verbindungen MCP Client by Zapier hinzu. Gib den obigen Endpunkt ein und wähle Streamable HTTP und OAuth. Melde dich bei SocialBlaze an, prüfe die angeforderten Berechtigungen und wähle Kanäle aus. Verwende ein rein lesendes Tool für Berichte oder Run Tool für eine autorisierte Entwurfsaktion. Aktiviere die Fehlerbehandlung und prüfe die zurückgegebenen strukturierten Daten, bevor du einen weiteren Schritt startest.

Einige Zapier-MCP-Client-Editoren senden Array-Text als Strings. channelIds benötigt ein echtes Array. Wenn der Editor es in einen String umwandelt, verwende execute_mutation mit einem einzelnen GraphQL-Mutationsstring, der das Literal channelIds: ["YOUR_CHANNEL_ID"] enthält. Beginne mit einem zukünftigen Termin, behalte seinen Anfrageschlüssel bei und prüfe Fehler, bevor du fortfährst.

Diese verwenden die generischen MCP-Clients der Plattformen. Client-Kontoverfügbarkeit und Anbietergebühren sind von den SocialBlaze-API-Limits getrennt.

Limits für deine Planung.

UTC-Zeitfenster werden über alle Schlüssel und autorisierten Apps gemeinsam genutzt. Mehr Schlüssel vervielfachen die Kontingente nicht. Berechnet werden nur die ausgewählte Operation und erreichbare Fragmente: eine Einheit je 25 Komplexitätspunkte, aufgerundet und mindestens eine, plus zwei für Mutationen. Antwortheader und MCP-Metadaten geben die berechneten Arbeitseinheiten und Kostengrundlage an. Dies ist eine anfängliche konservative Regelung; Anbieteraktualisierungen und Medien behalten separate Budgets. Zwischengespeicherte Leseanfragen verursachen weiterhin lokale Abfragearbeit. Website-Veröffentlichung und Netzwerk-/Anbieterlimits sind separat.

• 401: Zugangsdaten abgelaufen, widerrufen oder ungültig.
• 403: fehlender Berechtigungsbereich, Kanalzugriff oder fehlende Teamberechtigung.
• 409: veraltete Version, geänderte Wiederholungseingabe oder unsicherer Veröffentlichungsstatus.
• 422: prüfe die Validierungsdetails, einschließlich channels.ID.
• 429: folge Retry-After; verwende denselben Mutationsschlüssel erneut.

GraphQL kann Fehler mit HTTP 200 zurückgeben. Prüfe immer errors. Jede Mutation hat außerdem eine Variante mit try , beispielsweise tryCreateDraft, mit einem typisierten Erfolgswert result oder MutationError. Wähle __typename und beim Fehler die Felder code, httpStatus, message, fields und retryAfterSeconds. Ein typisierter Fehler kann in data mit HTTP 200 erscheinen; prüfe daher auch dieses Ergebnis.

MCP-Aufrufer müssen außerdem isError und structuredContent prüfen: Fehler können als GraphQL errors, als typisiertes MutationError, error oder validation in den Details auftreten, selbst wenn die Transportanfrage erfolgreich ist. Wenn verfügbar, enthält _meta enthält httpStatus, chargedWorkUnits, verbleibende Kontingente und retryAfterSeconds. Ein Client, der Metadaten ausblendet, beweist nicht, dass ein Aufruf kostenlos war. Behebe Berechtigungs- oder Validierungsfehler vor einer Wiederholung. Behalte bei einem Schreibvorgang mit unklarem Ergebnis den ursprünglichen Anfrageschlüssel und unveränderte Eingaben bei; lies den gespeicherten Beitragsstatus, statt eine weitere Veröffentlichung zu erstellen.

Dies sind Vorschau-Limits, keine Zusage, dass ein Anbieter dieselbe Menge erlaubt.

Beginne mit einem kleinen Workflow.

Einen n8n-Workflow importieren

Lade einen Workflow herunter, wähle Import from File in n8n, bearbeite seine Eingaben und verknüpfe dann deine eigenen Bearer-Auth-Zugangsdaten mit dem MCP-Client-Schritt. Jeder beginnt mit einem manuellen Auslöser und bleibt nach dem Import inaktiv. Schlüssel gehören in n8n-Zugangsdaten, niemals in das JSON.

• Vom Ereignis zum Entwurf / stabile Ereignis-ID für Wiederholungen; veröffentlicht niemals.
• Lokale Veröffentlichungsaktivität / ursprüngliche Datensatz-Erstellungsdaten mit ausdrücklichen Zählgrenzen.
• Ranking erfasster Beiträge / gewählte Kennzahl und Grundlage mit Abdeckung und festgelegten Berichten.

Mit n8n 2.43.5 importiert; MCP-Knotenaufrufe wurden gegen eine isolierte API-Testumgebung geprüft. Die gehostete Ausführung mit deinen eigenen Zugangsdaten ist eine separate Prüfung. Diese verwenden generische MCP-Clients und bedeuten weder eine im Marktplatz gelistete App noch eine veröffentlichte Zapier-Vorlage. Behalte die Autorisierung externer Nachrichten in deinem eigenen Workflow.

Lies das aktuelle Schema.

Die Referenz wird aus den implementierten GraphQL-Typen erzeugt. Authentifizierte Introspektion und der Explorer liefern den bereitgestellten Vertrag. SocialBlaze verwendet eigene Kennungen und ein eigenes Schema.

Gib deinem Programmierassistenten den KI-lesbaren API-Leitfaden für die richtigen Endpunkte, Berechtigungen, Versionen und Wiederholungsregeln.

Serverseitiger Node-Client

Das versionierte Paket enthält TypeScript-Deklarationen und einen Kommandozeilenclient. Installiere die heruntergeladene Datei mit npm install ./socialblaze-developer-client-0.1.14.tgz. Halte deinen Schlüssel in einer Server-Umgebungsvariablen.

Verwende benannte Beitrags- und Entwurfsbefehle, tools list, tools describe NAME, tools call NAME, schema describe TYPE und doctor. Übergib JSON direkt, aus einer Datei oder über stdin. --dry-run prüft grundlegende angegebene Eingaberegeln, ohne das Tool aufzurufen; die Toolermittlung verbraucht weiterhin Kontingent und bestätigt weder Anbietervalidierung noch Zustellung. Die CLI wiederholt Schreibvorgänge niemals automatisch.

Beitragsabfragen unterstützen die Filter postTypes und dueAtPresence für gespeicherte native Formate und das Vorhandensein eines geplanten Datums. Setze den Cursor zurück, wenn sich Filter ändern. Diese Filter aktivieren keine zusätzlichen Veröffentlichungsformate.

Das benannte Tool list_channels unterstützt Seiten mit 1–100 Einträgen, standardmäßig 20, mit afterId. Wähle für größere Seiten kleinere Feldmengen; normale Komplexitäts- und Arbeitskontingente gelten. Formatfilter umfassen zusätzlich Google Business event, offer und whats_new auf Grundlage gespeicherter nativer Metadaten. Diese überschneiden sich bewusst mit der gewöhnlichen Beitragskategorie und aktivieren keine neuen Veröffentlichungsformate.

Node getPost und contentItem liefern Medien-URLs, einschließlich statischer und animierter Vorschauen. Node listPosts behält seine kompakte Projektion ohne Medien bei; verwende eine Einzelabfrage oder eine ausdrückliche GraphQL-Auswahl. Node getPost enthält isDraft , behält jedoch eine kompakte Projektion ohne Veröffentlichungsmethode oder Status manueller Erinnerungen bei. Verwende das benannte Tool get_post oder eine ausdrückliche GraphQL-Abfrage für diese Felder; der generische Client und die CLI können die neuen Entwurfsoperationen ohne Änderungen am unveränderlichen SDK-Paket übertragen.

Antwortfelder auswählen

Benannte CLI-Aufrufe akzeptieren --fields 'id,text' und gleichrangige Gruppen wie --fields 'nodes.{id,text},pageInfo.endCursor'. Pfade beziehen sich auf das benannte Ergebnis. Der Server erstellt eine kleinere GraphQL-Auswahl und validiert sie vor der Ausführung. Die Berechnung berücksichtigt diese Auswahl. Behalte IDs und Versionen beim Nachverfolgen von Schreibvorgängen sowie Berichtsgrundlage, Hinweise und Abdeckung bei. all stellt die Standardauswahl des Tools wieder her, nicht jedes Schemafeld. Benannte MCP-Tools akzeptieren denselben String für fields . Metadaten zur Kanalpaginierung bleiben verfügbar, wenn die angezeigten Felder keine IDs enthalten. Generische Abfragebefehle verwenden ihr ausdrückliches Dokument.

CLI-Einrichtung und Agentenanleitung

socialblaze init schreibt lokale Standardwerte; config path und config get --all zeigen sie an. Zugangsdaten über Umgebungsvariablen werden empfohlen. Nur ein ausdrückliches init --save-token speichert ein Token in einer unverschlüsselten globalen Datei außerhalb des aktuellen Projekts. Repository-Konfiguration unterstützt nur Zeitzone und Timeout und kann weder Zugangsdaten bereitstellen noch deren Ursprung umleiten. Die Konfigurationsausgabe maskiert gespeicherte Schlüssel; lokales Entfernen widerruft den Serverschlüssel nicht.

context --list listet die mitgelieferten Agententhemen auf; context gibt den Skill und die Berichtsanleitung offline aus. completion bash, zsh, fish oder powershell gibt ein Skript zur Shell-Vervollständigung aus. Verwende socialblaze install claude oder install codex für eine ausdrückliche verwaltete Offline-Skill-Installation; uninstall claude oder uninstall codex macht eine unveränderte Installation rückgängig. Angepasste oder verknüpfte Ordner bleiben erhalten. Paketinstallation und init installieren keine Skills und ändern keine Shell-Profile. Vorschläge decken statische Befehlsgruppen ab. Version 0.1.5 korrigiert verschachtelte zsh-Vervollständigung. Statische Befehlsvorschläge werden in tatsächlichen Offline-Laufzeiten von bash, zsh ZLE und fish geprüft; die PowerShell-Ausgabe wird vom Parser geprüft. Diese Prüfungen führen keine Remote-Tools aus und autorisieren keine Veröffentlichung.

Lies den mitgelieferten Agenten-Skill. Er wahrt deine Autorisierung und unterscheidet lokale Datensatzzahlen, erfasste Rankings und unvollständige Anbieterhistorie. Lies für diese Workflows die verknüpfte Berichtsreferenz.

Brauchst du Hilfe bei einer bestimmten Anfrage? Sende eine E-Mail an [email protected] mit Operationsname, Status und sicherem Fehlercode. Gib niemals deinen Schlüssel, Aktualisierungstoken oder Zugangsdaten sozialer Netzwerke an.