instagram-mcp — MCP-сервер Instagram Graph API
Даёт агенту доступ к официальному Instagram Graph API: публикация, аналитика, комментарии и переписка по нескольким Business-аккаунтам. Работает без приватного API и паролей.
claude mcp add --env INSTAGRAM_MCP_ACCESS_TOKEN=<INSTAGRAM_MCP_ACCESS_TOKEN> --env INSTAGRAM_MCP_IG_USER_ID=<INSTAGRAM_MCP_IG_USER_ID> --transport stdio instagram-mcp -- uvx adelaidasofia-instagram-mcpЧто делает instagram-mcp
Сервер собран на официальном Graph API, поэтому бана за обход правил не будет. Внутри 29 инструментов: аккаунты, профиль и медиа, публикация постов, рилсов, каруселей и сторис, инсайты по аккаунту и постам, демография подписчиков, комментарии, поиск по хештегам, упоминания и бизнес-разведка по чужому публичному Professional-аккаунту. Публикация принимает только публичные https-ссылки на медиа: Instagram сам скачивает байты, поэтому файл должен лежать на доступном в интернете CDN.
Мультиаккаунт заложен с самого начала. Один сервер обслуживает ваш аккаунт, бренд и клиентский: у каждого свой токен, а add_account кладёт его в связку ключей macOS или в файл с правами chmod 600. Токены не возвращаются ни одним инструментом.
Что нужно заранее: Professional-аккаунт (Business или Creator), привязанная страница Facebook, долгоживущий токен с правами instagram_basic, instagram_content_publish, instagram_manage_comments, instagram_manage_insights и числовой id бизнес-аккаунта. Ещё Python 3.10+. Личный аккаунт Graph API не увидит, поэтому конвертация обязательна. Инструменты личных сообщений требуют права instagram_manage_messages, которое Meta выдаёт только через App Review, — до одобрения они падают с ошибкой, а не молчат.
Какие задачи решает
- опубликовать пост, рилс или карусель из ссылки на медиа
- снять охваты, сохранения и показы по конкретному посту
- посмотреть демографию подписчиков по возрасту и городам
- ответить на комментарий или скрыть его
- вести несколько брендовых аккаунтов из одной сессии
Примеры запросов агенту
- Опубликуй карусель из этих трёх ссылок в аккаунт brand-a
- Покажи охваты и сохранения последнего рилса
- Какая у нас демография подписчиков по городам?
Как установить instagram-mcp
Командой платформы
claude mcp add --env INSTAGRAM_MCP_ACCESS_TOKEN=<INSTAGRAM_MCP_ACCESS_TOKEN> --env INSTAGRAM_MCP_IG_USER_ID=<INSTAGRAM_MCP_IG_USER_ID> --transport stdio instagram-mcp -- uvx adelaidasofia-instagram-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from adelaidasofia-instagram-mcp <команда>
Командой платформы
codex mcp add instagram-mcp --env INSTAGRAM_MCP_ACCESS_TOKEN=<INSTAGRAM_MCP_ACCESS_TOKEN> --env INSTAGRAM_MCP_IG_USER_ID=<INSTAGRAM_MCP_IG_USER_ID> -- uvx adelaidasofia-instagram-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from adelaidasofia-instagram-mcp <команда>
Файл настроек
{
"mcpServers": {
"instagram-mcp": {
"command": "uvx",
"args": [
"adelaidasofia-instagram-mcp"
],
"env": {
"INSTAGRAM_MCP_ACCESS_TOKEN": "<INSTAGRAM_MCP_ACCESS_TOKEN>",
"INSTAGRAM_MCP_IG_USER_ID": "<INSTAGRAM_MCP_IG_USER_ID>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from adelaidasofia-instagram-mcp <команда>
Файл настроек
{
"servers": {
"instagram-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"adelaidasofia-instagram-mcp"
],
"env": {
"INSTAGRAM_MCP_ACCESS_TOKEN": "<INSTAGRAM_MCP_ACCESS_TOKEN>",
"INSTAGRAM_MCP_IG_USER_ID": "<INSTAGRAM_MCP_IG_USER_ID>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from adelaidasofia-instagram-mcp <команда>
Командой платформы
gemini mcp add -e INSTAGRAM_MCP_ACCESS_TOKEN=<INSTAGRAM_MCP_ACCESS_TOKEN> -e INSTAGRAM_MCP_IG_USER_ID=<INSTAGRAM_MCP_IG_USER_ID> instagram-mcp uvx adelaidasofia-instagram-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from adelaidasofia-instagram-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о instagram-mcp
Как установить instagram-mcp в Claude Code?
Одной командой: claude mcp add instagram-mcp -e INSTAGRAM_MCP_ACCESS_TOKEN=<INSTAGRAM_MCP_ACCESS_TOKEN> -- uvx adelaidasofia-instagram-mcp. Если нужен ещё и id аккаунта, используйте вариант с двумя --env: `claude mcp add --env INSTAGRAM_MCP_ACCESS_TOKEN=<INSTAGRAM_MCP_ACCESS_TOKEN> --env INSTAGRAM_MCP_IG_USER_ID=<INSTAGRAM_MCP_IG_USER_ID> --transport stdio instagram-mcp -- uvx adelaidasofia-instagram-mcp`.
Что делает instagram-mcp?
Подключает агента к официальному Instagram Graph API: чтение профиля и медиа, публикация, инсайты, комментарии, поиск по хештегам и упоминания. Всё работает по нескольким Business- или Creator-аккаунтам сразу.
Почему инструменты личных сообщений не работают?
Для них нужно право instagram_manage_messages, а его Meta даёт только после App Review. Пока приложение не одобрено, инструменты возвращают ошибку с этой подсказкой. После одобрения включите INSTAGRAM_MCP_DM_ENABLED=1.
