Appstore Mcp Server について
Appstore Mcp Serverは、App Storeのアプリ、ランキング、キーワード、トレンドを調べるmacOS向けMCPサーバー兼CLIです。ランキング順の検索結果とアプリ情報を組み合わせ、アプリ開発者や市場調査担当者に役立ちます。
主な機能
- 01App Storeアプリの検索と絞り込み
- 02IDやURLによるアプリ情報の取得
- 03キーワード順位と競合状況の確認
- 04チャート閲覧とトレンド発見
- 05複数形式に対応するCLI
活用シーン
- 01アプリと検索結果の競合比較
- 02ストアフロント別のキーワード順位追跡
- 03地域ごとのトップチャート確認
MCP 対応
MCPクライアントにApp Storeの検索、参照、順位、競合、チャート、トレンドのツールを提供します。ストアフロント、ジャンル、検索属性、チャート種別のリソースと、調査用プロンプトも備えています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
App Store MCP サーバー
App Store を検索し、キーワードランキングの確認、競合分析、トレンド追跡を行う MCP サーバーです。ネイティブ macOS バイナリを利用して、App Store API にすばやく直接アクセスします。
リッチな出力形式に対応した単独の CLI ツールとしても使用できます。
要件
- macOS 26 以降(Apple Silicon)
クイックスタート
uvx でインストール(推奨)
uvx appstore-mcp-server
初回実行時にネイティブバイナリをダウンロードし、MCP サーバーを起動します。継続的なインストールは不要です。
pip でインストール
pip install appstore-mcp-server
appstore-mcp-server
バイナリを直接ダウンロード
GitHub Releases から最新のリリースをダウンロードして展開し、実行します。
tar xzf appstore-*-macos-arm64.tar.gz
./appstore --mcp
MCP クライアントの設定
Claude Code
claude mcp add --scope user --transport stdio -- appstore-mcp-server uvx appstore-mcp-server
または、バイナリを直接使用します。
claude mcp add --scope user --transport stdio -- appstore-mcp-server /path/to/appstore --mcp
Claude Desktop
Claude Desktop の設定ファイル(~/Library/Application Support/Claude/claude_desktop_config.json)に追加します。
{
"mcpServers": {
"appstore-mcp-server": {
"command": "uvx",
"args": ["appstore-mcp-server"]
}
}
}
その他の MCP クライアント
サーバーは標準の MCP プロトコルを使用して stdio 経由で通信します。--mcp フラグを付けて実行します。
/path/to/appstore --mcp
MCP ツール
| ツール | 説明 |
|---|---|
search_apps | iTunes Search API を使用した、属性/ジャンルによる絞り込み検索 |
search_ranked | MZStore API を使用した、実際の App Store ランキングに一致する検索結果 |
lookup_app | ID、バンドル ID、App Store URL でアプリを検索 |
top_charts | 現在のトップチャートランキング(無料、有料、売上) |
find_app_rank | 単一のキーワードでアプリのランキングを確認 |
check_app_rankings | 自動生成されたキーワードでアプリのランキングを確認(低速) |
analyze_keyword | 競争力スコア(0~100)を含む競合分析 |
app_competitors | 検索結果の重複からアプリの主要な競合を特定 |
compare_keywords | 複数のキーワードの競争力を比較(低速) |
discover_trending | チャートに新しく登場した項目からトレンドのカテゴリを特定 |
version | サーバーのバージョンを取得 |
ほとんどのツールは次の項目に対応しています。
storefront— 2 文字の国コード(デフォルト:US)。任意の App Store 地域に使用します。verbosity— 応答の詳細度とトークン使用量を制御します。compact(デフォルト)— 主要なフィールドのみを表示し、説明は含みません。ほとんどのクエリに最適です。full— アプリの説明とリリースノートを含みます。complete— API 応答のすべてのフィールドを含みます。詳細な出力です(アプリあたり約 4 KB)。
MCP リソース
| リソース | URI | 説明 |
|---|---|---|
| ストアフロント | appstore://storefronts | サポート対象のすべての App Store 地域の国コードと名称 |
| ジャンル | appstore://genres | App Store カテゴリのジャンル ID と名称 |
| 検索属性 | appstore://attributes | 絞り込み検索で使用できる検索属性名 |
| チャートの種類 | appstore://chart-types | トップチャートのクエリで使用できるチャートの種類 |
MCP プロンプト
| プロンプト | 説明 |
|---|---|
competitive_analysis | ガイド付きワークフロー:アプリを検索し、競合を特定してキーワードランキングを分析し、実行可能な提案を取得します。引数:keyword_or_app_id(必須)、storefront(任意)。 |
market_research | ガイド付きワークフロー:検索ランキング、トップチャート、競争力分析、トレンドの発見、市場機会の特定を行います。引数:category(必須)、storefront(任意)。 |
CLI の使用方法
このバイナリは、多機能な CLI ツールとしても使用できます。対話形式で使用するには、--mcp を付けずに実行します。
コマンド
| コマンド | 説明 |
|---|---|
search <query> | App Store を検索(iTunes Search API) |
scrape <query> | App Store アプリと一致するランキング順の結果を表示して検索(MZStore API) |
lookup <id-or-bundle> | ID、バンドル ID、または URL でアプリを検索 |
ranks <app-id> | アプリのキーワードランキングを分析 |
analyze <query> | キーワードとの一致を含む上位 20 件の結果の競合分析 |
top <chart-type> | トップチャートを表示(無料、有料、売上、新規無料、新規有料) |
list <type> | ストアフロント、ジャンル、属性、またはチャートの種類を一覧表示 |
search
iTunes Search API を使用して App Store を検索します。
appstore search "photo editor"
appstore search --limit 5 minecraft
appstore search --storefront JP nintendo
appstore search --attribute softwareDeveloper "Meta Platforms"
appstore search --genre 6014 puzzle # Games category
appstore search --verbosity minimal spotify
appstore search --output-format json spotify
appstore search --unlimited "weather"
主なオプション:
| オプション | 説明 |
|---|---|
--limit <n> | 結果の数(1~200、デフォルト:200、0 は無制限) |
--unlimited | --limit 0 と同じです |
--attribute <attr> | 特定のフィールドを検索します:titleTerm、softwareDeveloper、descriptionTerm |
--genre <id> | ジャンル ID で絞り込みます(例:ゲームの場合は 6014) |
--storefront <code> | 国コード(例:US、JP、GB) |
--output-format <fmt> | text(デフォルト)、json、raw-json、markdown、html、html-open |
--verbosity <level> | minimal、summary(デフォルト)、expanded、verbose、complete |
--full-description | アプリの説明全文を表示します |
scrape
MZStore API を使用して検索します。結果は実際の App Store のランキング順で表示されます。これは App Store アプリでユーザーが見るランキングと同じです。ランキング順位が重要な場合は、search の代わりにこちらを使用してください。
appstore scrape spotify
appstore scrape --limit 10 "photo editor"
appstore scrape --storefront GB twitter
appstore scrape --output-format json instagram
主なオプション:
| オプション | 説明 |
|---|---|
--limit <n> | 結果の最大数(デフォルト:200) |
--storefront <code> | 国コード(デフォルト:US) |
--output-format <fmt> | text(デフォルト)、json、raw-json、markdown、html |
--verbosity <level> | minimal、summary(デフォルト)、expanded、verbose、complete |
lookup
ID、バンドル ID、または App Store URL で特定のアプリを検索します。
appstore lookup 284910350 # Numeric = app ID
appstore lookup com.spotify.client # Non-numeric = bundle ID
appstore lookup --ids 284910350,324684580 # Multiple apps
appstore lookup --url "https://apps.apple.com/us/app/yelp/id284910350"
appstore lookup 284910350 --storefront JP
appstore lookup com.facebook.Facebook --output-format json
主なオプション:
| オプション | 説明 |
|---|---|
--id <id> | アプリ ID で検索します |
--ids <id1,id2,...> | 複数のアプリを検索します(カンマ区切り) |
--bundle-id <bundle> | バンドル識別子で検索します |
--url <url> | App Store URL で検索します |
--storefront <code> | 国コード(デフォルト:US) |
--output-format <fmt> | text、json、raw-json、markdown、html |
--verbosity <level> | minimal、summary(デフォルト)、expanded、verbose、complete |
ranks
アプリのキーワードランキングを分析します。アプリ名、サブタイトル、説明からキーワードを自動生成し、各キーワードでのアプリのランキングを確認します。利用可能な場合は、オンデバイス AI(Apple Intelligence)を使用して追加のキーワードを生成します。
appstore ranks 324684580 # Analyze Spotify's rankings
appstore ranks 284910350 --limit 30 # Test 30 keywords for Yelp
appstore ranks 544007664 --storefront GB # UK store rankings
主なオプション:
| オプション | 説明 |
|---|---|
--limit <n> | テストするキーワードの最大数(デフォルト:生成されたすべてのキーワード) |
--storefront <code> | 国コード(デフォルト:US) |
--verbosity <level> | minimal、summary(デフォルト)、expanded、verbose、complete |
このコマンドは API 呼び出しを複数回、順次実行するため、30~120 秒かかる場合があります。
analyze
キーワードの検索結果上位 20 件を、競争力に関する指標を使って分析します。一致スコア、評価の増加ペース、アプリの経過日数、競争力の概要を含む CSV を出力します。
appstore analyze "cat toy"
appstore analyze --storefront GB "photo editor"
appstore analyze "music player" > results.csv
CSV の列: アプリ ID、評価、評価数、初回リリース、最新リリース、経過日数、新しさ(日数)、タイトル一致スコア、説明一致スコア、1 日あたりの評価数、タイトル、ジャンル、バージョン、最小 iOS バージョン、年齢制限レーティング。
主なオプション:
| オプション | 説明 |
|---|---|
--storefront <code> | 国コード(デフォルト:US) |
top
App Store のトップチャートを表示します。
appstore top free # Top free apps (US)
appstore top paid --limit 10 # Top 10 paid apps
appstore top grossing --storefront JP # Top grossing in Japan
appstore top paid --genre 6014 # Top paid games
appstore top newfree --output-format json # New free apps as JSON
チャートの種類: free、paid、grossing、newfree、newpaid
主なオプション:
| オプション | 説明 |
|---|---|
--limit <n> | 結果の数(1~200、デフォルト:25) |
--genre <id> | ジャンル ID で絞り込みます |
--storefront <code> | 国コード(デフォルト:US) |
--output-format <fmt> | text、json、raw-json、markdown、html |
--verbosity <level> | minimal、summary(デフォルト)、expanded、verbose、complete |
list
ストアフロント、ジャンル、属性、またはチャートの種類で利用可能な値を一覧表示します。
appstore list storefronts # All country codes
appstore list genres # All genre IDs
appstore list attributes # Search attributes
appstore list charttypes # Chart types
appstore list storefronts --output-format json
エイリアス:storefront/storefronts/country/countries、genre/genres/category/categories、attribute/attributes、charttype/charttypes/chart/charts。
共通オプション
ほとんどのコマンドで、以下のオプションを使用できます。
| オプション | 説明 |
|---|---|
--storefront <code> | App Store の国(US、JP、GB、FR など) |
--country <code> | --storefront の別名 |
--language <code> | 結果の言語(デフォルト:en_us) |
--output-format <fmt> | 出力形式(下記参照) |
--verbosity <level> | 詳細レベル(下記参照) |
--show-request | HTTP リクエストの詳細を表示 |
--show-response-headers | HTTP レスポンスヘッダーを表示 |
-o, --output-file <path> | 出力をファイルに書き込み |
-i, --input-file <path> | キャッシュされた JSON をファイルから読み込み |
--help, -h | 任意のコマンドのヘルプを表示 |
出力形式: text(デフォルト)、json、raw-json、markdown、html、html-open(ブラウザーで開きます)。
詳細レベル:
| レベル | 説明 |
|---|---|
minimal | アプリごとに1行 |
summary | 主要な詳細(デフォルト) |
expanded | 評価、サイズ、バージョンを追加 |
verbose | URL、言語、機能を追加 |
complete | 利用可能なすべてのフィールド |
ソースからのビルド
git clone https://github.com/drewster99/appstore-mcp-server.git
cd appstore-mcp-server
Xcode で appstore.xcodeproj を開いてビルドする(Product > Build)か、次のコマンドを実行します。
xcodebuild build \
-project appstore.xcodeproj \
-scheme appstore \
-configuration Release \
-destination 'platform=macOS,arch=arm64'
バイナリは DerivedData のビルド成果物ディレクトリに出力されます。./appstore --mcp で MCP サーバーとして、または ./appstore <command> で CLI として実行します。
アーキテクチャ
サーバーは2種類の Apple API を使用します。
- MZStore API — App Store の実際のランキング順でアプリを返します。
search_ranked、find_app_rank、check_app_rankings、analyze_keyword、app_competitors、compare_keywords(および CLI のscrape、ranks、analyze)で使用します。 - iTunes Search/Lookup API & RSS — アプリの完全なメタデータとチャートデータを返します。
search_apps、lookup_app、top_charts、discover_trending(および CLI のsearch、lookup、top)で使用します。
ランキングが重要な操作では、まず MZStore API でランキング順のアプリ ID を取得し、次に iTunes Lookup API で完全な詳細情報を付加します。実装の詳細については、CLAUDE.md を参照してください。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。