API Tutorial
So planst du Bluesky-Beiträge per API
Um Bluesky-Beiträge per API zu planen, verbinde Bluesky über Modiva und rufe dann `posts_schedule` mit deinem Inhalt und einem `publish_at`-Zeitstempel auf — Modiva stellt ihn in die Warteschlange und veröffentlicht ihn automatisch zu diesem Zeitpunkt auf Bluesky.
Planen bedeutet, einen Beitrag zu speichern und ihn später zuverlässig zu veröffentlichen — etwas, das die API von Bluesky ganz dir überlässt. Modiva betreibt die Warteschlange, wiederholt bei vorübergehenden Bluesky-Fehlern und stellt ein einziges `posts_schedule`-Tool bereit, das auf jeder Plattform identisch funktioniert.
Schritt für Schritt
Modiva-Konto und MCP-Schlüssel erstellen
Registriere dich kostenlos und generiere im Dashboard einen MCP-Schlüssel (`mk_live_…`). Derselbe Schlüssel authentifiziert sowohl den gehosteten MCP-Server (für KI-Agenten) als auch die REST-API (für dein Backend), sodass du nur eine Zugangsberechtigung verwaltest.
Dein Bluesky-Konto verbinden
Klicke im Dashboard auf Verbinden und wähle Bluesky. Modiva führt den OAuth-Flow aus und fordert die passenden Scopes für dich an, speichert die Access- + Refresh-Tokens dann in einem verschlüsselten Tresor und hält sie aktuell — du hantierst nie mit den rohen API-Zugangsdaten von Bluesky. Die Verbindung erhält eine stabile `connectionId`, auf die du in jedem Aufruf verweist.
posts_schedule mit einer publish_at-Zeit aufrufen
Rufe `posts_schedule` mit der Connection-ID, deinem Inhalt und einem ISO-`publish_at`-Zeitstempel auf. Modiva speichert den Job und veröffentlicht zu diesem Zeitpunkt auf Bluesky, wobei Token-Refresh und Wiederholungen ohne eigenen Cron übernommen werden.
Den besten Zeitpunkt finden und einen Kalender bündeln
Rufe `analytics_best_time_to_post` auf, um einen Slot zu wählen, und plane dann eine ganze Woche in einer Schleife. Über MCP kann ein KI-Agent einen vollständigen Bluesky-Content-Kalender aus einem einzigen Prompt planen und einreihen.
Beispielanfrage
Rufe das Tool posts_schedule über die REST-API von Modiva auf. Dasselbe Tool steht KI-Agenten über den MCP-Server unter https://mcp.modiva.ai/v1 zur Verfügung.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_schedule",
"connectionId": "conn_…",
"args": { "text": "Weekly roundup is live", "publish_at": "2026-07-01T15:00:00Z" }
}'Mit Bluesky ausprobieren
Kostenlos startenFAQ
Betreibt Modiva den Scheduler oder ich?
Modiva. Sobald du `posts_schedule` aufrufst, speichert Modiva den Job und veröffentlicht zur gewünschten Zeit auf Bluesky — du brauchst keine eigene Warteschlange und keinen Cron.
Kann ich denselben Beitrag für mehrere Plattformen planen?
Ja — übergib mehrere Connection-IDs (oder nutze `posts_cross_post`) und Modiva plant den Beitrag für Bluesky und jede andere Plattform, jeweils an das Format angepasst.