Mogut

Servidor MCP de solo lectura para el análisis de crecimiento de App Store (ASO), para el ecosistema de Apple (iOS + Mac App Store).

Mogut nunca escribe en la App Store. Las acciones de escritura se entregan como llamadas a herramientas Heimdall listas para ejecutar, que el usuario aprueba.

1.0: 47 herramientas repartidas en 13 fuentes de datos en vivo, que culminan en los orquestadores de informes. report_app produce el informe completo de la app en una sola llamada; los niveles periódicos (diario/semanal/mensual) reportan los deltas desde el historial local. Consulta CHANGELOG.md.

Instalación

npm install -g mogut
mogut setup

El asistente registra Mogut con los clientes MCP que encuentre (Claude Code & Desktop, Codex, Cursor, VS Code, Windsurf, Antigravity) — después reinicia el cliente una vez.

El asistente guarda las credenciales en el Keychain de macOS (com.milowda.credentials) con un respaldo en .env. Los secretos se introducen únicamente en la terminal — nunca en el chat, nunca quedan registrados, nunca se muestran. Consulta SECURITY.md.

Related MCP server: ASO Score MCP

Configuración de MCP

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

Nueve herramientas están expuestas por defecto: seis metaherramientas mogut_* más los tres orquestadores de informes (report_app, report_competitor_deep, report_comparison — la cuarta, report_actions, llega en la v1.1). Todo lo demás se activa opcionalmente por perfil: define MOGUT_PROFILES=\"keyword,competitor\" (o \"all\"). mogut_search_tools encuentra una herramienta y te indica qué perfil la habilita. Los flujos se describen en GUIDE.md.

Cómo es un resultado

Cada herramienta devuelve datos (structuredContent) además de una instrucción de redacción para el modelo anfitrión: las estadísticas se calculan en el código, nunca se delegan al modelo. Cada resultado incluye source, confidence y lastCheckedAt; la limitación de datos es visible (recuentos obtenidos/analizados); el texto de reseñas y competidores se marca como datos no fiables. Una fuente que falla se convierte en una sección visiblemente omitida, nunca en un número inventado.

Niveles

mogut_status muestra el nivel actual, verifica las credenciales en vivo (verify: true) y hace la cuenta atrás para la rotación de la clave de Apple Ads de 180 días.

Qué desbloquea cada rol de App Store Connect

El canal solo genera datos después de ese único POST. Mogut nunca lo envía desde la interfaz MCP: ejecuta npx mogut analytics enable --app <id> en la terminal (pide la ruta de un .p8 de Admin, lo usa en memoria y no guarda nada), o usa --print-only para imprimir la solicitud para quien tenga Admin. disable lo deshace.

Avanzado: índice de popularidad de Apple Ads

La API oficial de Apple Ads no tiene índice de popularidad (verificado en vivo: POST /api/v5/keywords/popularities → 404). El número que muestra la interfaz de Apple Ads proviene de un endpoint no documentado que se autentica con una sesión web, no con OAuth. Mogut puede leerlo, pero el asistente no lo pide: es una cookie del navegador pegada, expira y usarla es una zona gris respecto a los términos de Apple Ads. Sin ello, keyword_popularity_fetch recurre a una puntuación proxy marcada como de baja confianza.

Si quieres usarla de todos modos:

1. Inicia sesión en https://app-ads.apple.com y abre cualquier pantalla de campaña.

2. Abre devtools → Network, filtra por /cm/api y haz clic en una solicitud.

3. Copia entera la cabecera de solicitud Cookie de esa petición.

4. export MOGUT_APPLE_ADS_SESSION='<the cookie header>' en el entorno desde el que tu cliente MCP lanza Mogut — o guárdala en la cuenta apple-ads-session del servicio de Keychain com.milowda.credentials.

Repítelo cuando la sesión expire. mogut_discover_sources muestra la fuente como down en cuanto el endpoint empiece a rechazar.

Cómo es un informe

report_app genera el informe completo bajo demanda; daily_digest, weekly_change_report y monthly_status_report generan los niveles periódicos, leyendo los deltas del mismo historial local. Ejemplos de oro anonimizados de ambos: Informe_COMPLETO_Ejemplo.md
Informe_PERIODICO_Ejemplo.md.

Desarrollo

npm install && npm run build && npm test

¿Añades una fuente de datos? Lee CONTRIBUTING.md — el contrato del adaptador y el requisito de fixtures se aplican mediante tests.

src/core/catalog.ts se genera a partir de docs/TOOL_CATALOG.md — regérales con node scripts/gen-catalog.mjs.

MIT.