Mogut

Apple エコシステム（iOS + Mac App Store）向けの、読み取り専用の App Store グロース分析（ASO）進 MCP サーバー。

Mogut は App Store に書き込むことは決してありません。書き込み操作は、ユーザーが承認する実行可能な Heimdall ツール呼び出しとして引き渡されます。

1.0：13 のライブデータソースにわたる 47 個のツールを、レポート オーケストレーターで締めくくります。 report_app は 1 回の呼び出しで完全な App Report を生成します。定期ティア （daily/weekly/monthly）はローカル履歴から差分をレポートします。CHANGELOG.md を参照してください。

インストール

npm install -g mogut
mogut setup

ウィザードは、検出した MCP クライアント（Claude Code & Desktop、Codex、Cursor、VS Code、Windsurf、Antigravity）に Mogut を登録します。その後、クライアントを一度再起動してください。

ウィザードは、資格情報を macOS キーチェーン（com.milowda.credentials）に保存し、フォールバックとして .env を使用します。シークレットはターミナルでのみ入力されます。チャットで入力されることはなく、記録されず、表示されることもありません。SECURITY.md を参照してください。

Related MCP server: ASO Score MCP

MCP 設定

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

既定では 9 つのツールが公開されています。つまり、6 つの mogut_* メタツールと 3 つのレポート オーケストレーター（report_app、report_competitor_deep、report_comparison。4 つ目の report_actions は v1.1 で登場します）です。それ以外はすべてプロファイルごとに採択ーです。MOGUT_PROFILES="keyword,competitor"（または "all"）を設定してください。mogut_search_tools はツールを検索し、どのプロファイルがそれを有効化するかを通知します。フローは GUIDE.md で説明されています。

結果の外観

すべてのツールはデータ（structuredContent）と、ホストモデルへのライティング指示を返します。統計はコードで計算され、モデルに委任されることはありません。すべての結果には source、confidence、lastCheckedAt が含まれます。切り詰めが行われた場合も確認できます（フェッチ済み/分析済みの数）。レビューと競合他社のテキストは信頼できないデータとしてマークされます。破損したソーツは目に見えてスキップされたセクションになり、数値をでっち上げることはありません。

ティア

mogut_status は現在のティアを表示し、資格情報をライブで検証し（verify: true）、180 日ごとの Apple Ads キーローテーションまでの残り日数をカウントダウンします。

App Store Connect のどのロールが何を利用可能にするか

フィードはその 1 回の POST の後にのみデータを生成します。Mogut は MCP サーフェスからこれを送信することはありません。ターミナルで npx mogut analytics enable --app <id> を実行してください（Admin の側 .p8 ファイルへのパスを求め、メモリ上でのみ使用し、何も保存しません）。または --print-only で、Admin を持つ人に見せるためのリクエストを出力できます。disable で元に戻します。

上級：Apple Ads の人気指数

公式の Apple Ads API には人気指数はありません（ライブ運用で確認済み：POST /api/v5/keywords/popularities → 404）。Ads UI に表示される数値は、OAuth ではなくウェブセッションで認証する文書化されていないエンドポイントに由来します。Mogut はそれを読むことができますが、セッションはブラウザから貼り付けた Cookie であり、有効期限があり、Apple Ads の規約に照らすとグレーゾーンであるため、ウィザードはそれを使い求めることはありません。それがなくても、keyword_popularity_fetch は低信頼度とマークされたプロキシスコアにフォールバックします。

どうしても使いたい場合:

1. https://app-ads.apple.com にログインし、キャンペーン画面を開きます。

2. 開発者ツール → Network を開き、/cm/api でフィルタリングして、1 つのリクエストをクラルクリックします。

3. そのリクエストの Cookie リクエストヘッダー全体をコピーピーします。

4. export MOGUT_APPLE_ADS_SESSION='<the cookie header>' を、MCP クライアントが Mogut を起動する環境で設定します — または com.milowda.credentials キーチェーンサービスの apple-ads-session アカウントに保存します。

セッションの期限が切れたら、もう一度やり直します。mogut_discover_sources启动 は、エンドポイントが拒否し始めると、そのソースを down として表示します。

レポートの詳細

report_app はオンデマンドの完全レポートを生成します。daily_digest、weekly_change_report、month_status、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。