Mogut

MCP-сервер для анализа роста приложений в App Store (ASO) с доступом только на чтение для экосистемы Apple (iOS + Mac App Store).

Mogut никогда не записывает данные в App Store. Действия по записи передаются готовыми к выполнению вызовами инструментов Heimdall, которые одобряет пользователь.

1.0: 47 инструментов работают с 13 живыми источниками данных, включая оркестраторы отчётов. report_app формирует полный отчёт по приложению одним вызовом; периодические уровни (ежедневный/еженедельный/ежемесячный) формируют дельты на основе локальной истории. См. CHANGELOG.md.

Установка

npm install -g mogut
mogut setup

Мастер установки регистрирует Mogut в найденных MCP-клиентах (Claude Code, Desktop, Codex, Cursor, VS Code, Windsurf, Antigravity) — после этого один раз перезапустите клиент.

Мастер хранит учётные данные в macOS Keychain (com.milowda.credentials) с запасным вариантом .env. Секреты вводятся только в терминале — никогда в чате, никогда не логируются и не отображаются. См. SECURITY.md.

Related MCP server: ASO Score MCP

Конфигурация MCP

{
  "mcpServers": {
    "mogut": { "command": "mogut", "args": [] }
  }
}

По умолчанию доступны девять инструментов: шесть мета-инструментов mogut_* и три оркестратора отчётов (report_app, report_competitor_deep, report_comparison; четвёртый — report_actions, появится в v1.1). Всё остальное подключается по профилям: задайте MOGUT_PROFILES="keyword,competitor" (или "all"). mogut_search_tools находит инструмент и сообщает, какой профиль его включает. Сценарии работы описаны в GUIDE.md.

Как выглядит результат

Каждый инструмент возвращает данные (structuredContent) и инструкцию по формированию ответа для модели-хоста — статистика вычисляется в коде и никогда не делегируется модели. Каждый результат содержит source, confidence и lastUpdated; усечение видно (указываются количества полученных и проанализированных записей); тексты отзывов и данные конкурентов помечены как непроверенные данные. Сбойный источник превращается в явно пропущенный раздел, но никогда не выдуманное число.

Уровни

mogut_status показывает текущий уровень, проверяет учётные данные в реальном времени (verify: true) и ведёт обратный отсчёт до 180-дневной ротации ключа Apple Ads.

Какая роль App Store Connect что открывает

Лента начинает отдавать данные только после этого единственного запроса. Mogut никогда не отправляет его из MCP-интерфейса: запустите в терминале npx mogut analytics enable --app <id> (будет запрошен путь к Admin .p8; файл используется в памяти и нигде не сохраняется) или --print-only, чтобы вывести запрос для показа тому, у кого есть права Admin. Команда disable отменяет действие.

Дополнительно: индекс популярности Apple Ads

В официальном API Apple Ads нет индекса популярности (проверено вживую: POST /api/v5/keywords/popularities → 404). Число, которое показывает интерфейс Ads, приходит из недокументированной конечной точки, аутентифицирующейся через веб-сессию, а не через OAuth. Mogut умеет его считывать, но мастер не запрашивает эти данные: это вставленный cookie браузера, он истекает, и его использование — серая зона с точки зрения правил Apple Ads. Без него keyword_popularity_fetch использует прокси-оценку с пометкой «низкая достоверность».

Если вы всё же хотите использовать его:

1. Войдите на https://app-ads.apple.com и откройте любой экран кампании.

2. Откройте devtools → Network, задайте фильтр /cm/api и нажмите на любой запрос.

3. Скопируйте из этого запроса весь заголовок Cookie.

4. export MOGUT_APPLE_ADS_SESSION='<the cookie header>' в окружении, где ваш MCP-клиент запускает Mogut, либо сохраните его в учётной записи apple-ads-session службы Keychain com.milowda.credentials.

Повторите процедуру, когда сессия истечёт. mogut_discover_sources покажет источник как down, как только эндпоинт начнёт отклонять запросы.

Как выглядит отчёт

report_app формирует полный отчёт по требованию; daily_digest, weekly_change_report и monthly_status_report формируют периодические уровни, читая дельты из той же локальной истории. Анонимизированные эталонные примеры: EXAMPLE_REPORT_FULL.md · EXAMPLE_REPORT_PERIODIC.md.

Разработка

npm install && npm run build && npm test

Добавляете источник данных? Прочтите CONTRIBUTING.md — контракт адаптера и требования к фикстурам проверяются тестами.

src/core/catalog.ts генерируется из docs/TOOL_CATALOG.md — перегенерируйте командой node scripts/gen-catalog.mjs.

MIT.