Mogut

Ein Nur-Lese-MCP-Server für die App-Store-Wachstumsanalyse (ASO) im Apple-Ökosystem (iOS + Mac App Store).

Mogut schreibt nie in den App Store. Schreibvorgänge werden als sofort ausführbare Heimdall-Tool-Aufrufe übergeben, die der Benutzer genehmigt.

1.0: 47 Tools über 13 Live-Datenquellen, gipfelnd in den Report-Orchestratoren. report_app erzeugt den vollständigen App-Report in einem einzigen Aufruf; die periodischen Stufen (täglich/wöchentlich/monatlich) melden Differenzen aus der lokalen Historie. Siehe CHANGELOG.md.

Install

npm install -g mogut
mogut setup

Der Assistent registriert Mogut bei den MCP-Clients, die er findet (Claude Code & Desktop, Codex, Cursor, VS Code, Windsurf, Antigravity) — starten Sie den Client danach neu.

Der Assistent speichert Anmeldedaten im macOS-Keychain (com.milowda.credentials) mit einem .env-Fallback. Geheime Werte werden ausschließlich im Terminal eingegeben – nie im Chat, nie protokolliert, nie angezeigt. Siehe SECURITY.md.

Related MCP server: ASO Score MCP

MCP-Konfiguration

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

Standardmäßig sind neun Tools freigeschaltet: sechs mogut_*-Meta-Tools plus die drei Report-Orchestratoren (report_app, report_competitor_deep, report_comparison – der vierte, report_actions, kommt in v1.1). Alles andere ist wahlweise pro Profil aktivierbar (opt-in): Setzen Sie MOGUT_PROFILES="keyword,competitor" (oder "all"). mogut_search_tools findet ein Tool und zeigt an, welches Profil es aktiviert. Die Abläufe sind in GUIDE.md beschrieben.

Wie ein Ergebnis aussieht

Jedes Tool liefert die Daten zurück (structuredContent) plus eine Schreibanweisung für das Host-Modell – Statistiken werden im Code berechnet, nie dem Modell überlassen. Jedes Ergebnis enthält source, confidence und lastCheckedAt; Kürzungen sind sichtbar (abgerufene/analysierte Anzahl); Rezensionen und Wettbewerbertexte sind als nicht vertrauenswürdige Daten markiert. Eine defekte Quelle wird zu einem sichtbar übersprungenen Abschnitt, niemals zu einer erfundenen Zahl.

Stufen

mogut_status zeigt die aktuelle Stufe an, prüft Anmeldedaten live (verify: true) und zählt die 180-Tage-Schlüsselrotation von Apple Ads herunter.

Welche App Store Connect-Rolle schaltet was frei

Der Feed liefert erst nach diesem einmaligen POST Daten. Mogut sendet den nie über die Bereitstellung. Die v1: " findet hierzu npx mogut analytics enable --app <id> im Terminal (fragt nach dem Pfad zu einer .p8-Datei mit Admin-Zugit, nutzt sie im Speicher und speichert nichts), oder verwenden Sie --print-only, um die Anfrage für die Person mit Admin-Rechten auszugeben. disable macht das rückgängig.

Erweiterung: Apple-Ads-Beliebtheitsindex

Die offizielle Apple-Ads-API hat keinen Beliebtheitsindex (praxi überprüft: POST /api/v5/keywords/popularities → 404). Die Zahl, die die Ads-Benutzerfläche anzeigt, stammt von einem undokumentierten Endpunkt, der sich mit Web-Session und nicht mit OAuth authentifiziert. Mogut kann ihn lesen, aber der Assistent fragt nicht danach: Es ist ein eingefügter Browser-Cookie, der abläuft, und die Nutzung ist eine Grauzone hinsichtlich der Apple-Ads-Bedingungen. Ohne ihn fällt keyword_popularity_fetch auf auf einen niedrigen Vertrauensbereich (Proxy-Score mit geringer Konfidenz) zurück.

Falls du es auch möchtest:

1. Melden Sie sich bei https://app-ads.apple.com an und öffnen einen beliebigen Kampagnen-Bildschirm.

2. Öffnen Sie DevTools → Network, filtern Sie nach /cm/api und klicken Sie auf eine dieser Kurse.

3. Kopieren Sie den gesamten Cookie-Request-Header dieser Anfrage.

4. export MOGUT_APPLE_ADS_SESSION='<the cookie header>' in der Umgebung, aus der Ihr MCP-Client Mogut startet — oder speichern Sie ihn unter dem Konto apple-ads-session des Keychain-Dienstes com.milowda.credentials.

Wiederholen Sie das, wenn die Sitzung abläuft. mogut_discover_project zeigt die Quelle als down, sobald der Endpunkt sie ablehnend.

Wie ein Bericht aussieht

report_app erzeugt den vollständigen Bericht bei Bedarf; daily_digest, weekly_change_report und monthly_status_report erzeugen die periodischen Stufen und lesen Differenzen aus derselben lokalen Historie. Anonymisierte Musterbeispiele für beide Fälle: EXAMPLE_REPORT_FULL.md · EXAMPLE_REPORT_PERIODIC.md.

Entwicklung

npm install && npm run build && npm test

Neue Datenquelle? Lesen Sie CONTRIBUTING.md — der Adaptervertrag und die Fixture-Anforderung werden durch Tests erzwungen.

src/core/catalog.ts wird aus docs/TOOL_CATALOG.md generiert — regenerieren Sie sie mit node scripts/gen-catalog.mjs.

MIT.