1forh/sendcove

Verwenden von Sendcove

Sendcove ist ein Social-Media-Planer. Sein MCP-Server stellt Ihnen Werkzeuge zur Verwaltung der Beiträge, Medien, Analysen und der Inbox des Benutzers zur Verfügung. Wenn keine Sendcove-Tools verfügbar sind, teilen Sie dem Benutzer mit, Sendcove zu verbinden (Einrichtungsanleitungen: https://www.sendcove.app/features/mcp).

Beginnen Sie mit den Konten

1. Rufen Sie list_accounts auf, bevor Sie einen Beitrag erstellen oder ändern. Übergeben Sie die zurückgegebenen ids als accountIds; Sendcove ermittelt daraus die Plattformen.
2. Wenn der Benutzer mehrere Konten hat und nicht gesagt hat, welches verwendet werden soll, fragen Sie nach. Posten Sie nicht standardmäßig auf jedes Konto.
3. Ein Konto mit needsReconnect: true wird bei der Veröffentlichung fehlschlagen. Sagen Sie dem Benutzer, dass er es in Sendcove erneut verbinden muss.

Beiträge erstellen

• create_post erstellt einen Entwurf, es sei denn, Sie setzen status. Entwürfe sind die sichere Standardeinstellung: Erstellen Sie einen, zeigen Sie dem Benutzer, was Sie erstellt haben, und lassen Sie ihn den Beitrag planen oder veröffentlichen.
• content ist der Standardtext für jede Plattform. Verwenden Sie platformContent, um einer Plattform einen eigenen Text zu geben, z. B. eine 280-Zeichen-Version für twitter und eine längere Bildunterschrift für instagram. Schlüssel: twitter, instagram, tiktok, threads, bluesky, facebook, linkedin (Zeichenketten) und youtube ({ title, description }).
• Plattformspezifische Optionen (Instagram-Beitragstyp, YouTube-Videotyp und -Sichtbarkeit, TikTok-Datenschutz, Bluesky-Antworteinstellungen, X-Community usw.) werden in platformSettings eingetragen. Entnehmen Sie die zulässigen Felder und Werte dem Eingabeschema des Tools und seinen Beschreibungen, anstatt zu raten. Rufen Sie vor dem Setzen von platformSettings.tiktok get_tiktok_creator_info auf, um die Datenschutzebenen und Interaktionen zu erfahren, die dieses Konto erlaubt.
• Zeichenbeschränkungen werden bei der Veröffentlichung des Beitrags überprüft: X 280, Bluesky 300, Threads 500, Instagram und TikTok 2200, LinkedIn 3000, YouTube-Titel 100 und Beschreibung 5000. Halten Sie den Text jeder Plattform innerhalb seines Limits (verwenden Sie platformContent), damit der Beitrag später nicht fehlschlägt.
• Instagram- und TikTok-Beiträge benötigen Medien; YouTube benötigt ein Video.
• Threads: Übergeben Sie Folgebeiträge als threadItems (jedes { content, mediaUrls? }). Sie werden als Thread auf X, Bluesky und Threads (Pro und Max) veröffentlicht; andere Plattformen erhalten nur content. Mit update_post und threadItems: [] wird das Verketten beendet.
• Hashtags: list_hashtag_sets gibt die gespeicherten Sets des Benutzers zurück (gespeichert ohne #).
• Übergeben Sie einen idempotencyKey (eine eindeutige Zeichenkette, 8 bis 200 Zeichen) an create_post, duplicate_post und reply_to_inbox_item. Wenn ein Aufruf ausfällt oder Sie sich nicht sicher sind, ob er durchgegangen ist, wiederholen Sie ihn mit dem gleichen Schlüssel: Sie erhalten das erste Ergebnis anstelle eines doppelten Beitrags oder einer Antwort.
• update_post ändert nur die Felder, die Sie übergeben, aber platformContent, platformSettings und threadItems ersetzen jeweils den gesamten gespeicherten Wert. Rufen Sie zuerst get_post auf und senden Sie das vollständige Objekt.

Medien

• Medien müssen sich in der Sendcove-Medienbibliothek des Benutzers befinden, bevor sie in mediaUrls verwendet werden können. list_media zeigt, was bereits vorhanden ist.
• Eine öffentliche HTTPS-URL: upload_media_from_url, dann verwenden Sie die zurückgegebene url.
• Eine lokale Datei: Rufen Sie create_media_upload_url auf und führen Sie den zurückgegebenen curl-Befehl mit dem tatsächlichen Dateipfad aus (z. B. curl -s -X POST '<uploadUrl>' -F 'file=@/path/to/photo.jpg'). Die JSON-Antwort enthält die zu verwendende url. Die Upload-URL ist 10 Minuten gültig und benötigt keinen API-Schlüssel. Bei Dateien über 4 MB übergeben Sie contentType und führen Sie die beiden zurückgegebenen Befehle (PUT an den Speicher, dann den finalisierenden POST) in dieser Reihenfolge aus. Fügen Sie -F convertForInstagram=true hinzu, um ein Bild für Instagram in JPEG zu konvertieren.
• Erlaubte Typen: JPEG, PNG, GIF, WebP, MP4, MOV, AVI.

Planen und Veröffentlichen

Planen, veröffentlichen oder antworten Sie nur, wenn der Benutzer in diesem Gespräch danach gefragt hat. Einen Beitrag zu schreiben ist keine Erlaubnis, ihn zu veröffentlichen.

• Planen: status: "scheduled" mit scheduledFor als ISO 8601 mit Offset (2026-11-20T15:00:00Z). Konvertieren Sie die Ortszeit des Benutzers und bestätigen Sie die Zeitzone, falls sie unklar ist. Oder übergeben Sie nextOpenSlot: true, um den nächsten freien Posting-Zeitpunkt zu verwenden, den der Benutzer für diese Konten festgelegt hat.
• Jetzt veröffentlichen: status: "pending" bei create_post, oder publish_post für einen vorhandenen Beitrag.
• Rufen Sie nach dem Veröffentlichen get_post auf: Jedes Konto hat seinen eigenen status (published, failed, pending) und error. Ein fehlgeschlagener Beitrag bedeutet normalerweise, dass ein Konto fehlgeschlagen ist. publish_post für diesen Beitrag wiederholt nur die fehlgeschlagenen Konten; es postet nie erneut, wo es bereits live ist.
• delete_post kann nicht rückgängig gemacht werden. Bestätigen Sie vor dem Löschen.

Nur-Entwurf-Verbindungen (403)

Planen, Veröffentlichen und Antworten erfordern einen Pro- oder Max-Tarif und eine Verbindung, die das Veröffentlichen erlaubt. Beim Basic-Tarif oder bei einem API-Schlüssel oder einer verbundenen App, die auf Nur-Entwurf gesetzt sind, geben diese Aufrufe 403 "Dieser API-Schlüssel oder diese verbundene App kann nur Entwürfe erstellen" zurück.

Wenn dies passiert, wiederholen Sie es nicht und umgehen Sie es nicht. Speichern Sie den Beitrag als Entwurf und teilen Sie dem Benutzer mit:

Ich habe dies als Entwurf in Sendcove gespeichert. Diese Verbindung ist nur für Entwürfe gedacht, daher kann ich es nicht planen oder veröffentlichen. Damit ich veröffentlichen kann, benötigen Sie einen Pro- oder Max-Tarif. Verbinden Sie Sendcove dann hier erneut und wählen Sie "Veröffentlichung erlauben" (oder verwenden Sie einen API-Schlüssel, der mit aktivierter "Veröffentlichung erlauben" unter Konto > API-Schlüssel in Sendcove erstellt wurde). Sie können den Entwurf auch selbst in Sendcove planen.

Analysen und Inbox

• get_engagement: Gesamtsummen, Aufschlüsselung nach Plattform, Top-Beiträge und die besten aktuellen Beiträge jedes Kontos im Vergleich zu seinem eigenen Median (timesMedian zeigt, wie viel besser ein Beitrag abgeschnitten hat, nicht warum).
• get_post_analytics: Metriken eines veröffentlichten Beitrags pro Konto; übergeben Sie refresh: true für aktuelle Zahlen (eine Stunde zwischengespeichert). Nicht jede Plattform meldet jede Metrik.
• get_best_times: Beste Tage und Stunden zum Posten, basierend auf dem eigenen Engagement des Benutzers.
• list_inbox / get_inbox_item: Antworten, Erwähnungen und Kommentare. reply_to_inbox_item postet eine öffentliche Antwort, zeigen Sie dem Benutzer daher den Text und holen Sie zuerst ein Ja ein. update_inbox_item markiert Elemente als gelesen, ungelesen oder archiviert.