appindex

appindex

appindex は、ライブの App Store と Google Play のデータを公開するホスト型 AppNiche MCP サーバーへの、小規模なローカルブリッジです。25 を超えるフィルターを使って両ストアを検索し、アプリの全レコードを取得し、過去の指標や掲載情報の変更履歴を確認し、キーワードの難易度と機会を評価し、アプリレビューを読み、対応する国コードを一覧表示できます。カタログのローカルコピーを用意する必要はなく、すべてエージェントから利用できます。

このブリッジはアプリデータを一切保持しません。ライブエンドポイントから取得した上流サーバーのツール一覧をそのままローカルで提供し、各ツール呼び出しを上流へ転送して、結果を変更せずに返します。一部のツールの説明には、呼び出しごとのクレジット消費量が記載されています。このクレジットは、呼び出し元が以前から保有している AppNiche アカウントに対して、上流サービスによって請求されます。ここにはクレジットの購入、アカウントの作成、キーの発行を行うツールはなく、ブリッジがそれらを追加することもありません。

ツール

• search_apps — ストア、カテゴリ、ゲームとゲームジャンル、言語（ローカライズの不足を調べる not_languages フィルターを含む）、価格モデル、評価、レビュー数、ダウンロード数と収益の推定値、リリースとアップデートの新しさ、レビュー増加の傾向に関するフィルターを使って、App Store と Google Play のアプリを検索します。任意の列で並べ替えられます。 すべてのフィルターは省略可能です。
• get_app_detail — アプリの全レコードを返します。 必須：app_id（"apple:284882215" や "google:com.spotify.music" のような正規 ID、Apple のトラック ID のみ、Android のパッケージ名、またはストアの URL）。
• get_app_historicals — 1 つのアプリの過去の指標データを返します。最大 90 日分は日次、それ以降は週次です。必須：store_id。任意：store、days。
• get_app_timeline — 1 つのアプリの掲載情報の変更履歴を新しい順に返します。バージョン、アイコンとスクリーンショットのデザイン変更、価格とビジネスモデルの変更、改名、カテゴリの移動、説明文の書き換えなどを日ごとにまとめて表示します。必須：store_id。任意：store、days、before。
• get_keyword_difficulty — App Store または Google Play で、1 つのキーワードの難易度と機会を評価します。必須：keyword。任意：store、country、language。
• batch_keyword_difficulty — 1 回の呼び出しで最大 10 個のキーワードを評価します。必須：keywords。 任意：store、country、language。
• get_app_reviews — アプリのレビューを読み取ります。任意のアプリのストア上の最新レビューを取得するには app_id を指定します。省略すると、感情、トピック、改善点が付加されたワークスペースの追跡対象アプリを読み取ります。 すべての引数は省略可能です。
• get_supported_countries — 対応する国コードを返します。引数は不要です。

設定

• APPNICHE_MCP_URL（任意）— 上流エンドポイントを上書きします。既定値は https://api.getappniche.com/mcp です。（上書き用フックは、この再構築版独自のものであることを明記しています。）
• GETAPPNICHE_API_KEY（任意）— 設定すると、すべての上流リクエストに、呼び出し元自身の AppNiche キーを使用した Authorization: Bearer <key> ヘッダーが付加されます。このキーは、呼び出し元の AppNiche ダッシュボード設定で作成されたものです。設定されていない場合、キーのヘッダーは送信されません。（ヘッダー名と環境変数名は、オリジナルのレジストリ記録に基づいています。Bearer スキームとこの環境変数の転送は、再構築版であることを明記しています。オリジナルのインターフェイスは、キーを使用しない状態で取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とストリーミング可能な HTTP セッションを開きます。まず JSON-RPC initialize リクエスト（protocolVersion 2025-03-26、 clientInfo name appindex）を送り、次に notifications/initialized 通知を送り、その後、呼び出し元の引数を 変更せずに含めた tools/call リクエストを送ります。上流が Mcp-Session-Id ヘッダーを付けて initialize に応答すると、 その値はセッションの以降のすべてのリクエストに引き継がれ、 プロセスが終了するまで再利用されます。応答はプレーンな JSON、 またはサーバー送信イベントとして届くことがあり、どちらも読み取ります。

上流からの成功結果は、上流が設定した isError フラグも含め、 そのまま返されます。JSON-RPC エラー、2xx 以外のステータス、 読み取り不能な応答、または完了できないリクエストといった失敗は、 テキストが appindex error: で始まる isError 結果として返されます （この表記は、この再構築版独自のラベル付き再現です）。

CLI

各ツールは、JSON 引数文字列を受け取るサブコマンドとしても実行できます。

npx @reneturcios/appindex search_apps '{"search":"calorie tracker","store":"apple","limit":10}'
npx @reneturcios/appindex get_app_detail '{"app_id":"apple:284882215"}'
npx @reneturcios/appindex get_keyword_difficulty '{"keyword":"habit tracker"}'
npx @reneturcios/appindex get_supported_countries
npx @reneturcios/appindex --version

終了コード：成功時は 0、isError 結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/appindex mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "appindex": {
      "command": "npx",
      "args": ["-y", "@reneturcios/appindex", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/appindex
docker run --rm ghcr.io/cloudcorprecords/appindex --version

コンテナーのデフォルトコマンドは mcp です。そのため、最初の形式では stdio MCP サーバーが起動し、それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべてスタブ化された JSON-RPC 上流を相手に実行され、実際のネットワーク呼び出しは行いません。

ライセンス

MIT — LICENSE を参照してください。