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 по этой инструкции»

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

---

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

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

	Метод	Что даёт	Чем берём	Риск для аккаунта
1	Официальный API (methods/01-official-api.md)	Аккаунт, посты, охваты, инсайты, комментарии — стабильно и безопасно	Meta Graph API (этот MCP-сервер)	Нет (официальный путь)
2	Залогиненный браузер (methods/02-browser.md)	То, чего нет в API: полный архив контента, скачивание своих постов/Reels/каруселей, сбор базы для анализа сценариев	Твой браузер, где ты уже вошёл в Instagram (встроенный агентский или внешний Chrome)	Низкий, если только читать/скачивать своё
3	Телефон (iOS/Android) (methods/03-phone.md)	Самая глубокая статистика: удержание по секундам, когда зрители отваливаются, аудитория, — этого нет НИГДЕ, кроме приложения	Управление своим телефоном (iOS: Appium + WebDriverAgent; Android: adb + Appium)	Средний — read-only, свой аккаунт, свой телефон

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

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

---

Что получишь

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

• «Какие 5 постов за месяц собрали больше всего вовлечённости?» (метод 1)
• «Скачай все мои Reels за квартал и собери базу с расшифровками для анализа сценариев» (метод 2)
• «Открой статистику последнего Reels на телефоне и покажи, на какой секунде отваливается аудитория» (метод 3)
• «Сравни удержание трёх последних Reels и скажи, какой сценарий держит лучше» (метод 3)

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

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

#	Что	Для каких методов
1	Instagram профессионального типа (Бизнес/Автор)	всех (переключение бесплатно: Instagram → Настройки → Тип аккаунта)
2	Node.js 20+	1, 2, 3 (установщик поможет)
3	Аккаунт Facebook + страница, привязанная к Instagram	1 (есть альтернатива без страницы)
4	Браузер, где ты залогинен в Instagram	2
5	Твой телефон + кабель (iOS: нужен Mac с Xcode; Android: любой ПК)	3

Всё сопутствующее (браузерный тулинг, 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.