Social Broadcast MCP

Open-Source-MCP-Server (MIT) zum Veröffentlichen in sozialen Netzwerken (Facebook, Instagram, YouTube) über die offiziellen APIs der jeweiligen Plattform, mit deinen eigenen OAuth-Zugangsdaten.

Kein zentraler Dienst. Keine Tarife. Keine künstlichen Grenzen. Keine Zahlungsmittler.

Warum gibt es das?

Die SaaS-Tools (SocialCannon, PostFast, Buffer...) verlangen ein monatliches Abonnement und setzen Grenzen (Konten, Beiträge, Medien-Uploads). Dieses Projekt tut dasselbe – aus einem KI-Agenten (Hermes, Claude, etc.) heraus veröffentlichen – aber jeder Nutzer verbindet seine eigenen Konten mit seinen eigenen Entwickler-Apps. Für immer kostenlos.

⚠️ Der wichtigste Unterschied zu den SaaS-Tools: die haben bereits von Meta/Google freigeschaltete Apps mit vollständiger Prüfung. Hier erstellst du deine App (kostenlos) und nutzt sie für deine eigenen Konten. Das ist für persönliche Nutzung/ein eigenes Geschäft zulässig und umgeht das App Review von Meta, das nur für den öffentlichen Zugriff auf Konten Dritter verlangt wird.

Related MCP server: @posteverywhere/mcp

Plattformen

Installation

git clone https://github.com/tu-usuario/social-broadcast-mcp.git
cd social-broadcast-mcp
npm install
npm run build

Einrichtung in Hermes (oder jedem anderen MCP-Client)

# ~/.hermes/config.yaml (o config del perfil)
mcp_servers:
  social-broadcast:
    command: "node"
    args: ["/ruta/a/social-broadcast-mcp/dist/index.js"]

Oder in einem beliebigen kompatiblen MCP-Client:

{
  "mcpServers": {
    "social-broadcast": {
      "command": "node",
      "args": ["/ruta/a/social-broadcast-mcp/dist/index.js"]
    }
  }
}

Verwendung

1. Facebook + Instagram verbinden

Du musst eine App auf developers.facebook.com erstellen (siehe docs/SETUP_META.md) und Folgendes erhalten:

• App ID (clientId)

• App Secret (clientSecret, nur im Entwicklungsmodus erforderlich)

Anschließend über den Agenten:

connect_meta(clientId: "TU_APP_ID", clientSecret: "TU_APP_SECRET")

Der Browser öffnet sich → du autorisierst mit deinem Konto → die Konten werden lokal in ~/.social-broadcast-mcp/ gespeichert.

2. YouTube verbinden

Erstelle ein Projekt in Google Cloud Console mit YouTube Data API v3 (siehe docs/SETUP_YOUTUBE.md):

connect_youtube(clientId: "TU_CLIENT_ID", clientSecret: "TU_CLIENT_SECRET")

3. Verbundene Konten anzeigen

list_accounts()

4. Veröffentlichen

publish_post(
  accountId: "fb:533433607139839",
  content: "🌀 CREA TU PROPIO GONG 🌀\nUn gong hecho por ti, para ti, como tú.",
  mediaUrls: ["https://tudominio.com/imagen.jpg"],
  platformOptions: { "mediaType": "REELS" }  // para Reels de IG
)

Um einen späteren Zeitpunkt zu planen statt sofort zu veröffentlichen, füge scheduledAt: "2026-09-01T18:00:00+01:00" hinzu.

Hinweis zu Medien: Die API akzeptiert öffentliche URLs. Um lokale Dateien zu übertragen, hoste sie an einem erreichbaren Ort (ein S3/GCS-Bucket, deine Website oder ein offener lokaler Server) und übergib deren URL. Ein Helfer für direkte Uploads befindet sich auf der Roadmap.

Dokumentation

• docs/SETUP_META.md – Meta-App ist eine Schritt-für-Schritt-Anleitung

• docs/SETUP_YOUTUBE.md – Google-Cloud-Projekt + OAuth

• docs/TIKTOK.md – Wie die TikTok-Integration aussehen würde (Audit erforderlich)

• docs/SECURITY.md – Lokale Token-Verwaltung und bewährte Sicherheitsstandards

Sicherheit

• Die Tokens werden lokal in meiner ~/.social-broadcast-mcp/ mit Berechtigungen 0600 gespeichert.

• Sie werden niemals an einen externen Server übermittelt.

• Keine Telemetrie. Keine Analysedaten. Nichts, das nach Hause telefoniert.

• Wirf einen Blick in src/auth/store.ts, um genau zu sehen, was gespeichert wird.

Lizenz

MIT – du darfst frei verwenden, kopieren, identisch und weiterverbreiten. Für die Gemeinschaft gedacht, ausgehend von der praktischen Erfahrung bei der Veröffentlichung des Kalenders des Templo del Gong (Vilagarcía de Arosa).

Haftungsausschluss

Dieses Projekt steht in keinem Zusammenhang mit Meta, Google, TikTok oder X Corp. Das Urheberrecht an den Marken liegt bei ihren jeweiligen Inhabern. Die Nutzung der APIs unterliegt den Nutzungsbedingungen der jeweiligen Plattform.