SocialAPIs — Facebook & Instagram Data
officielDonné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 :
| Outil | Actions |
|---|---|
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 |
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.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
details | link | exact_followers_count | 1 (5 avec exact_followers_count=true) |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 par tranche de 3 publications renvoyées (min. 1) |
videos | link ou profile_id | limit, end_cursor | 1 |
reels | link | end_cursor | 1 |
albums | profile_id (depuis id) | limit (8-16), end_cursor | 1 |
album_items | album_id (depuis albums) | end_cursor | 1 |
facebook_group
Groupes Facebook publics : détails, ID de groupe, publications, vidéos et albums photo.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
details | link | — | 1 |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 par tranche de 3 publications renvoyées (min. 1) |
videos | link | end_cursor | 1 |
albums | group_id (depuis id) | limit (8-16) | 1 |
album_items | album_id (depuis albums) | end_cursor | 1 |
facebook_post
Publications, vidéos et commentaires Facebook : détails des publications, pièces jointes, commentaires et réponses.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
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
Rechercher sur Facebook par mot-clé : pages, personnes, publications, vidéos et lieux.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
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 : 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.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
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 : 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.
| Action | Entrées obligatoires | Entrées facultatives | Cré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_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
Télécharger des médias Facebook (images, vidéos, audio) à partir d’une URL.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
download | url | — | 1 |
instagram_profile
Profils Instagram : détails, ID utilisateur, publications, reels, stories à la une et stories des highlights.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
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
Publications Instagram : détails complets d’une publication ou shortcode extrait de l’URL d’une publication.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
details | shortcode | — | 1 |
id | link | — | 1 |
instagram_reels
Instagram Reels : fil des tendances ou reels utilisant une piste audio donnée.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
feed | — | clips_media_id | 1 |
by_audio | audio_id | max_id | 1 |
instagram_search
Rechercher sur Instagram par mot-clé des utilisateurs populaires, des hashtags et des lieux.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
search | keyword | end_cursor | 1 |
instagram_location
Lieux Instagram : publications identifiées dans un lieu et lieux à proximité.
| Action | Entrées obligatoires | Entrées facultatives | Crédits |
|---|---|---|---|
posts | location_id | tab, end_cursor | 1 |
nearby | location_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ôme | Solution |
|---|---|
Missing SocialAPIs API key | Ajoutez l’en-tête Authorization: Bearer <key> (hébergé) ou SOCIALAPIS_API_KEY (npx). |
| HTTP 401 ou 403 dans un résultat | Recopiez la clé depuis le tableau de bord. |
Insufficient credits | Passez à 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.