SocialAPIs — Facebook & Instagram Data

officiel

Données Facebook et Instagram pour agents IA — pages, publications, groupes, bibliothèque publicitaire, Marketplace, profils et reels. 47 outils en lecture seule, sortie structurée. Offre gratuite : 200 appels/mois.

Que pouvez-vous faire avec SocialAPIs — Facebook & Instagram Data MCP ?

  • Données des pages et groupes Facebook — Récupérez les détails des pages ou des groupes, les publications, les vidéos, les reels et les albums photo à partir d’un lien ou d’un identifiant.
  • Recherche de publications et de commentaires Facebook — Récupérez les détails d’une publication, ses pièces jointes, ses commentaires et les réponses aux commentaires à partir du lien de la publication.
  • Recherche dans la bibliothèque publicitaire Meta — Recherchez des publicités par mot-clé ou annonceur, obtenez les détails de la page de l’annonceur et consultez la liste des pays pris en charge.
  • Données des profils et publications Instagram — Récupérez les détails d’un profil, ses publications, ses reels, ses stories à la une et les détails complets d’une publication à partir d’un nom d’utilisateur ou d’un shortcode.
  • Recherche et lieux Instagram — Recherchez des utilisateurs, des hashtags et des lieux par mot-clé, ou consultez les publications associées à un lieu.
  • Recherche sur Facebook Marketplace — Recherchez des annonces, des véhicules et des locations à l’aide de filtres, et obtenez les détails d’une annonce ou d’un vendeur.

Serveur MCP hébergé

npx add-mcp 'https://mcp.socialapis.io/mcp'

S’installe dans Claude Code, Codex, Cursor et plus

Documentation

Donnez aux assistants IA un accès direct aux données publiques de Facebook et Instagram avec le serveur Model Context Protocol (MCP) de SocialAPIs.

Le serveur expose 12 outils en lecture seule couvrant 50 actions : pages, publications, commentaires, groupes, Meta Ads Library, Marketplace, profils Instagram, publications, reels et lieux. Chaque outil couvre une ressource et prend un argument action. Chaque appel renvoie une sortie structurée, qui indique notamment les crédits facturés et les crédits restants.

1. Obtenir une clé API

Inscrivez-vous sur socialapis.io et copiez votre clé depuis le tableau de bord. L’offre gratuite comprend 200 crédits par mois, sans carte bancaire.

2. Connecter votre client

Il existe deux façons de se connecter.

Point de terminaison hébergé (recommandé)

Aucune installation nécessaire. Configurez n’importe quel client prenant en charge les serveurs MCP distants pour utiliser :

https://mcp.socialapis.io/mcp

Envoyez votre clé dans un en-tête :

Authorization: Bearer YOUR_API_KEY

x-api-token: YOUR_API_KEY fonctionne également. Ne placez jamais la clé dans l’URL.

Serveur local (npx)

Pour les clients qui exécutent uniquement des serveurs locaux, comme Claude Desktop. Nécessite Node.js 18 ou une version ultérieure.

{
  "mcpServers": {
    "socialapis": {
      "command": "npx",
      "args": ["-y", "@socialapis/mcp"],
      "env": {
        "SOCIALAPIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Configuration du client

Claude Code

claude mcp add --transport http socialapis https://mcp.socialapis.io/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

VS Code

Ajoutez à .vscode/mcp.json. VS Code demande la clé au démarrage du serveur ; elle n’est donc pas enregistrée dans le fichier :

{
  "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

Dans MCP Servers → Configure, ajoutez à cline_mcp_settings.json :

{
  "mcpServers": {
    "socialapis": {
      "type": "streamableHttp",
      "url": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Ajoutez à ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "socialapis": {
      "serverUrl": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Outils disponibles

Version actuelle : 2.0.2. Le serveur dispose de 12 outils en lecture seule. Chacun couvre une ressource et prend un argument action, ainsi que les entrées propres à l’action :

OutilActions
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

Exemple d’appel :

{ "name": "facebook_post", "arguments": { "action": "comments", "link": "https://www.facebook.com/nike/posts/POST_ID", "limit": 20 } }

Un action manquant ou une entrée obligatoire manquante renvoie une erreur avant toute dépense de crédits. La description de chaque outil dans votre client répertorie les mêmes entrées pour chaque action.

Vous effectuez une mise à niveau depuis la version 1.x ? Les anciens noms d’outils par point de terminaison (comme facebook_get_page_details) fonctionnent toujours lorsqu’ils sont appelés directement, afin que les scripts existants continuent de fonctionner. Si votre client approuve automatiquement les outils ou les autorise par nom, ajoutez les nouveaux noms ci-dessus.

Entrées par action

Les crédits sont facturés par appel, sauf indication contraire. Pagination : transmettez le end_cursor d’une réponse pour obtenir la page suivante.

facebook_page

Pages Facebook : détails du profil, ID de page, publications, vidéos, reels et albums photo.

ActionEntrées obligatoiresEntrées facultativesCrédits
detailslinkexact_followers_count1 (5 avec exact_followers_count=true)
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 par tranche de 3 publications renvoyées (min. 1)
videoslink ou profile_idlimit, end_cursor1
reelslinkend_cursor1
albumsprofile_id (depuis id)limit (8-16), end_cursor1
album_itemsalbum_id (depuis albums)end_cursor1

facebook_group

Groupes Facebook publics : détails, ID de groupe, publications, vidéos et albums photo.

ActionEntrées obligatoiresEntrées facultativesCrédits
detailslink—1
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 par tranche de 3 publications renvoyées (min. 1)
videoslinkend_cursor1
albumsgroup_id (depuis id)limit (8-16)1
album_itemsalbum_id (depuis albums)end_cursor1

facebook_post

Publications, vidéos et commentaires Facebook : détails des publications, pièces jointes, commentaires et réponses.

ActionEntrées obligatoiresEntrées facultativesCrédits
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

Rechercher sur Facebook par mot-clé : pages, personnes, publications, vidéos et lieux.

ActionEntrées obligatoiresEntrées facultativesCrédits
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 : rechercher des publicités, trouver des annonceurs par mot-clé, consulter les détails des pages d’annonceurs et des publicités, et connaître les pays pris en charge.

ActionEntrées obligatoiresEntrées facultativesCrédits
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 : rechercher des annonces, des véhicules et des locations, consulter les détails des annonces et des vendeurs, les catégories et les coordonnées des villes.

ActionEntrées obligatoiresEntrées facultativesCrédits
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

Télécharger des médias Facebook (images, vidéos, audio) à partir d’une URL.

ActionEntrées obligatoiresEntrées facultativesCrédits
downloadurl—1

instagram_profile

Profils Instagram : détails, ID utilisateur, publications, reels, stories à la une et stories des highlights.

ActionEntrées obligatoiresEntrées facultativesCrédits
detailsusernamelink1
id—link, username1
posts—username, user_id, end_cursor1
reelsuser_idend_cursor1
highlightsuser_id—1
highlight_detailshighlight_id—1

instagram_post

Publications Instagram : détails complets d’une publication ou shortcode extrait de l’URL d’une publication.

ActionEntrées obligatoiresEntrées facultativesCrédits
detailsshortcode—1
idlink—1

instagram_reels

Instagram Reels : fil des tendances ou reels utilisant une piste audio donnée.

ActionEntrées obligatoiresEntrées facultativesCrédits
feed—clips_media_id1
by_audioaudio_idmax_id1

instagram_search

Rechercher sur Instagram par mot-clé des utilisateurs populaires, des hashtags et des lieux.

ActionEntrées obligatoiresEntrées facultativesCrédits
searchkeywordend_cursor1

instagram_location

Lieux Instagram : publications identifiées dans un lieu et lieux à proximité.

ActionEntrées obligatoiresEntrées facultativesCrédits
postslocation_idtab, end_cursor1
nearbylocation_id—1

Exemples de requêtes

« Récupère les détails de la page Facebook de Nike et résume ses 10 dernières publications. »

« Compare le nombre d’abonnés d’Adidas et de Nike sur Instagram. »

« Trouve les publicités actives dans Meta Ads Library qui mentionnent “running shoes” aux États-Unis. »

Dépannage

SymptômeSolution
Missing SocialAPIs API keyAjoutez l’en-tête Authorization: Bearer <key> (hébergé) ou SOCIALAPIS_API_KEY (npx).
HTTP 401 ou 403 dans un résultatRecopiez la clé depuis le tableau de bord.
Insufficient creditsPassez à une offre supérieure ou rechargez votre compte sur socialapis.io/pricing.
Aucun outil répertoriéRedémarrez le client après avoir modifié sa configuration et vérifiez que https://mcp.socialapis.io/health répond (ouvrez-le dans un navigateur).

Où nous trouver

Le serveur est répertorié dans le registre MCP officiel sous le nom io.github.SocialAPIsHub/social-media-api, ainsi que sur Smithery, Glama, cursor.directory, LobeHub, mcp.so et mcpservers.org. Consultez socialapis.io/integrations pour obtenir les liens.

Code source : github.com/SocialAPIsHub/mcp-server. Questions : support@socialapis.io.