Sonar — ASO for AI agents

@sonarapp/mcp

公式の Sonar MCP サーバー — AI エージェント向けのアプリストア最適化ツールです。

ホスト型の Grok Build and Cursor marketplace plugin については、 プラグインのセットアップ、認証、権限をご覧ください。

Claude Desktop、Claude Code、Cursor、Cline、およびあらゆるModel Context Protocol互換クライアントから、iOS App Store と Google Play のアプリの検索、キーワード調査、ASO 監査、レビュー分析、収益予測を利用できます。Sonarを利用しています。

---

ツール

Sonar REST API 全体を網羅する 55 個のツールを、必要なプラン別に分類しています。

読み取りツール — ステートレス（クレジットのある任意のプラン）

ツール	機能	キーなしで利用可能
sonar_app_lookup	ストア ID でアプリのメタデータを検索	はい
sonar_app_search	キーワードでアプリを検索（ストアのランキング順で返します）	はい
sonar_app_aso_score	項目別チェック付きの ASO 監査スコア（0～100）	はい
sonar_app_extract_keywords	アプリの掲載情報からターゲットキーワードを抽出	はい
sonar_app_reviews	評価フィルターと並べ替えオプションを指定してレビューを取得	—
sonar_app_revenue	信頼度評価付きで月間収益を推定	—
sonar_keyword_search	キーワード調査（難易度、人気度、関連語）	—
sonar_keyword_metrics	指定キーワードの難易度と人気度（1 回の呼び出しにつき最大 25 件）	はい（1 日 5 キーワード）
sonar_keyword_suggestions	ストアのオートコンプリート候補	はい
sonar_top_charts	前日比の順位変動付き、無料／有料／売上上位チャート	はい

ステートレスツールは、iOS と Android の両方で、クレジットのある任意のプラン（API Credits、Indie、Agency）で利用できます。「はい」と記載されたツールは、無料プランでもキーなしで利用できます（下記の「無料で試す」をご覧ください）。

読み取りツール — ワークスペース（Indie プラン）

ツール	機能
sonar_list_products	ストアにリンクされたバージョンと競合数を含む、製品の一覧
sonar_list_apps	最新のスナップショット（評価、レビュー、インストール数）を含む、追跡中のアプリ一覧
sonar_get_app	アプリの詳細と最大 90 日分のスナップショット履歴
sonar_app_overview	アプリのダッシュボード概要：可視性、シェア・オブ・ボイス、変動、機会
sonar_app_keywords	アプリで追跡中のキーワード。難易度、人気度、メモ、スター付き
sonar_app_rankings	アプリの追跡キーワードの日次順位履歴
sonar_app_changes	リリース、メタデータ編集、スクリーンショット／価格／カテゴリの変更を検出
sonar_keyword_rankings	追跡中のキーワードの SERP 履歴（誰がいつランクインしたか）
sonar_discovered_keywords	Sonar がアプリについて発見した未追跡キーワードを、機会順に表示
sonar_competitor_keywords	競合がランクインしているキーワードと、自社アプリとのギャップ分析
sonar_competitor_landscape	すべての競合とのギャップ、脅威、見込み、および最新の AI インサイト
sonar_review_insights	最新の AI レビュー分析：称賛／苦情のテーマ、引用、傾向
sonar_list_alerts	アラートルール（種類、対象範囲、しきい値、有効／無効）の一覧
sonar_alert_events	検出されたアラートイベント（順位変動、評価低下、レビュー急増）を新しい順に表示

ワークスペースの読み取りには Indie プラン以上が必要です（有効なトライアルも対象です）。デフォルトの read スコープのキーで十分です。

読み取りツール — Agency プラン

ツール	機能
sonar_portfolio	ポートフォリオの集計：アプリごとの KPI、最も大きな変動、要注意リスト、主な機会
sonar_app_sales	App Store Connect の売上：ダウンロード、再ダウンロード、IAP のユニット数、概算収益
sonar_app_engagement	App Store Connect のファネル：インプレッション、ページビュー、ダウンロード、流入元、セッション

これらのツールには Agency プランが必要です（Agency のトライアルも対象）。その他のプランでは 403 が返されます。sonar_app_sales と sonar_app_engagement は iOS のみ対応しており、trysonar.app/settings/connections での App Store Connect 接続も必要です。エンゲージメントデータを利用するには、Admin ロールの App Store Connect キーが必要です。

書き込みツール（Indie プラン＋write スコープ）

ツール	機能
sonar_create_product	Sonar ワークスペースにプロダクトを作成し、そのアプリの追跡を開始します
sonar_track_app	既存のプロダクトに、もう一方のストア版（iOS ↔ Android）をリンクします
sonar_track_competitor	プロダクトに競合アプリを追加します
sonar_remove_competitor	プロダクトから競合アプリを削除します
sonar_delete_product	プロダクトを削除し、そのアプリの追跡を解除します
sonar_untrack_app	アプリとその追跡データの追跡を解除します
sonar_track_keywords	アプリのキーワードの毎日の順位追跡を開始します（一括処理、冪等）
sonar_update_keyword_note	追跡中のキーワードのメモを設定または削除します
sonar_star_keyword	追跡中のキーワードにスターを付ける、または外します（ターゲットとしてマークします）
sonar_delete_tracked_keyword	1 つのキーワード／アプリの組み合わせの追跡を停止します
sonar_untrack_keywords	アプリのキーワードの追跡を一括解除します（選択した ID、またはすべて）
sonar_scan_competitor	競合を対象に AI キーワード発見スキャンを実行します（結果は sonar_competitor_keywords で読み取ります）
sonar_analyze_competitors	アプリの最新の AI 競合分析情報を生成します（7 日間のクールダウン）
sonar_generate_review_insights	追跡中のアプリの最新の AI レビュー分析を生成します（90 日間のクールダウン）
sonar_set_alert	アラートルールを作成または更新します
sonar_delete_alert	アラートルールを削除します

書き込みツールはワークスペースを変更するため、Indie プラン以上（有効なトライアルも対象）に加えて、ホスト型エンドポイントでの OAuth サインイン（書き込みアクセスが付与されます）、または write スコープ付きで作成した API キーのいずれかが必要です。2 つの AI 生成ツール、sonar_analyze_competitors と sonar_generate_review_insights には有料プランが必要で、トライアル中は利用できません。サーバーはこれらすべてを適用します。条件を満たしていない場合、修正すべき内容を説明する 403 が返されます。

これらを組み合わせることで、エージェントは一連の作業を完結できます。書き込みツールで追跡を設定し、その後、ワークスペースツールで順位、変動、ギャップ分析を読み取ります。

Screenshot Studio（Indie プラン）

ツール	説明	スコープ
sonar_screenshot_layout_guide	レイアウト形式のリファレンスです。レイアウトを作成する前に一度お読みください	なし
sonar_screenshot_devices	対応デバイスのサイズとキャンバスの寸法	読み取り
sonar_list_screenshot_sets	製品のスクリーンショットセット（メタデータのみ）	読み取り
sonar_get_screenshot_set	セット全体：各画面のレイアウトと翻訳の上書き	読み取り
sonar_create_screenshot_set	製品のスクリーンショットセットを作成	書き込み
sonar_update_screenshot_set	セット名の変更、ロケールの置き換え、画面の並べ替え	書き込み
sonar_delete_screenshot_set	セットとその中のすべてを削除	書き込み
sonar_add_screenshot	セットに画面を追加	書き込み
sonar_update_screenshot	画面のレイアウトを置き換え	書き込み
sonar_delete_screenshot	画面を削除（セットには少なくとも1つの画面が残ります）	書き込み
sonar_set_screenshot_translations	ロケールの翻訳の上書きを書き込み	書き込み
sonar_export_screenshots	ストア掲載用の PNG をロケールごとに1つのローカル ZIP にレンダリング	読み取り

エージェントはレイアウト JSON としてスクリーンショットセットを作成し、人間は Screenshot Studio で同じセットを確認して微調整します。レイアウトガイドはサーバーに組み込まれているため、キーは不要です。sonar_export_screenshots はサーバーを実行しているマシンにファイルを書き込むため、ホスト型エンドポイントではなく stdio 経由でのみ利用できます。

ホスト型エンドポイント — インストール不要、API キー不要

OAuth 対応の MCP クライアント（Claude Code、claude.ai のカスタムコネクター）は、npm のインストールと API キーの両方を省略できます。

claude mcp add --transport http sonar https://trysonar.app/mcp

アカウントが必要な最初のツール呼び出し時にブラウザーでサインイン画面が開きます。Sonar のログイン情報で承認すると、エージェントは所有するワークスペースに完全にアクセスできます（読み取り＋書き込み）。OAuth に対応していないクライアントでは、代わりに API キーを渡せます：--header "Authorization: Bearer aso..."。

ChatGPT への申請とホスト型の動作

https://trysonar.app/mcp/chatgpt を OpenAI に申請してください。このエンドポイントはツール単位のサインインチャレンジを返します。/mcp は Claude やその他の MCP クライアント向けに HTTP 401 チャレンジを引き続き使用します。どちらもツールごとに OAuth を通知します。匿名でのストア検索はアカウントを連携せずに実行できます。ワークスペースツールは、認証がない場合や期限切れの場合、ネイティブのサインインチャレンジを返します。既存の Sonar アカウントを接続し、所有するワークスペースへのアクセスを承認してください。既存アカウントの権限と利用資格が適用されます。

ChatGPT エンドポイントでは、正規の /mcp/chatgpt オーディエンスに紐づいたリソース限定 JWT アクセストークンが必要です。既存の /mcp エンドポイントでは、引き続き Clerk の不透明トークンをサポートします。ChatGPT エンドポイントを申請する前に、プロバイダーの設定とエンドツーエンドのログインを検証する必要があります。

ホスト型カタログには、ローカルの MCP ホストに ZIP ファイルを書き込む sonar_export_screenshots は含まれていません。このツールは引き続き stdio 経由で利用できます。ネイティブのディレクトリ掲載には、OpenAI による別途の審査と公開が必要です。MCP エンドポイントをホストするだけでは、掲載は作成されません。

無料で試す — API キー不要

サーバーはキーなしの無料モードで実行できます。sonar_app_search、sonar_app_lookup、sonar_app_aso_score、sonar_app_extract_keywords、sonar_keyword_suggestions、sonar_top_charts は、IP ごとに1日30リクエストの無料枠を共有し、sonar_keyword_metrics（キーワードの難易度＋人気度）は1日5キーワードまで利用できます。env ブロックを指定せずにインストールし、エージェントに ASO について尋ねるだけです。上限に達すると、エラーに登録方法が表示されます。

API キーを取得する

それ以外の機能（トラッキング、ランキング、競合他社、より高い利用上限）には Sonar API キーが必要です。trysonar.app/developers で取得してください。

最も安価な方法はプリペイド API クレジットです。$10（1,000クレジット）から購入でき、登録時に50クレジットが無料で付与され、サブスクリプションは不要です。この用途向けに特化して作られています。料金をご覧ください。

インストール

Claude Desktop

設定ファイル（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "sonar": {
      "command": "npx",
      "args": ["-y", "@sonarapp/mcp"],
      "env": {
        "SONAR_API_KEY": "aso_your_key_here"
      }
    }
  }
}

Claude Desktop を再起動します。sonar_* ツールがツールピッカーに表示されます。

Claude Code

claude mcp add sonar -e SONAR_API_KEY=aso_your_key_here -- npx -y @sonarapp/mcp

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "sonar": {
      "command": "npx",
      "args": ["-y", "@sonarapp/mcp"],
      "env": {
        "SONAR_API_KEY": "aso_your_key_here"
      }
    }
  }
}

Cline ／その他の MCP クライアント

ほとんどのクライアントでは、上記と同じ command + args + env の形式を使用します。コマンドを npx -y @sonarapp/mcp に設定し、env で SONAR_API_KEY を渡してください。

設定

変数	必須	デフォルト	説明
SONAR_API_KEY	いいえ（設定しなくても無料モードを利用可能）	—	Sonar API キー（aso_...）
SONAR_API_URL	いいえ	https://api.trysonar.app	API のベース URL を上書きします（セルフホスト／ステージングでのみ使用）

プロンプトの例

「Sonar を使って、米国ストアの iOS 版 Spotify を調べ、評価、レビュー数、カテゴリを報告してください。」

「Android 版 com.duolingo の ASO 監査を実行し、修正すべき点を教えてください。」

「iOS で「habit tracker」というキーワードを調査し、難易度、人気度、検討すべき難易度の低い関連キーワードを 5 つ挙げてください。」

「米国の iOS 版 1517783697 の最新の評価 1 つ星および 2 つ星のレビューを 50 件取得し、苦情をテーマ別に分類してください。」

「App Store で「meditation」を検索し、上位 5 件の月間収益を推定してください。」

プライバシーポリシー

ポリシー全文：https://trysonar.app/privacy

この MCP サーバーは Sonar の REST API を利用する薄いクライアントであり、ローカルに何も保存せず、このパッケージ自体がデータをログに記録することもありません。

• **収集するデータ：**結果を生成するため、ツールへの入力（アプリ ID、キーワード、国コード）は HTTPS 経由で Sonar の API に送信されます。認証済みリクエストには、Bearer トークンとして API キーが含まれます。Sonar はレート制限と不正利用の防止のため、API リクエスト（エンドポイント、ステータス、所要時間）をログに記録します。
• **データの使用：**入力はリクエストへの対応（キーワード指標、アプリ検索など）にのみ使用され、結果の JSON は AI クライアントに返されます。
• **保存と保持期間：**このパッケージはディスクに状態を保存しません。サーバー側のリクエストログは 90 日間保持されます。ワークスペースデータ（追跡対象のアプリ／キーワード）は、削除するまで Sonar アカウントに保存されます。
• **第三者との共有：**ユーザーデータを第三者に販売または共有することはありません。公開アプリストアデータ（Apple、Google）へのクエリには個人情報は含まれません。
• お問い合わせ先：[email protected]

トラブルシューティング

「SONAR_API_KEY is not set — running in free mode」 — キーを設定していない場合は想定どおりです。無料ツールは IP ごとの 1 日あたりの上限付きで引き続き利用できます。キーを設定したにもかかわらずこのメッセージが表示される場合、MCP クライアントから環境変数が渡されていません。クライアントの設定ファイルの env セクションを確認してください。クライアントによっては npx の絶対パスが必要です。which npx を実行して、そのパスを使用してください。

「Authentication failed」 — キーが無効、期限切れ、またはサブスクリプションの有効期限が切れています。trysonar.app/developers でご確認ください。

「Access denied. This endpoint may require an Indie plan subscription」 — ステートレスな読み取りツール 10 個は、クレジットがあればどのプランでも利用できます。ワークスペースの読み取り、書き込み、Screenshot Studio のツールには Indie プラン以上が必要です（有効なトライアルも対象です）。書き込みツールにはさらに、write スコープを指定して作成した API キーが必要です。sonar_portfolio、sonar_app_sales、sonar_app_engagement には Agency プランが必要で、AI 生成ツール 2 個には有料プランが必要です（トライアルは対象外です）。セットアップ中、またはトライアルの期限が切れたプランを利用している場合は、まず再度有効化してください。

関連ツール：CLI

ターミナルでの操作をお好みですか？@sonarapp/cli（sonar バイナリ）をご利用ください。同じデータを同じ API キーで使用できます。

ライセンス

MIT © Peter Sutarik