Serveur MCP instagram-use
Commit 11 nov. 2026Permet aux agents IA d'interagir avec Instagram via des flux de travail authentifiés ou l'inspection anonyme de données publiques.
Aussi connu sous dalroot/instagram-use
- Étoiles
- 0
- Outils
- 12
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 11 nov. 2026
- Licence
- MIT
Qu'est-ce que instagram-use MCP ?
Permet aux agents IA d'interagir avec Instagram via des flux de travail authentifiés ou l'inspection anonyme de données publiques. Il expose 12 outils, comme instagram_publish_story, instagram_publish_post, instagram_send_message.
Résumé généré à partir du README du projet
À propos du MCP server instagram-use
L'automatisation des flux de travail sur les réseaux sociaux pour les agents IA est possible grâce à instagram-use, qui fournit une passerelle entre les grands modèles de langage et Instagram. Il fonctionne comme un MCP server ou un plugin d'agent Hermes, permettant à des outils tels que Claude Desktop, LangChain ou CrewAI d'interagir avec la plateforme en utilisant des payloads JSON structurés. Le système respecte les spécifications de la Meta Graph API v21.0 pour garantir des actions prévisibles et fiables.
Les utilisateurs peuvent choisir entre deux modes opérationnels distincts. Le Ghost Mode permet l'inspection anonyme de données publiques, comme la recherche de hashtags ou l'audit de profils concurrents, sans nécessiter d'identifiants de connexion. L'Authenticated Mode utilise une approche basée sur une session via un fichier instagram_session.json contenant des cookies de session pour effectuer des tâches actives. Ce mode permet aux agents de publier des stories et des posts dans le flux, de gérer les messages directs via l'outil instagram_get_inbox, et de récupérer les statistiques de compte professionnel sur 30 jours.
Pour maintenir la sécurité du compte, le serveur inclut des disjoncteurs qui interrompent l'exécution si des défis de sécurité surviennent et limite l'envoi de chaînes répétitives pour prévenir la détection de spam. La configuration nécessite Python 3.10 ou supérieur, Node.js 18.0 ou supérieur, et le CLI du moteur twingraph.
Ce que vous pouvez faire avec
- 1Recherche de concurrents anonymeUn agent peut analyser le profil public et les taux d'engagement d'un concurrent sans se connecter à un compte.
- 2Publication de contenu automatiséeUn développeur peut ordonner à une IA de publier de nouvelles images ou des stories directement sur un flux Instagram.
- 3Gestion des demandes clientsUn agent IA peut surveiller et résumer les messages directs entrants de la boîte de réception d'un utilisateur.
- 4Analyses de comptes professionnelsLes utilisateurs peuvent extraire des métriques de performance détaillées et des données d'audience pour les comptes professionnels.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Outils MCP instagram-use 12
Détectés depuis le READMEinstagram_publish_storyinstagram_publish_postinstagram_send_messageinstagram_get_inboxinstagram_post_commentinstagram_get_insightsinstagram_get_profileinstagram_get_postsinstagram_get_media_metricsinstagram_get_commentsinstagram_searchinstagram_audit_account
| instagram_publish_story | — | |
| instagram_publish_post | — | |
| instagram_send_message | — | |
| instagram_get_inbox | — | |
| instagram_post_comment | — | |
| instagram_get_insights | — | |
| instagram_get_profile | — | |
| instagram_get_posts | — | |
| instagram_get_media_metrics | — | |
| instagram_get_comments | — | |
| instagram_search | — | |
| instagram_audit_account | — |
Configuration
INSTAGRAM_SESSION_PATH
| Nom | Description | Type |
|---|---|---|
| INSTAGRAM_SESSION_PATH | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibledalroot/instagram-use is public and reachablegithub.com/dalroot/instagram-use ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-11github.com/dalroot/instagram-use ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubinstagram-use
Make Instagram usable for AI agents.
Standardized Meta Graph API v21.0 Twin architecture, Model Context Protocol (MCP) server, and Agent plugin for autonomous Instagram workflows via session cookies or anonymous Ghost Mode.
Overview
Modern AI agents need hands and eyes on social platforms, but integrating with Instagram has traditionally forced teams into one of two dead ends:
- The Official Meta App Wall: Requires burdensome corporate business verification, multi-week app reviews, and severely restricted permission scopes.
- Fragile Web Scrapers: Unstructured HTML parsing that breaks with every frontend release and triggers instant security checkpoints or account bans.
instagram-use bridges this gap. It models public actions and authenticated workflows 1:1 after the official Meta Graph API v21.0 specifications, executing them directly through clean GraphQL and private session transports.
Designed specifically for LLM tool-calling (Hermes, Claude Desktop/MCP, Antigravity, LangChain, CrewAI, AutoGen), instagram-use outputs strictly typed, structured JSON payloads with built-in safety circuit breakers.
Dual Operational Modes
instagram-use operates in two distinct modes depending on task requirements:
┌────────────────────────────────────────────────────────┐
│ instagram-use │
├───────────────────────────┬────────────────────────────┤
│ Ghost Mode │ Authenticated Mode │
│ (Zero Login / Public) │ (Cookie Session / Auth) │
├───────────────────────────┼────────────────────────────┤
│ • Profile Inspection │ • Story Publishing │
│ • Public Post / Reel Data │ • Feed Post Publishing │
│ • Public Comment Harvest │ • Direct Message (Send/DM) │
│ • Hashtag / User Search │ • Direct Inbox Inspection │
│ • Competitor Account Audit│ • Post / Reel Commenting │
│ │ • 30-Day Account Insights │
└───────────────────────────┴────────────────────────────┘
1. Ghost Mode (Zero Footprint / No Login)
- Zero Credentials Required: No account, password, or cookies necessary.
- Risk-Free Exploration: Inspect competitor profiles, harvest public comment threads, scan viral reels, and search hashtags without leaving an audit trail or risking primary accounts.
- Ideal For: Market intelligence agents, competitor monitoring, sentiment scrapers, and trend discovery bots.
2. Authenticated Mode (Session-Based Digital Twin)
- Cookie-Based Authentication: Operates through a standard desktop session file (
instagram_session.jsoncontainingsessionidandcsrftoken). No plaintext passwords ever stored or requested. - Full Action Surface: Publish stories and feed posts, respond to direct messages, post comments, and extract 30-day professional account analytics.
- Anti-Ban Protection: Enforces single-attempt fail-closed circuit breakers and strict string deduplication limits to protect account health.
Provided Tools Reference
instagram-use exposes 12 deterministic tools for LLM tool calling:
| Tool | Mode | Description | Key Parameters |
|---|---|---|---|
instagram_publish_story |
Authenticated | Publish an ephemeral story (24-hour lifecycle). | image_input (path or base64) |
instagram_publish_post |
Authenticated | Publish a feed post with caption, hashtags, and mentions. | image_input, caption |
instagram_send_message |
Authenticated | Send a direct message to a user (supports handles or numeric IDs). | recipient, message |
instagram_get_inbox |
Authenticated | Read direct message inbox threads and unread conversations. | limit |
instagram_post_comment |
Authenticated | Post an authentic comment on any post or reel. | media_id_or_url, text |
instagram_get_insights |
Authenticated | Fetch 30-day professional metrics, audience curves, and reach. | period, metric_type |
instagram_get_profile |
Ghost | Inspect public profile details (bio, follower count, avatar). | username |
instagram_get_posts |
Ghost | Fetch recent posts/reels with like counts and engagement rates. | username, count |
instagram_get_media_metrics |
Ghost | Retrieve performance metrics (views, discussion count) for a reel/post. | shortcode_or_url |
instagram_get_comments |
Ghost | Harvest public comments from any post or reel without logging in. | shortcode_or_url, limit |
instagram_search |
Ghost | Search for users, creators, and trending hashtags anonymously. | query |
instagram_audit_account |
Ghost | Perform a comprehensive analytical audit of any public account. | username |
Installation & Setup
Requirements
- Python
>= 3.10 - Node.js
>= 18.0.0 twingraphengine CLI (globally available inPATH)
Option A: Install as a Hermes Agent Plugin
hermes plugins install instagram-use
Or clone directly into your Hermes plugins directory:
git clone https://github.com/dalroot/instagram-use.git ~/.hermes/plugins/instagram-use
Option B: Use as an MCP Server (Model Context Protocol)
Add instagram-use to your MCP configuration (Claude Desktop, Cursor, Antigravity, etc.):
{
"mcpServers": {
"instagram": {
"command": "twingraph",
"args": ["mcp"],
"env": {
"INSTAGRAM_SESSION_PATH": "/path/to/instagram_session.json"
}
}
}
}
Option C: Standalone Python / CLI Integration
Clone and install dependencies:
git clone https://github.com/dalroot/instagram-use.git
cd instagram-use
pip install -e .
Authentication & Session Setup
For Ghost Mode, no authentication is required.
For Authenticated Mode:
- Run the interactive session generator:
This opens a secure browser window for you to log in to Instagram once.twingraph login - The session is automatically persisted to
~/instagram_session.json. - Alternatively, you can supply your existing cookies manually:
{ "cookies": { "sessionid": "YOUR_SESSION_ID", "ds_user_id": "YOUR_USER_ID", "csrftoken": "YOUR_CSRF_TOKEN" } }
Safety & Circuit Breaker Architecture
Automated agents can trigger platform checkpoints if they get stuck in loops or send repetitive payloads. instagram-use includes built-in protective layers:
- Single-Attempt Fail-Closed: If an authenticated request encounters a non-200 response or security challenge, the circuit breaker immediately trips and halts execution. Automated retry loops are strictly blocked.
- String Deduplication Caps: Dispatches of identical comments or messages are capped at safe thresholds to prevent triggering automated spam classifiers.
- Strict Parameter Coercion: URLs, shortcodes, and usernames are automatically validated and resolved before executing network requests.
Example Agent Prompts
# Publishing a Story
Agent Prompt: "Publish the graphic at /tmp/announcement.jpg as an Instagram story."
Tool Called: instagram_publish_story(image_input="/tmp/announcement.jpg")
# Direct Message Inquiries
Agent Prompt: "Check our direct message inbox for any unread customer questions and summarize them."
Tool Called: instagram_get_inbox(limit=10)
# Anonymous Competitor Audit (Ghost Mode)
Agent Prompt: "Inspect the public profile @competitor_brand, calculate their average reel engagement, and summarize their top 3 recent posts."
Tools Called:
1. instagram_get_profile(username="competitor_brand")
2. instagram_get_posts(username="competitor_brand", count=10)
Repository Metadata & Topics
Recommended configuration for the GitHub repository:
- Repository Name:
instagram-use - Short Description (About):
Make Instagram usable for AI agents. Meta Graph API v21.0 Twin architecture, MCP server, and Agent plugin for stories, posts, DMs, comments, and anonymous Ghost Mode. - Website:
https://github.com/dalroot/instagram-use - GitHub Topics:
instagram-use,ai-agents,mcp-server,llm-tools,instagram-agent,agent-toolkit,hermes-agent,meta-graph-api,cookie-session,automation
License
This project is licensed under the MIT License. See LICENSE for details.
Questions sur instagram-use MCP
Quels outils instagram-use MCP fournit-il ?
Il expose 12 outils, dont instagram_publish_story, instagram_publish_post, instagram_send_message, instagram_get_inbox, instagram_post_comment.
Comment le serveur protège-t-il mon compte Instagram contre le bannissement ?
Il utilise une architecture de disjoncteur de sécurité qui inclut des mécanismes de fermeture automatique en cas d'échec et des limites de déduplication de chaînes pour éviter la détection de spam.