MCP server de instagram-use
Commit 11 nov 2026Permite que los agentes de IA interactúen con Instagram mediante flujos de trabajo autenticados o inspección anónima de datos públicos.
También conocido como dalroot/instagram-use
- Stars
- 0
- Herramientas
- 12
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 11 nov 2026
- Licencia
- MIT
¿Qué es instagram-use MCP?
Permite que los agentes de IA interactúen con Instagram mediante flujos de trabajo autenticados o inspección anónima de datos públicos. Expone 12 herramientas, como instagram_publish_story, instagram_publish_post, instagram_send_message.
Resumen generado a partir del README del proyecto
Acerca del MCP server de instagram-use
Automatizar flujos de trabajo de redes sociales para agentes de IA es posible a través de instagram-use, que proporciona un puente entre los modelos de lenguaje extensos e Instagram. Funciona como un MCP server o un plugin de agente Hermes, permitiendo que herramientas como Claude Desktop, LangChain o CrewAI interactúen con la plataforma utilizando payloads JSON estructurados. El sistema sigue las especificaciones de Meta Graph API v21.0 para garantizar que las acciones sean predecibles y confiables.
Los usuarios pueden elegir entre dos modos operativos distintos. El Ghost Mode permite la inspección anónima de datos públicos, como la búsqueda de hashtags o la auditoría de perfiles de la competencia, sin necesidad de credenciales de inicio de sesión. El Authenticated Mode utiliza un enfoque basado en sesiones a través de un archivo instagram_session.json que contiene las cookies de sesión para realizar tareas activas. Este modo permite a los agentes publicar stories y posts en el feed, gestionar mensajes directos mediante la herramienta instagram_get_inbox y recuperar métricas de cuentas profesionales de los últimos 30 días.
Para mantener la seguridad de la cuenta, el servidor incluye circuit breakers que detienen la ejecución si surgen desafíos de seguridad y limita el envío repetitivo de cadenas para evitar la detección de spam. La configuración requiere Python 3.10 o superior, Node.js 18.0 o superior y el CLI del motor twingraph.
Qué puedes hacer con él
- 1Investigación anónima de la competenciaUn agente puede analizar el perfil público y las tasas de engagement de un competidor sin iniciar sesión en una cuenta.
- 2Publicación automatizada de contenidoUn desarrollador puede instruir a una IA para publicar nuevas imágenes o stories directamente en un feed de Instagram.
- 3Gestión de consultas de clientesUn agente de IA puede monitorear y resumir los mensajes directos entrantes de la bandeja de entrada de un usuario.
- 4Analítica de cuentas profesionalesLos usuarios pueden obtener métricas de rendimiento detalladas y datos de audiencia para cuentas profesionales.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de instagram-use MCP 12
Detectado desde el 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 | — |
Configuración
INSTAGRAM_SESSION_PATH
| Nombre | Descripción | Tipo |
|---|---|---|
| INSTAGRAM_SESSION_PATH | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibledalroot/instagram-use is public and reachablegithub.com/dalroot/instagram-use ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-11github.com/dalroot/instagram-use ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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.
Preguntas sobre instagram-use MCP
¿Qué herramientas proporciona instagram-use MCP?
Expone 12 herramientas, incluidas instagram_publish_story, instagram_publish_post, instagram_send_message, instagram_get_inbox, instagram_post_comment.
¿Cómo protege el servidor mi cuenta de Instagram para evitar que sea baneada?
Utiliza una arquitectura de interruptores de seguridad (circuit breakers) que incluye mecanismos de cierre ante fallos en un solo intento y límites de deduplicación de cadenas para evitar la detección de spam.