SocialAPIs — Facebook & Instagram Data

offiziell

Facebook- 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:

ToolAktionen
facebook_pagedetails, id, posts, videos, reels, albums, album_items
facebook_groupdetails, id, posts, videos, albums, album_items
facebook_postdetails, details_extended, id, attachments, video, comments, comment_replies
facebook_searchpages, people, posts, videos, locations
facebook_adssearch, keywords, page_details, archive_details, countries
facebook_marketplacesearch, vehicles, rentals, listing, seller, categories, city_coordinates
facebook_media_downloaddownload
instagram_profiledetails, id, posts, reels, highlights, highlight_details
instagram_postdetails, id
instagram_reelsfeed, by_audio
instagram_searchsearch
instagram_locationposts, 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.

AktionErforderliche EingabenOptionale EingabenCredits
detailslinkexact_followers_count1 (5 mit exact_followers_count=true)
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 pro 3 zurückgegebene Beiträge (mind. 1)
videoslink oder profile_idlimit, end_cursor1
reelslinkend_cursor1
albumsprofile_id (von id)limit (8-16), end_cursor1
album_itemsalbum_id (von albums)end_cursor1

facebook_group

Öffentliche Facebook-Gruppen: Details, Gruppen-ID, Beiträge, Videos und Fotoalben.

AktionErforderliche EingabenOptionale EingabenCredits
detailslink—1
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 pro 3 zurückgegebene Beiträge (mind. 1)
videoslinkend_cursor1
albumsgroup_id (von id)limit (8-16)1
album_itemsalbum_id (von albums)end_cursor1

facebook_post

Facebook-Beiträge, Videos und Kommentare: Beitragsdetails, Anhänge, Kommentare und Antworten.

AktionErforderliche EingabenOptionale EingabenCredits
detailslink—1
details_extendedlink—1
idlink—1
attachmentspost_id—5
videovideo_id—1
commentslinklimit, end_cursor, include_reply_info1
comment_repliescomment_feedback_id, expansion_token—1

facebook_search

Facebook nach Stichwort durchsuchen: Seiten, Personen, Beiträge, Videos und Standorte.

AktionErforderliche EingabenOptionale EingabenCredits
pagesquerylocation_uid, end_cursor1
peoplequerylocation_uid, end_cursor1
postsquerylocation_uid, start_time, end_time, recent_posts, end_cursor1
videosquerymost_recent, videos_live, fields, end_cursor1
locationsquery—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.

AktionErforderliche EingabenOptionale EingabenCredits
search—query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor1
keywordsquerycountry1
page_detailspage_id—1
archive_detailsad_archive_idpage_id, country, is_ad_non_political, is_ad_not_aaa_eligible1
countries——1

facebook_marketplace

Facebook Marketplace: Angebote, Fahrzeuge und Mietobjekte durchsuchen, Angebots- und Verkäuferdetails sowie Kategorien und Stadtkordinaten abrufen.

AktionErforderliche EingabenOptionale EingabenCredits
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_cursor1
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_cursor1
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_cursor1
listinglisting_id—1
sellerseller_id—1
categories——1
city_coordinatescitycountry, exactly_one1

facebook_media_download

Facebook-Medien (Bilder, Videos, Audio) von einer URL herunterladen.

AktionErforderliche EingabenOptionale EingabenCredits
downloadurl—1

instagram_profile

Instagram-Profile: Details, Benutzer-ID, Beiträge, Reels, Highlights und Highlight-Stories.

AktionErforderliche EingabenOptionale EingabenCredits
detailsusernamelink1
id—link, username1
posts—username, user_id, end_cursor1
reelsuser_idend_cursor1
highlightsuser_id—1
highlight_detailshighlight_id—1

instagram_post

Instagram-Beiträge: vollständige Beitragsdetails oder den Shortcode aus einer Beitrags-URL abrufen.

AktionErforderliche EingabenOptionale EingabenCredits
detailsshortcode—1
idlink—1

instagram_reels

Instagram Reels: den Trend-Feed oder Reels zu einem bestimmten Audiotrack abrufen.

AktionErforderliche EingabenOptionale EingabenCredits
feed—clips_media_id1
by_audioaudio_idmax_id1

instagram_search

Instagram nach Stichworten durchsuchen, um beliebte Nutzer, Hashtags und Orte zu finden.

AktionErforderliche EingabenOptionale EingabenCredits
searchkeywordend_cursor1

instagram_location

Instagram-Standorte: Beiträge, die an einem Ort markiert wurden, und Orte in der Nähe.

AktionErforderliche EingabenOptionale EingabenCredits
postslocation_idtab, end_cursor1
nearbylocation_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

SymptomLösung
Missing SocialAPIs API keyFüge den Header Authorization: Bearer <key> (gehostet) oder SOCIALAPIS_API_KEY (npx) hinzu.
HTTP 401 oder 403 in einem ErgebnisKopiere den Schlüssel erneut aus dem Dashboard.
Insufficient creditsFühre ein Upgrade durch oder lade unter socialapis.io/pricing Credits auf.
Keine Tools aufgeführtStarte 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.