instagram-use MCP server
Commit 11. Nov. 2026Ermöglicht es AI Agents, über authentifizierte Workflows oder anonyme öffentliche Dateninspektion mit Instagram zu interagieren.
Auch bekannt als dalroot/instagram-use
- Stars
- 0
- Tools
- 12
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- MIT
Was ist instagram-use MCP?
Ermöglicht es AI Agents, über authentifizierte Workflows oder anonyme öffentliche Dateninspektion mit Instagram zu interagieren. Er stellt 12 Tools bereit, etwa instagram_publish_story, instagram_publish_post, instagram_send_message.
Zusammenfassung generiert aus dem README des Projekts
Über instagram-use MCP server
Die Automatisierung von Social-Media-Workflows für AI Agents ist mit instagram-use möglich, das eine Brücke zwischen Large Language Models und Instagram schlägt. Es fungiert als MCP server oder als Hermes Agent Plugin und erlaubt es Tools wie Claude Desktop, LangChain oder CrewAI, über strukturierte JSON-Payloads mit der Plattform zu interagieren. Das System folgt den Spezifikationen der Meta Graph API v21.0, um sicherzustellen, dass Aktionen vorhersehbar und zuverlässig sind.
Nutzer können zwischen zwei verschiedenen Betriebsmodi wählen. Der Ghost Mode ermöglicht eine anonyme Inspektion öffentlicher Daten, wie das Durchsuchen von Hashtags oder das Auditieren von Konkurrenzprofilen, ohne dass Login-Daten erforderlich sind. Der Authenticated Mode nutzt einen sessionbasierten Ansatz über eine instagram_session.json Datei, die Session-Cookies enthält, um aktive Aufgaben auszuführen. Dieser Modus erlaubt es Agents, Stories und Feed-Posts zu veröffentlichen, Direct Messages über das instagram_get_inbox Tool zu verwalten und Insights für Professional Accounts der letzten 30 Tage abzurufen.
Um die Kontosicherheit zu gewährleisten, enthält der Server Circuit Breaker, die die Ausführung stoppen, falls Sicherheitsherausforderungen auftreten, sowie Limits für repetitive String-Dispatches, um Spam-Erkennung zu vermeiden. Die Einrichtung erfordert Python 3.10 oder höher, Node.js 18.0 oder höher und das twingraph engine CLI.
Was du damit machen kannst
- 1Anonyme KonkurrenzanalyseEin Agent kann das öffentliche Profil und die Engagement-Raten eines Konkurrenten analysieren, ohne sich in ein Konto einzuloggen.
- 2Automatisierte Content-VeröffentlichungEin Developer kann eine KI anweisen, neue Bilder oder Stories direkt in einem Instagram-Feed zu posten.
- 3Management von KundenanfragenEin AI Agent kann eingehende Direct Messages aus dem Posteingang eines Nutzers überwachen und zusammenfassen.
- 4Analytics für Professional AccountsNutzer können detaillierte Performance-Metriken und Zielgruppendaten für Professional Accounts abrufen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
instagram-use MCP tools 12
Erkannt aus dem 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 | — |
Konfiguration
INSTAGRAM_SESSION_PATH
| Name | Beschreibung | Typ |
|---|---|---|
| INSTAGRAM_SESSION_PATH | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbardalroot/instagram-use is public and reachablegithub.com/dalroot/instagram-use ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-11github.com/dalroot/instagram-use ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub anseheninstagram-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.
instagram-use MCP Fragen
Welche Tools bietet instagram-use MCP?
Er stellt 12 Tools bereit, darunter instagram_publish_story, instagram_publish_post, instagram_send_message, instagram_get_inbox, instagram_post_comment.
Wie schützt der Server mein Instagram-Konto vor einem Bann?
Er nutzt eine Safety Circuit Breaker Architektur, die Single-Attempt Fail-Closed-Mechanismen und Limits für die String-Deduplizierung enthält, um Spam-Erkennung zu verhindern.