ComposioHQ/Facebook-Automation

Facebook-Automatisierung

Automatisieren Sie Facebook-Seitenoperationen – Beiträge erstellen und planen, Videos hochladen, Messenger-Konversationen verwalten, Seiten-Einblicke abrufen und geplante Inhalte verwalten – alles orchestriert durch die Composio MCP-Integration.

Toolkit-Dokumentation: composio.dev/toolkits/facebook

---

Einrichtung

1. Verbinden Sie Ihr Facebook-Konto über den Composio MCP-Server unter https://rube.app/mcp
2. Der Agent fordert Sie mit einem Authentifizierungslink auf, falls keine aktive Verbindung besteht
3. Sobald verbunden, sind alle FACEBOOK_*-Tools für die Ausführung verfügbar
4. Hinweis: Dieses Toolkit unterstützt nur Facebook-Seiten, keine persönlichen Facebook-Konten

---

Kern-Workflows

1. Verwaltete Seiten ermitteln

Listen Sie alle Facebook-Seiten auf, die Sie verwalten, um Seiten-IDs und Zugriffstoken für nachfolgende Operationen zu erhalten.

Tool: FACEBOOK_LIST_MANAGED_PAGES

Parameter	Typ	Erforderlich	Beschreibung
fields	string	Nein	Kommagetrennte Felder (Standard: id,name,access_token,category,tasks,about,link,picture)
limit	integer	Nein	Max. Seiten pro Anfrage (Standard: 25)
user_id	string	Nein	Benutzer-ID (Standard: me)

Führen Sie dies immer zuerst aus, um page_id-Werte zwischenzuspeichern. Vermeiden Sie wiederholte Discovery-Aufrufe – cachen Sie die Ergebnisse.

---

2. Beiträge erstellen und planen

Veröffentlichen oder planen Sie Textbeiträge mit optionalen Links auf einer Facebook-Seite.

Tool: FACEBOOK_CREATE_POST

Parameter	Typ	Erforderlich	Beschreibung
page_id	string	Ja	Numerische Seiten-ID aus den verwalteten Seiten
message	string	Ja	Textinhalt des Beitrags
published	boolean	Nein	true für sofortige Veröffentlichung, false für Entwurf/geplant (Standard: true)
scheduled_publish_time	integer	Nein	Unix-UTC-Zeitstempel; muss mindestens 10 Minuten in der Zukunft liegen
link	string	Nein	URL, die in den Beitrag eingefügt werden soll
targeting	object	Nein	Zielgruppen-Spezifikationen

Bei Planung: Setzen Sie published=false und geben Sie scheduled_publish_time als Unix-UTC-Zeitstempel an.

---

3. Video-Beiträge erstellen und planen

Laden Sie Videoinhalte auf eine Facebook-Seite hoch und planen Sie sie.

Tool: FACEBOOK_CREATE_VIDEO_POST

Parameter	Typ	Erforderlich	Beschreibung
page_id	string	Ja	Numerische Seiten-ID
file_url	string	Bedingt	URL der Videodatei (geben Sie file_url oder video an)
video	object	Bedingt	Lokaler Datei-Upload mit name, mimetype, s3key
title	string	Nein	Videotitel
description	string	Nein	Videobeschreibung
published	boolean	Nein	Sofort veröffentlichen (Standard: true)
scheduled_publish_time	integer	Nein	Unix-Zeitstempel für geplante Veröffentlichung

---

4. Geplante Beiträge verwalten

Geplante Inhalte überprüfen, neu planen, aktualisieren oder veröffentlichen.

Tools:

• FACEBOOK_GET_SCHEDULED_POSTS – Geplante/unveröffentlichte Beiträge einer Seite auflisten
  • page_id (erforderlich), fields, limit (max. 100)
• FACEBOOK_RESCHEDULE_POST – Geplante Veröffentlichungszeit ändern
• FACEBOOK_UPDATE_POST – Bildunterschrift/Text eines bestehenden Beitrags bearbeiten
• FACEBOOK_PUBLISH_SCHEDULED_POST – Geplanten Beitrag sofort veröffentlichen

---

5. Seiten-Messenger-Konversationen lesen

Posteingangskonversationen und Nachrichtenthreads zwischen Benutzern und Ihrer Seite abrufen.

Tool: FACEBOOK_GET_PAGE_CONVERSATIONS

Parameter	Typ	Erforderlich	Beschreibung
page_id	string	Ja	Die Facebook-Seiten-ID
fields	string	Nein	Rückzugebende Felder (Standard: participants,updated_time,id)
limit	integer	Nein	Rückzugebende Konversationen, max. 25

Anschließend vollständige Nachrichtenthreads abrufen:

Tool: FACEBOOK_GET_CONVERSATION_MESSAGES

Parameter	Typ	Erforderlich	Beschreibung
page_id	string	Ja	Seiten-ID, der die Konversation gehört
conversation_id	string	Ja	Konversations-ID im Format t_ (z. B. t_3638640842939952)
fields	string	Nein	Standard: id,created_time,from,to,message
limit	integer	Nein	Rückzugebende Nachrichten, max. 25

---

6. Nachrichten senden und als gelesen markieren

Über Messenger auf Benutzer antworten und Nachrichten als gelesen markieren.

Tools:

• FACEBOOK_SEND_MESSAGE – Eine Textnachricht von der Seite an einen Benutzer über Messenger senden
• FACEBOOK_MARK_MESSAGE_SEEN – Eine Nachricht eines Benutzers als von der Seite gesehen markieren

Warnung: Beide Tools verursachen für den Benutzer sichtbare Seiteneffekte. Nur nach expliziter Bestätigung aufrufen.

---

Bekannte Fallstricke

Fallstrick	Details
Planung zu nah am aktuellen Zeitpunkt	FACEBOOK_CREATE_POST mit scheduled_publish_time weniger als ~10 Minuten in der Zukunft gibt HTTP 400 zurück – erzwingen Sie einen größeren Puffer für Bulk-Ausführungen
Unix-UTC-Zeitstempel erforderlich	scheduled_publish_time muss Unix-UTC sein – Zeitzonenumrechnungsfehler führen zu stundenversetzter Planung oder Validierungsfehlern
Cursor-basierte Paginierung	FACEBOOK_GET_SCHEDULED_POSTS und FACEBOOK_GET_PAGE_CONVERSATIONS geben Teilmengen zurück – folgen Sie Paging-Cursorn, um vollständige Daten zu erhalten
Große Konversations-Payloads	Das Anfordern eingebetteter Nachrichten in Konversationen erzeugt große Payloads – verwenden Sie stattdessen FACEBOOK_GET_CONVERSATION_MESSAGES für vollständige Threads
Verzögerungen bei der Videoverarbeitung	Hochgeladene Videos können im Verarbeitungszustand verbleiben – planen Sie nur über FACEBOOK_CREATE_VIDEO_POST, nachdem der Upload nutzbar ist
Seiten-IDs cachen	Wiederholte Aufrufe von FACEBOOK_LIST_MANAGED_PAGES erhöhen die Latenz – cachen Sie page_id pro Arbeitsbereich/Ausführung
Nur Seiten	Dieses Toolkit unterstützt keine persönlichen Facebook-Konten – nur Facebook-Seiten
Schreiboperationen benötigen Bestätigung	FACEBOOK_SEND_MESSAGE und FACEBOOK_MARK_MESSAGE_SEEN verursachen für den Benutzer sichtbare Seiteneffekte – nur nach expliziter Benutzerbestätigung aufrufen

---

Kurzreferenz

Tool-Name	Zweck
FACEBOOK_LIST_MANAGED_PAGES	Seiten auflisten, die Sie mit Zugriffstoken verwalten
FACEBOOK_GET_PAGE_DETAILS	Detailierte Informationen zu einer bestimmten Seite abrufen
FACEBOOK_CREATE_POST	Text-/Link-Beitrag erstellen oder planen
FACEBOOK_CREATE_VIDEO_POST	Video-Beitrag erstellen oder planen
FACEBOOK_GET_SCHEDULED_POSTS	Geplante/unveröffentlichte Beiträge auflisten
FACEBOOK_RESCHEDULE_POST	Geplante Veröffentlichungszeit ändern
FACEBOOK_UPDATE_POST	Bestehenden Beitrag bearbeiten
FACEBOOK_PUBLISH_SCHEDULED_POST	Geplanten Beitrag sofort veröffentlichen
FACEBOOK_UPLOAD_VIDEO	Videodatei auf eine Seite hochladen
FACEBOOK_GET_PAGE_CONVERSATIONS	Messenger-Posteingangskonversationen auflisten
FACEBOOK_GET_CONVERSATION_MESSAGES	Nachrichten aus einer Konversation abrufen
FACEBOOK_SEND_MESSAGE	Messenger-Nachricht von der Seite senden
FACEBOOK_MARK_MESSAGE_SEEN	Nachricht als gelesen markieren
FACEBOOK_GET_PAGE_POSTS	Beiträge aus einem Seiten-Feed abrufen
FACEBOOK_GET_USER_PAGES	Seiten mit Aufgaben und Token auflisten

---

Powered by Composio