SocialAPIs — Facebook & Instagram Data
offiziellFacebook- und Instagram-Daten für KI-Agenten — Seiten, Beiträge, Gruppen, Anzeigenbibliothek, Marketplace, Profile und Reels. 47 schreibgeschützte Tools, strukturierte Ausgabe. Kostenlose Stufe: 200 Aufrufe/Monat.
Was kann man mit SocialAPIs — Facebook & Instagram Data MCP machen?
- Facebook-Seiten- und Gruppendaten — Rufe Seiten- oder Gruppendetails, Beiträge, Videos, Reels und Fotoalben über einen Link oder eine ID ab.
- Facebook-Beiträge und Kommentare suchen — Rufe Beitragsdetails, Anhänge, Kommentare und Kommentarantworten über einen Beitragslink ab.
- Meta Ads Library durchsuchen — Suche nach Anzeigen anhand von Stichwörtern oder Werbetreibenden, rufe Seitendetails von Werbetreibenden ab und liste unterstützte Länder auf.
- Instagram-Profil- und Beitragsdaten — Rufe Profildetails, Beiträge, Reels, Highlights und vollständige Beitragsdetails anhand eines Benutzernamens oder Shortcodes ab.
- Instagram-Suche und Standorte — Suche anhand von Stichwörtern nach Nutzern, Hashtags und Orten oder liste Beiträge auf, die an einem Standort markiert wurden.
- Facebook Marketplace durchsuchen — Suche mit Filtern nach Angeboten, Fahrzeugen und Mietobjekten und rufe Angebots- oder Verkäuferdetails ab.
Gehosteter MCP-Server
npx add-mcp 'https://mcp.socialapis.io/mcp'Installiert in Claude Code, Codex, Cursor und mehr
Dokumentation
Gib KI-Assistenten direkten Zugriff auf öffentliche Facebook- und Instagram-Daten mit dem Model Context Protocol (MCP)-Server von SocialAPIs.
Der Server stellt 12 schreibgeschützte Tools für 50 Aktionen bereit: Seiten, Beiträge, Kommentare, Gruppen, die Meta Ads Library, Marketplace, Instagram-Profile, Beiträge, Reels und Standorte. Jedes Tool deckt eine Ressource ab und erwartet ein Argument action. Jeder Aufruf gibt strukturierte Ergebnisse zurück, einschließlich der berechneten und der verbleibenden Credits.
1. API-Schlüssel abrufen
Registriere dich bei socialapis.io und kopiere deinen Schlüssel aus dem Dashboard. Der kostenlose Tarif umfasst 200 Credits pro Monat; eine Kreditkarte ist nicht erforderlich.
2. Client verbinden
Es gibt zwei Möglichkeiten, eine Verbindung herzustellen.
Gehosteter Endpunkt (empfohlen)
Keine Installation erforderlich. Richte einen beliebigen Client, der Remote-MCP-Server unterstützt, auf Folgendes aus:
https://mcp.socialapis.io/mcp
Sende deinen Schlüssel in einem Header:
Authorization: Bearer YOUR_API_KEY
x-api-token: YOUR_API_KEY funktioniert ebenfalls. Füge den Schlüssel niemals in die URL ein.
Lokaler Server (npx)
Für Clients, die nur lokale Server ausführen, z. B. Claude Desktop. Erfordert Node.js 18 oder neuer.
{
"mcpServers": {
"socialapis": {
"command": "npx",
"args": ["-y", "@socialapis/mcp"],
"env": {
"SOCIALAPIS_API_KEY": "YOUR_API_KEY"
}
}
}
}
Client einrichten
Claude Code
claude mcp add --transport http socialapis https://mcp.socialapis.io/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
VS Code
Füge es zu .vscode/mcp.json hinzu. VS Code fragt beim Start des Servers nach dem Schlüssel, sodass er nicht in der Datei gespeichert wird:
{
"servers": {
"socialapis": {
"type": "http",
"url": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer ${input:socialapis-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "socialapis-key",
"description": "SocialAPIs API key",
"password": true
}
]
}
Cline
Füge unter MCP Servers → Configure Folgendes zu cline_mcp_settings.json hinzu:
{
"mcpServers": {
"socialapis": {
"type": "streamableHttp",
"url": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Windsurf
Füge es zu ~/.codeium/windsurf/mcp_config.json hinzu:
{
"mcpServers": {
"socialapis": {
"serverUrl": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Verfügbare Tools
Aktuelle Version: 2.0.2. Der Server verfügt über 12 schreibgeschützte Tools. Jedes deckt eine Ressource ab und erwartet ein Argument action sowie die Eingaben für die jeweilige Aktion:
| Tool | Aktionen |
|---|---|
facebook_page | details, id, posts, videos, reels, albums, album_items |
facebook_group | details, id, posts, videos, albums, album_items |
facebook_post | details, details_extended, id, attachments, video, comments, comment_replies |
facebook_search | pages, people, posts, videos, locations |
facebook_ads | search, keywords, page_details, archive_details, countries |
facebook_marketplace | search, vehicles, rentals, listing, seller, categories, city_coordinates |
facebook_media_download | download |
instagram_profile | details, id, posts, reels, highlights, highlight_details |
instagram_post | details, id |
instagram_reels | feed, by_audio |
instagram_search | search |
instagram_location | posts, nearby |
Beispielaufruf:
{ "name": "facebook_post", "arguments": { "action": "comments", "link": "https://www.facebook.com/nike/posts/POST_ID", "limit": 20 } }
Ein fehlendes action oder eine fehlende erforderliche Eingabe führt zu einem Fehler, bevor Credits verbraucht werden. Die Beschreibung jedes Tools in deinem Client führt dieselben Eingaben für jede Aktion auf.
Upgrade von 1.x? Die alten Toolnamen pro Endpunkt (z. B. facebook_get_page_details) funktionieren bei direktem Aufruf weiterhin, sodass vorhandene Skripte weiterlaufen. Wenn dein Client Tools automatisch genehmigt oder anhand ihres Namens zulässt, füge die neuen Namen oben hinzu.
Eingaben nach Aktion
Credits werden pro Aufruf berechnet, sofern nicht anders angegeben. Paginierung: Übergib end_cursor aus einer Antwort, um die nächste Seite abzurufen.
facebook_page
Facebook-Seiten: Profildetails, Seiten-ID, Beiträge, Videos, Reels und Fotoalben.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
details | link | exact_followers_count | 1 (5 mit exact_followers_count=true) |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 pro 3 zurückgegebene Beiträge (mind. 1) |
videos | link oder profile_id | limit, end_cursor | 1 |
reels | link | end_cursor | 1 |
albums | profile_id (von id) | limit (8-16), end_cursor | 1 |
album_items | album_id (von albums) | end_cursor | 1 |
facebook_group
Öffentliche Facebook-Gruppen: Details, Gruppen-ID, Beiträge, Videos und Fotoalben.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
details | link | — | 1 |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 pro 3 zurückgegebene Beiträge (mind. 1) |
videos | link | end_cursor | 1 |
albums | group_id (von id) | limit (8-16) | 1 |
album_items | album_id (von albums) | end_cursor | 1 |
facebook_post
Facebook-Beiträge, Videos und Kommentare: Beitragsdetails, Anhänge, Kommentare und Antworten.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
details | link | — | 1 |
details_extended | link | — | 1 |
id | link | — | 1 |
attachments | post_id | — | 5 |
video | video_id | — | 1 |
comments | link | limit, end_cursor, include_reply_info | 1 |
comment_replies | comment_feedback_id, expansion_token | — | 1 |
facebook_search
Facebook nach Stichwort durchsuchen: Seiten, Personen, Beiträge, Videos und Standorte.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
pages | query | location_uid, end_cursor | 1 |
people | query | location_uid, end_cursor | 1 |
posts | query | location_uid, start_time, end_time, recent_posts, end_cursor | 1 |
videos | query | most_recent, videos_live, fields, end_cursor | 1 |
locations | query | — | 1 |
facebook_ads
Meta Ads Library: Anzeigen durchsuchen, Werbetreibende per Stichwort finden, Details zu Werbetreibenden-Seiten und einzelnen Anzeigen sowie unterstützte Länder abrufen.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
search | — | query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor | 1 |
keywords | query | country | 1 |
page_details | page_id | — | 1 |
archive_details | ad_archive_id | page_id, country, is_ad_non_political, is_ad_not_aaa_eligible | 1 |
countries | — | — | 1 |
facebook_marketplace
Facebook Marketplace: Angebote, Fahrzeuge und Mietobjekte durchsuchen, Angebots- und Verkäuferdetails sowie Kategorien und Stadtkordinaten abrufen.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
search | — | query, category_url, commerce_search_sort_by, commerce_search_and_rp_condition, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, posted_today, exact_match, limit, end_cursor | 1 |
vehicles | — | sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, is_c2c_listing_only, end_cursor | 1 |
rentals | — | sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, filter_bedrooms_min, filter_bedrooms_max, filter_bathrooms_min, filter_bathrooms_max, end_cursor | 1 |
listing | listing_id | — | 1 |
seller | seller_id | — | 1 |
categories | — | — | 1 |
city_coordinates | city | country, exactly_one | 1 |
facebook_media_download
Facebook-Medien (Bilder, Videos, Audio) von einer URL herunterladen.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
download | url | — | 1 |
instagram_profile
Instagram-Profile: Details, Benutzer-ID, Beiträge, Reels, Highlights und Highlight-Stories.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
details | username | link | 1 |
id | — | link, username | 1 |
posts | — | username, user_id, end_cursor | 1 |
reels | user_id | end_cursor | 1 |
highlights | user_id | — | 1 |
highlight_details | highlight_id | — | 1 |
instagram_post
Instagram-Beiträge: vollständige Beitragsdetails oder den Shortcode aus einer Beitrags-URL abrufen.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
details | shortcode | — | 1 |
id | link | — | 1 |
instagram_reels
Instagram Reels: den Trend-Feed oder Reels zu einem bestimmten Audiotrack abrufen.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
feed | — | clips_media_id | 1 |
by_audio | audio_id | max_id | 1 |
instagram_search
Instagram nach Stichworten durchsuchen, um beliebte Nutzer, Hashtags und Orte zu finden.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
search | keyword | end_cursor | 1 |
instagram_location
Instagram-Standorte: Beiträge, die an einem Ort markiert wurden, und Orte in der Nähe.
| Aktion | Erforderliche Eingaben | Optionale Eingaben | Credits |
|---|---|---|---|
posts | location_id | tab, end_cursor | 1 |
nearby | location_id | — | 1 |
Beispiel-Prompts
„Rufe die Details der Facebook-Seite von Nike ab und fasse die letzten 10 Beiträge zusammen.“
„Vergleiche die Followerzahlen von Adidas und Nike auf Instagram.“
„Finde aktive Anzeigen in der Meta Ads Library, in denen in den USA ‚running shoes‘ erwähnt wird.“
Fehlerbehebung
| Symptom | Lösung |
|---|---|
Missing SocialAPIs API key | Füge den Header Authorization: Bearer <key> (gehostet) oder SOCIALAPIS_API_KEY (npx) hinzu. |
| HTTP 401 oder 403 in einem Ergebnis | Kopiere den Schlüssel erneut aus dem Dashboard. |
Insufficient credits | Führe ein Upgrade durch oder lade unter socialapis.io/pricing Credits auf. |
| Keine Tools aufgeführt | Starte den Client nach dem Bearbeiten der Konfiguration neu und prüfe, ob https://mcp.socialapis.io/health antwortet (öffne es in einem Browser). |
Wo du uns findest
Der Server ist in der offiziellen MCP Registry als io.github.SocialAPIsHub/social-media-api aufgeführt sowie auf Smithery, Glama, cursor.directory, LobeHub, mcp.so und mcpservers.org. Links findest du unter socialapis.io/integrations.
Quellcode: github.com/SocialAPIsHub/mcp-server. Fragen: support@socialapis.io.