Servidor MCP de Instagram

Un servidor MCP que proporciona a los agentes de IA acceso a las analíticas e información de cuentas de Instagram Business.

Herramientas

Related MCP server: Instagram Complete MCP Server

Configuración

cd instagram-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install "mcp[cli]" httpx

Crea un archivo .env con tus credenciales:

INSTAGRAM_ACCESS_TOKEN=your_token
INSTAGRAM_ACCOUNT_ID=17841...

Obtención de tus credenciales de Instagram

1. Ve a Meta for Developers y crea una aplicación (tipo: Business)

2. Añade el producto Instagram Graph API a tu aplicación

3. En el Explorador de Graph API (developers.facebook.com/tools/explorer):

   • Selecciona tu aplicación en el menú desplegable

   • Haz clic en Generate Access Token

   • Concede los permisos: instagram_basic, instagram_manage_insights, pages_show_list, pages_read_engagement

4. Obtén tu ID de cuenta de Instagram Business:

   • En el Explorador de Graph API, consulta: me/accounts para obtener tu ID de página

   • Luego consulta: {page-id}?fields=instagram_business_account

   • El campo id en la respuesta es tu INSTAGRAM_ACCOUNT_ID

5. El token del Explorador es de corta duración (1 hora). Para obtener un token de larga duración:

   • Intercámbialo en: oauth/access_token?grant_type=fb_exchange_token&client_id={app-id}&client_secret={app-secret}&fb_exchange_token={short-lived-token}

   • Esto te proporciona un token de 60 días

Nota: Tu cuenta de Instagram debe ser una cuenta Business o de Creador vinculada a una página de Facebook.

Uso con Claude Code

claude mcp add instagram-mcp -e INSTAGRAM_ACCESS_TOKEN=your_token -e INSTAGRAM_ACCOUNT_ID=17841... -- python3 -m src.server

Luego, pregunta a Claude cosas como:

• "¿Cuáles son mis publicaciones con mejor rendimiento este mes?"

• "Muéstrame los datos demográficos de mi audiencia"

• "¿Qué publicaciones obtuvieron más guardados?"

• "¿Cuál es la tendencia de mi tasa de interacción?"

Agente estratega de contenido

Un agente independiente que analiza tus datos de Instagram y genera un plan de contenido semanal con 7 ideas de publicaciones, pies de foto y horarios de publicación.

Ejecución del agente

source .venv/bin/activate
python -m agent.content_strategist

Requiere credenciales de AWS configuradas (utiliza Anthropic Bedrock) y las mismas variables .env que el servidor MCP. El agente:

1. Extraerá la información de tu cuenta, publicaciones recientes, publicaciones principales y datos demográficos de la audiencia

2. Identificará patrones en lo que está funcionando bien

3. Generará un plan de contenido de 7 días con pies de foto, hashtags y horarios específicos

4. Guardará el plan como un archivo HTML y lo abrirá en tu navegador