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

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

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

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

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

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

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

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

---

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

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

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

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

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

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

---

## Что получишь

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

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

Полный список инструментов метода 1: [docs/TOOLS.md](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](docs/SECURITY.md).
- **Читать и собирать можно широко** — свой аккаунт полностью и чужой **публичный** контент для анализа. А вот **действовать «ботом» по чужим** (лайки, комментарии, подписки, DM, публикации) — не для этого: массовые автодействия ведут к бану. Полное позиционирование: [«Ответственное использование»](docs/SECURITY.md#ответственное-использование).
- Чужой контент качаем для **своего анализа**, не выдаём за своё и не перезаливаем.
- Отозвать доступ метода 1 мгновенно: Instagram → Настройки → Безопасность → Приложения и сайты.

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

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

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

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

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

## Диагностика

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

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

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

## Лицензия

[MIT](LICENSE). Автор: [Александр Фисенков](https://github.com/alexfisenkov). Родственный проект: [telegram-mcp-starter](https://github.com/alexfisenkov/telegram-mcp-starter). Нашли ошибку или хотите улучшить — Issue или Pull Request.