social-mcp
social-mcp
Steuern Sie die Meta-Produktfamilie (Facebook, Instagram, Threads) direkt mit Chrome-Cookies. Läuft vollständig lokal, benötigt keine Drittanbieter-API-Token und keine OAuth-Weiterleitungen.
Funktionen
Tool | Beschreibung |
| Überprüft, ob die Chrome-Cookies gültig sind |
| Liest die neuesten Nachrichten aus dem Messenger-Posteingang |
| Sendet eine private Messenger-Nachricht |
| Erstellt einen Textbeitrag auf einer Facebook-Fanpage |
| Erstellt einen Instagram-Beitrag (erfordert IG Business) |
| Erstellt einen Threads-Textbeitrag (erfordert IG Business) |
| Ruft Informationen zur Fanpage ab (Name, Follower-Anzahl) |
Related MCP server: Facebook Messenger MCP Bridge
Funktionsweise
你的 Chrome(已登入 Facebook)
↓ CDP (Chrome DevTools Protocol)
social-mcp 讀取 cookies
↓
直接 call Facebook Graph API(用 cookie session)
↓
完成發帖 / 讀取收件箱 / 發 IG / 發 ThreadsKerninnovation: Kein Facebook Developer App erforderlich, kein PAGE_ACCESS_TOKEN nötig, nutzt direkt Ihren echten Anmeldestatus aus Chrome.
Voraussetzungen
Python 3.11+
Chrome oder Chromium (bei Facebook angemeldet)
macOS / Linux
Empfohlen: AIpuss-browser Daemon aktiviert (social-mcp erkennt und verwendet die CDP-Verbindung automatisch)
Installation
# clone 並進入目錄
git clone https://github.com/whypuss/social-mcp.git
cd social-mcp
# 用 uv 安裝(推薦)
uv sync
# 或用 pip
pip install -e .Konfiguration
1. Verwendung von Legacy-Cookies in Chrome erlauben (erforderlich)
Facebook blockiert standardmäßig „Apps, die Legacy-Cookies verwenden“. Dies muss manuell aktiviert werden:
Öffnen Sie die Facebook-Webseite, klicken Sie oben rechts auf Ihr Profilbild →
Einstellungen und Privatsphäre→EinstellungenLinkes Menü →
Sicherheit und LoginScrollen Sie nach unten und suchen Sie nach „Apps erlauben, die Legacy-Cookies verwenden“
Auf „Ein“ stellen
Wenn diese Option nicht vorhanden ist, bedeutet dies, dass Ihr Konto dies standardmäßig erlaubt. Fahren Sie mit dem nächsten Schritt fort.
2. Umgebungsvariablen festlegen (optional)
# .env 檔(放在 social-mcp/ 目錄下)
cp .env.example .env
nano .env# Facebook 粉絲頁 ID(可從粉絲頁網址取得)
# 例如:https://www.facebook.com/MyPage → FACEBOOK_PAGE_ID=MyPage
FACEBOOK_PAGE_ID=你的頁面ID
# Instagram Business 帳號 ID(從 Meta Business Suite 取得)
IG_USER_ID=你的IG帳號數字ID3. Sicherstellen, dass Chrome angemeldet ist
Stellen Sie sicher, dass Ihr Chrome-Profil 3 (Name MY) bei Facebook und Instagram angemeldet ist.
Wenn Sie den AIpuss-browser Daemon verwenden, liest dieser standardmäßig dieses Profil.
Verwendung
MCP-Server starten
# 基本啟動
uv run social-mcp
# 除錯模式(看完整日誌)
uv run social-mcp --debugMit Claude Desktop verbinden
Fügen Sie dies in ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:
{
"mcpServers": {
"social": {
"command": "uv",
"args": ["run", "--project", "/路徑/到/social-mcp", "social-mcp"]
}
}
}Starten Sie Claude Desktop neu, um alle oben genannten Tools im Chat zu verwenden.
Mit Hermes Agent verbinden
Fügen Sie es im mcp-Block in ~/.hermes/config.yaml hinzu oder verwenden Sie direkt:
hermes tools enable socialAnwendungsbeispiele für Tools
你:幫我發一篇 Facebook 帖:「測試成功!」
Agent → post_facebook(message="測試成功!")
→ ✅ 成功!URL: https://www.facebook.com/123456789
你:讀取最新的 Messenger 訊息
Agent → get_messenger_inbox(limit=5)
→ ## Messenger 收件箱(5筆)
1. [2026-04-24 10:00] 王小明:明天開會嗎?
2. [2026-04-24 09:45] 李小美:收到了,謝謝!
你:回覆王大明(ID: 100001234567890)說「好的,明天見」
Agent → send_messenger(thread_id="100001234567890", message="好的,明天見")
→ ✅ 訊息已發送Über die AIpuss-browser Integration
social-mcp erkennt den AIpuss-browser Daemon automatisch:
Liest
~/.agent-browser/default.stream, um die CDP-WebSocket-URL zu erhaltenVerbindet sich über WebSocket mit der Chrome-Sitzung von AIpuss
Liest Cookies direkt über CDP (umgeht die Einschränkungen von
document.cookieim Headless-Modus)
Vorteile:
Der Chrome-Browser von AIpuss enthält bereits Ihren Anmeldestatus, es muss kein zusätzlicher Browser geöffnet werden
Läuft vollständig lokal, Cookies werden nicht an Drittanbieter-Server gesendet
Falls der AIpuss-Daemon nicht läuft, wird automatisch auf einen eigenständigen Chrome-Browser zurückgegriffen
Sicherheitshinweise
Cookies bleiben immer lokal:
social-mcpläuft nur auf Ihrem eigenen Rechner, Cookies werden nicht an Dritte übertragenKeine Speicherung sensibler Daten: Cookies existieren nur im Arbeitsspeicher und verschwinden nach Beendigung des Programms
Empfehlung: Verwenden Sie ein dediziertes Chrome-Profil anstelle Ihres Hauptprofils
Einschränkungen und bekannte Probleme
Problem | Beschreibung |
Facebook erkennt Headless | Einige Facebook-Seiten laden im Headless-Modus nicht vollständig, Cookies können jedoch weiterhin normal gelesen werden |
IG Business-Konto erforderlich | Die Posting-Funktionen für IG / Threads erfordern die Umstellung eines persönlichen Kontos auf ein Business-Konto |
Token-Gültigkeit | Die Chrome-Cookie-Sitzung kann ablaufen; nach längerer Nutzung ist eine erneute Anmeldung im Browser erforderlich |
macOS Schlüsselbund-Zugriff | Chrome-Cookies sind standardmäßig verschlüsselt. Wenn die automatische Entschlüsselung fehlschlägt, stellen Sie sicher, dass Sie bei Ihrem macOS-Konto angemeldet sind |
Entwicklung
# 安裝開發依賴
uv sync --extra dev
# 程式碼檢查
uv run ruff check social_mcp/
# 單元測試
uv run pytestLizenz
MIT License
Hinweis: Dieses Tool ist nur für den persönlichen Automatisierungsgebrauch bestimmt. Massenhafte oder automatisierte Aktionen auf Facebook/IG können gegen die Nutzungsbedingungen von Meta verstoßen. Bitte bewerten Sie die Risiken selbst.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Instagram MCP for DM and comment automation, AI Agent and content publishing via Meta's official API
Publish, reply, moderate, search and read insights on your Threads (threads.com) account.
Social media API for AI agents: publish, DMs, comments, Meta ads and leads.
Agent social posting via your logged-in Chrome. Remote MCP + OAuth. Not clawpost.dev.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI assistants to manage Instagram and Threads accounts — publish content, handle comments, view insights, search hashtags, and manage DMs through the Meta Graph API.5994 npm14MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI clients to read and send Facebook Messenger messages by using a Chrome extension to bypass anti-bot protections, providing tools like fb_list_conversations, fb_read_messages, and fb_send_message.-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to publish, edit, delete, comment on, and analyze posts across LinkedIn, Facebook Pages, and Instagram professional accounts, including cross-posting and local scheduling. Runs locally with user-supplied credentials and no third-party token routing.38 npm1MIT
- FlicenseNot gradedqualityAmaintenanceEnables sending and managing Instagram Direct Messages from your account, including text, photo, and video messages, listing and searching chats, and downloading direct-uploaded or shared media. It also provides tools for looking up users, stories, followers, following, and posts, plus liking media.-