Instagram MCP Starter — подключи свой Instagram к Claude

Твой AI-агент читает и анализирует статистику твоего Instagram. От базовой аналитики через официальный API до самой глубокой статистики, которая есть только в приложении на телефоне.

Каждый подключает СВОЙ аккаунт — на СВОЁМ компьютере, со СВОИМИ ключами. В этом проекте нет ничьего чужого Instagram: команда «подключи мой Instagram» ниже адресована твоему агенту и означает «аккаунт, в который залогинен ты». Чужие данные сюда не зашиты.

🤖 Настройку делает твой агент, а не ты

Скажи своему Claude (лучше всего Claude Code):

«Прочитай https://raw.githubusercontent.com/alexfisenkov/instagram-mcp-starter/main/AGENT.md и подключи мой Instagram по этой инструкции»

Агент сам разберётся, какие методы тебе нужны, всё установит, продиктует, где что нажать, и проверит результат.

Related MCP server: Instagram MCP Server

Три метода — от простого к глубокому

Аналитику Instagram нельзя достать из одного источника целиком. Поэтому здесь три метода, и они дополняют друг друга. Начни с первого, добавляй следующие по мере надобности.

Полный путь для максимальной аналитики: метод 1 (база) → метод 2 (архив контента и то, что вне API) → метод 3 (глубина, которая только в приложении). Хочешь понять, что работает, а что нет, работают ли сценарии, где зритель отваливается — тебе нужны все три.

Обзор и когда что применять: methods/README.md.

Что получишь

После подключения говоришь Claude обычным языком:

• «Какие 5 постов за месяц собрали больше всего вовлечённости?» (метод 1)

• «Скачай все мои Reels за квартал и собери базу с расшифровками для анализа сценариев» (метод 2)

• «Открой статистику последнего Reels на телефоне и покажи, на какой секунде отваливается аудитория» (метод 3)

• «Сравни удержание трёх последних Reels и скажи, какой сценарий держит лучше» (метод 3)

Полный список инструментов метода 1: docs/TOOLS.md.

Что понадобится

Всё сопутствующее (браузерный тулинг, Appium, драйверы, adb) агент и установщики ставят сами — см. методы 2 и 3.

⚠️ Безопасность — коротко

• Всё локально: серверы и инструменты работают на твоём компьютере.

• App Secret (~/.instagram-mcp/instagram.env) и токен (~/.config/meta-instagram-mcp/token.json) — ключи доступа. Не пересылать, не коммитить, не показывать. Подробно: docs/SECURITY.md.

• Методы 2 и 3 — только для твоего аккаунта и только чтение (никаких лайков, комментариев, публикаций от бота). Автоматизация действий в чужих аккаунтах и массовые действия — прямой путь к бану и здесь сознательно не поддерживаются.

• Отозвать доступ метода 1 мгновенно: Instagram → Настройки → Безопасность → Приложения и сайты.

Установка (метод 1, база)

Метод 1 ставится одной командой; методы 2 и 3 добавляются поверх (их инструкции — в methods/).

# macOS / Linux
bash <(curl -fsSL https://raw.githubusercontent.com/alexfisenkov/instagram-mcp-starter/main/install.sh)

# Windows (PowerShell)
irm https://raw.githubusercontent.com/alexfisenkov/instagram-mcp-starter/main/install.ps1 | iex

Ключи для метода 1: docs/01-meta-app.md · Авторизация: docs/02-oauth.md. Удаление: uninstall.sh / uninstall.ps1.

Диагностика

# macOS / Linux
node ~/.instagram-mcp/app/doctor.mjs ~/.instagram-mcp/run.sh

# Windows
node "$env:USERPROFILE\.instagram-mcp\app\doctor.mjs" cmd /c "$env:USERPROFILE\.instagram-mcp\run.cmd"

Типовые проблемы: docs/TROUBLESHOOTING.md · Вопросы: docs/FAQ.md

Лицензия

MIT. Автор: Александр Фисенков, проект «Ai МАСТЕРСКАЯ». Родственный проект: telegram-mcp-starter.