mcpField
A
Appstore Mcp Server

Appstore Mcp Server

ローカル
github.com/drewster99ビジネス・マーケティング73 週間前に更新

Appstore Mcp Server について

Appstore Mcp Serverは、App Storeのアプリ、ランキング、キーワード、トレンドを調べるmacOS向けMCPサーバー兼CLIです。ランキング順の検索結果とアプリ情報を組み合わせ、アプリ開発者や市場調査担当者に役立ちます。

主な機能

  1. 01App Storeアプリの検索と絞り込み
  2. 02IDやURLによるアプリ情報の取得
  3. 03キーワード順位と競合状況の確認
  4. 04チャート閲覧とトレンド発見
  5. 05複数形式に対応するCLI

活用シーン

  1. 01アプリと検索結果の競合比較
  2. 02ストアフロント別のキーワード順位追跡
  3. 03地域ごとのトップチャート確認

MCP 対応

MCPクライアントにApp Storeの検索、参照、順位、競合、チャート、トレンドのツールを提供します。ストアフロント、ジャンル、検索属性、チャート種別のリソースと、調査用プロンプトも備えています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"appstore": {
"command": "uvx",
"args": [
"appstore-mcp-server"
]
}
}
}
起動コマンドuvx appstore-mcp-server

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypiappstore-mcp-server

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

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_appsiTunes Search API を使用した、属性/ジャンルによる絞り込み検索
search_rankedMZStore API を使用した、実際の App Store ランキングに一致する検索結果
lookup_appID、バンドル 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://genresApp 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-requestHTTP リクエストの詳細を表示
--show-response-headersHTTP レスポンスヘッダーを表示
-o, --output-file <path>出力をファイルに書き込み
-i, --input-file <path>キャッシュされた JSON をファイルから読み込み
--help, -h任意のコマンドのヘルプを表示

出力形式: text(デフォルト)、json、raw-json、markdown、html、html-open(ブラウザーで開きます)。

詳細レベル:

レベル説明
minimalアプリごとに1行
summary主要な詳細(デフォルト)
expanded評価、サイズ、バージョンを追加
verboseURL、言語、機能を追加
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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。