Instagram MCP Starter — подключи Instagram к Claude и другим агентам

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

Ты подключаешь и авторизуешь СВОЙ аккаунт — на СВОЁМ компьютере, со СВОИМИ ключами (в проекте не зашит ничей чужой аккаунт). Инструменты открытые: помимо полной работы со своим аккаунтом, ими можно вести разведку по чужим публичным аккаунтам — собирать общедоступную статистику и контент конкурентов для анализа. Рамки — в «Ответственном использовании».

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

Дай своему AI-агенту (лучше всего Claude Code / Codex — у них есть терминал) одну фразу:

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

Агент сам разберётся, какие методы тебе нужны, всё установит (чего не хватит — доустановит или скажет одной командой), продиктует, где что нажать, проведёт авторизацию и проверит. Дальше всё — просто в переписке с агентом. Установщик ниже — необязательный запасной путь для тех, кто любит руками.

Открыто и видоизменяемо. Форкай, меняй, комбинируй методы и инструменты под свои задачи — ничего не зашито намертво.

Related MCP server: instagram-mcp

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

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

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

Плюс разведка по конкурентам — methods/04-research.md: собрать общедоступную статистику и скачать контент чужих публичных аккаунтов, расшифровать видео, разобрать покадрово, проанализировать карусели/подписи/комментарии — чтобы понять, почему у них заходит, и перенести приёмы на свой контент.

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

Что получишь

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

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

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

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

• «Собери 20 самых заходящих Reels конкурента @account, расшифруй их и выдели общие приёмы» (разведка)

• «Сравни подписи и первые 3 секунды вирусных роликов в нише и предложи структуру под мой контент» (разведка)

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

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

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

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

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

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

• Читать и собирать можно широко — свой аккаунт полностью и чужой публичный контент для анализа. А вот действовать «ботом» по чужим (лайки, комментарии, подписки, DM, публикации) — не для этого: массовые автодействия ведут к бану. Полное позиционирование: «Ответственное использование».

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

• Отозвать доступ метода 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. Автор: Александр Фисенков. Родственный проект: telegram-mcp-starter. Нашли ошибку или хотите улучшить — Issue или Pull Request.