FastSocial Instagram Data

npx add-mcp 'https://data.fastsocial.co/mcp'

Serveur MCP Instagram Data

Connectez votre assistant IA à l'API Instagram Data de FastSocial, et il pourra consulter les profils Instagram publics, les publications, les reels, les stories, les highlights, les commentaires, les hashtags, les lieux et l'audio. Lecture seule : il ne publie jamais, ne suit pas, ne like pas et n'envoie pas de messages.

Le serveur est distant. Il n'y a rien à installer ni à exécuter : votre assistant communique avec

https://data.fastsocial.co/mcp

via Streamable HTTP. Lors de la première connexion, une page fastsocial.co s'ouvre dans votre navigateur où vous vous connectez et cliquez sur Autoriser.

Ce dépôt contient les manifestes du plugin (plugin.json, mcp.json et la copie que Cursor lit dans .cursor-plugin/), le server.json qui répertorie le serveur dans le registre officiel MCP sous le nom io.github.FastSocialCo/instagram-data-mcp, ainsi qu'un manifeste LobeHub. Il ne contient aucun code qui s'exécute sur votre machine. Le code du serveur n'est pas ici.

Installation

Cursor

Installez le plugin depuis cursor.directory, ou ajoutez le serveur à .cursor/mcp.json (un projet) ou ~/.cursor/mcp.json (tous les projets) :

{
  "mcpServers": {
    "instagram-data": {
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

Ouvrez Paramètres, puis MCP, et connectez-vous. Cursor ouvre la page de connexion FastSocial.

Claude Code

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp

Ensuite, exécutez /mcp dans Claude Code, choisissez instagram-data et connectez-vous.

Application Claude (web et bureau)

1. Ouvrez Paramètres, puis Connecteurs, et ajoutez un connecteur personnalisé.
2. Collez https://data.fastsocial.co/mcp comme URL du serveur.
3. Laissez l'ID client OAuth et le secret vides.
4. Connectez-vous et authentifiez-vous sur la page FastSocial qui s'ouvre.

VS Code et autres clients

Tout client qui parle MCP via Streamable HTTP peut se connecter avec l'URL du serveur. Dans VS Code, ajoutez ceci à .vscode/mcp.json et appuyez sur Démarrer :

{
  "servers": {
    "instagram-data": {
      "type": "http",
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

Ce que fait ce plugin et quelles données il envoie

Le plugin lui-même

Le plugin est constitué de deux fichiers JSON qui indiquent à votre client l'adresse du serveur. Il n'exécute aucun code, ne contient aucun script d'installation et ne stocke rien. Votre client effectue lui-même chaque requête, directement vers https://data.fastsocial.co/mcp via HTTPS.

Ce que votre client envoie

• La poignée de main MCP : le nom et la version de votre client, ainsi que la version du protocole qu'il utilise.
• Chaque appel d'outil : le nom de l'outil et ses arguments, c'est-à-dire les éléments que vous avez demandés : un nom d'utilisateur ou un identifiant utilisateur Instagram, un lien de publication ou de reel, un hashtag, des mots-clés de recherche, un lieu, un identifiant audio ou de highlight, et un curseur de pagination. La liste complète figure dans le tableau ci-dessous.
• Votre jeton de connexion ou votre clé API, dans un en-tête de requête. Jamais dans l'URL.
• Les détails habituels de toute requête web, comme votre adresse IP et le user agent de votre client.

Rien d'autre n'est envoyé. Le serveur ne voit jamais vos fichiers, votre éditeur ou votre conversation, uniquement les arguments que votre assistant place dans un appel d'outil.

Ce qui revient

Des données Instagram publiques au format JSON, plus meta.credits_remaining. Les photos et vidéos reviennent sous forme de liens, pas de fichiers. Les comptes privés renvoient une erreur private_account. Les propriétaires de comptes Instagram peuvent se désinscrire ; après cela, l'API renvoie 451 opted_out pour leur compte.

Lecture seule

Chaque outil lit. Aucun ne modifie quoi que ce soit sur Instagram. La seule chose qu'un appel change est votre propre solde de crédits pour le mois. Le serveur marque chaque outil readOnlyHint: true et openWorldHint: true dans tools/list. Il n'existe aucun outil qui écrit ou supprime.

Connexion

La première fois que votre client se connecte, le serveur répond qu'il a besoin d'une connexion et indique où trouver les instructions. Votre client ouvre ensuite une page sur fastsocial.co dans votre navigateur. Là, vous :

1. saisissez votre e-mail et le code que FastSocial vous envoie par e-mail,
2. voyez quelle application demande l'accès, et cliquez sur Autoriser (ou Refuser).

Si vous n'avez pas encore de forfait, un forfait Gratuit est créé pour vous lorsque vous cliquez sur Autoriser. Vous ne saisissez jamais de mot de passe dans votre assistant, et le plugin ne voit ni ne stocke jamais vos identifiants. Votre client conserve les jetons qu'il reçoit. Un jeton d'accès dure une heure, et votre client le renouvelle avec un jeton d'actualisation qui dure 30 jours et change à chaque utilisation.

Pour couper l'accès à toutes les applications que vous avez connectées, connectez-vous sur https://fastsocial.co/cart/api/account et appuyez sur Nouvelle clé. Les connexions liées à l'ancienne clé cessent de fonctionner immédiatement.

Pour les développeurs de clients : la découverte commence à https://data.fastsocial.co/.well-known/oauth-protected-resource/mcp. Le serveur d'autorisation prend en charge OAuth 2.1 avec PKCE (S256 uniquement), l'enregistrement dynamique des clients et la révocation des jetons, pour les clients publics.

Utiliser une clé API à la place

Si votre client peut définir un en-tête mais ne peut pas se connecter, obtenez une clé sur https://fastsocial.co/instagram-api?ref=github et envoyez-la à chaque requête sous la forme X-API-Key: YOUR_KEY (ou Authorization: Bearer YOUR_KEY). Pour Claude Code :

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp --header "X-API-Key: YOUR_KEY"

Gardez la clé hors des fichiers que vous validez.

Politiques

• Politique de confidentialité : https://fastsocial.co/privacy
• Conditions d'utilisation : https://fastsocial.co/terms
• Politique d'utilisation des données (données publiques uniquement, pas de suivi ni de harcèlement des personnes, rien concernant les mineurs) : https://fastsocial.co/instagram-api/docs?ref=github
• Signaler un problème de sécurité : SECURITY.md

Les 28 outils

Chaque appel coûte des crédits sur votre allocation mensuelle. Les appels échoués ne coûtent rien. Chaque outil est en lecture seule.

Outil	Ce qu'il fait	Arguments	Crédits
instagram_profile	Obtenir un profil Instagram	username ou user_id	1
instagram_user_id	Nom d'utilisateur Instagram vers identifiant utilisateur	username ou user_id	1
instagram_username	Identifiant utilisateur Instagram vers nom d'utilisateur	user_id	2
instagram_check	Vérifier si un identifiant Instagram existe et est public	username	1
instagram_posts	Obtenir les publications Instagram récentes	username ou user_id, cursor	1
instagram_reels	Obtenir les reels Instagram d'un compte	username ou user_id, cursor	1
instagram_tagged	Obtenir les publications dans lesquelles un compte est tagué	username ou user_id, cursor	1
instagram_post	Obtenir une publication ou un reel Instagram	url ou shortcode	1
instagram_media	URLs de téléchargement pour une publication, un reel ou un carrousel	url ou shortcode	1
instagram_comments	Obtenir les commentaires d'une publication Instagram	url ou shortcode	3
instagram_comment_replies	Obtenir les réponses à un commentaire Instagram	url ou shortcode, comment_id, cursor	3
instagram_likers	Obtenir les comptes qui ont aimé une publication Instagram	url ou shortcode	3
instagram_insights	Calculateur de taux d'engagement Instagram	username ou user_id	2
instagram_followers	Obtenir les abonnés d'un compte	username ou user_id, cursor	3
instagram_following	Obtenir les comptes suivis par un compte	username ou user_id, cursor	3
instagram_similar	Trouver des comptes Instagram similaires	username ou user_id	1
instagram_stories	Voir les stories Instagram anonymement	username ou user_id	3
instagram_highlights	Obtenir les highlights de stories Instagram	username ou user_id	3
instagram_highlight	Obtenir les éléments d'un highlight	id	3
instagram_search	Rechercher des comptes, hashtags et lieux Instagram	q	1
instagram_hashtag	Obtenir les publications pour un hashtag Instagram	tag, cursor	1
instagram_place	Obtenir un lieu Instagram	id	3
instagram_place_posts	Obtenir les publications taguées à un lieu Instagram	id, cursor	1
instagram_audio	Obtenir une piste audio Instagram et les reels qui l'utilisent	id	1
instagram_audio_search	Rechercher de la musique et des sons Instagram	q	3
instagram_reels_search	Rechercher des reels Instagram par mot-clé	q, cursor	3
instagram_top_accounts	Classement quotidien des 2 000 comptes les plus suivis	sort, limit	0
instagram_usage	Vos crédits utilisés et restants ce mois-ci	aucun	0

Référence complète : https://fastsocial.co/instagram-api/docs?ref=github

Choses à lui demander

• « Compare le taux d'engagement de @nasa et @spacex. »
• « Télécharge chaque diapositive de ce carrousel : https://www.instagram.com/p/... »
• « Montre-moi les stories actuelles de @natgeo et résume-les. »
• « Trouve 10 comptes similaires à @humansofny. »

Version locale

Si votre client ne prend en charge que les serveurs locaux (stdio), les mêmes outils sont disponibles sur PyPI sous le nom instagram-data-mcp. Cela ne fait pas partie de ce plugin. Sa source est FastSocialCo/instagram-data-mcp-python.

Liens

• API Instagram Data : https://fastsocial.co/instagram-api?ref=github
• Documentation : https://fastsocial.co/instagram-api/docs?ref=github
• Spécification OpenAPI : https://fastsocial.co/instagram-api/openapi.json
• Entrée du registre MCP : io.github.FastSocialCo/instagram-data-mcp

Licence

MIT. Voir LICENSE.