jlbadano/ig-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

203 stars 56 forks Качество 73 Тренд 18MIT

Repository Install

jlbadano/ig-mcp — это кандидат на сервер MCP, импортированный из https://github.com/jlbadano/ig-mcp.

Обзор

jlbadano/ig-mcp — это кандидат на сервер MCP, импортированный из https://github.com/jlbadano/ig-mcp.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP), обеспечивающий бесшовную интеграцию с API Graph от Instagram, позволяя приложениям искусственного интеллекта программно взаимодействовать с бизнес-аккаунтами Instagram.

Особенности

🔧 Инструменты (управляемые моделями)

Получить информацию о профиле: Получить данные бизнес-профиля в Instagram
Получить медиа-посты: Получить свежие посты с аккаунта в Instagram
Получить медиа-аналитику: Получить метрики вовлечённости для конкретных публикаций
Публиковать медиа: Загружать и публиковать изображения/видео в Instagram
Получить страницы аккаунта: Перечислить страницы Facebook, связанные с аккаунтом
Получить беседы: Перечислить личные сообщения в Instagram (требуется расширенный доступ)
Получить сообщения в разговоре: Читать сообщения из конкретных разговоров (требуется расширенный доступ)
Отправить личные сообщения: Ответить на личные сообщения Instagram (требуется расширенный доступ)

📊 Ресурсы (управляются приложением)

Данные профиля: доступ к информации профиля, включая количество подписчиков, биографию и т.д.
Медиа-лента: Недавние публикации с метриками вовлечённости
Insights Data: Подробная аналитика публикаций и эффективности аккаунта

💬 Подсказки (управляются пользователем)

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Instagram MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Instagram’s Graph API, enabling AI applications to interact with Instagram Business accounts programmatically.

Features

🔧 Tools (Model-controlled)

Get Profile Info: Retrieve Instagram business profile details
Get Media Posts: Fetch recent posts from an Instagram account
Get Media Insights: Retrieve engagement metrics for specific posts
Publish Media: Upload and publish images/videos to Instagram
Get Account Pages: List Facebook pages connected to the account
Get Conversations: List Instagram DM conversations (requires Advanced Access)
Get Conversation Messages: Read messages from specific conversations (requires Advanced Access)
Send DM: Reply to Instagram direct messages (requires Advanced Access)

📊 Resources (Application-controlled)

Profile Data: Access to profile information including follower counts, bio, etc.
Media Feed: Recent posts with engagement metrics
Insights Data: Detailed analytics for posts and account performance

💬 Prompts (User-controlled)

Analyze Engagement: Pre-built prompt for analyzing post performance
Content Strategy: Template for generating content recommendations
Hashtag Analysis: Prompt for hashtag performance evaluation

Prerequisites

Instagram Business Account: Must be connected to a Facebook Page
Facebook Developer Account: Required for API access
Access Token: Long-lived access token with appropriate permissions
Python 3.10+: For running the MCP server (required by MCP dependencies)

Required Instagram API Permissions

Standard Access (available immediately):

instagram_basic
instagram_content_publish
instagram_manage_insights
instagram_manage_comments
pages_show_list
pages_read_engagement
pages_manage_metadata
pages_read_user_content
business_management

Advanced Access (requires Meta App Review):

instagram_manage_messages - Required for Direct Messaging features

⚠️ Instagram DM Features: Reading and sending Instagram direct messages requires Advanced Access approval from Meta. See INSTAGRAM_DM_SETUP.md for the App Review process.

🔑 How to Get Instagram API Credentials

📖 Quick Start: See AUTHENTICATION_GUIDE.md for a 5-minute setup guide!

This section provides a step-by-step guide to obtain the necessary credentials for the Instagram MCP server.

Step 1: Set Up Instagram Business Account

Convert to Business Account (if not already):
- Open Instagram app → Settings → Account → Switch to Professional Account

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "instagram": {
      "command": "python",
      "args": ["/path/to/ig-mcp/src/instagram_mcp_server.py"],
      "env": {
        "INSTAGRAM_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}