getappniche

GetAppNiche MCP — AI エージェント向け App Store と Google Play のインテリジェンス

GetAppNiche の Model Context Protocol インターフェースです。Claude、Cursor、Codex、Gemini CLI、その他すべての MCP 対応エージェント向けに、App Store と Google Play の最新データを提供します。収益・ダウンロードデータを含むアプリ検索、ASO キーワードのスコアリング、過去の指標、レビューのフィードが利用できます。

おそらく何も実行する必要はありません。 サーバーはホストされています。

https://api.getappniche.com/mcp        Streamable HTTP · JSON-RPC 2.0
Authorization: Bearer YOUR_API_KEY     app.getappniche.com → Settings → API Keys

クライアントごとのセットアップ

Claude Code — 再起動不要の 1 コマンドです。

claude mcp add --transport http getappniche https://api.getappniche.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor — .cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）を使用します。

{
  "mcpServers": {
    "getappniche": {
      "url": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop — claude_desktop_config.json を設定してから、アプリを完全に再起動します。

{
  "mcpServers": {
    "getappniche": {
      "command": "npx",
      "args": ["-y", "@getappniche/mcp"],
      "env": { "GETAPPNICHE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

VS Code（Copilot エージェントモード） — .vscode/mcp.json を使用します。

{
  "servers": {
    "getappniche": {
      "type": "http",
      "url": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json を使用します（フィールド名は serverUrl です）。

{
  "mcpServers": {
    "getappniche": {
      "serverUrl": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Codex CLI — ~/.codex/config.toml を設定してから、GETAPPNICHE_API_KEY をエクスポートします。

[mcp_servers.getappniche]
url = "https://api.getappniche.com/mcp"
bearer_token_env_var = "GETAPPNICHE_API_KEY"

Gemini CLI — ~/.gemini/settings.json を使用します（フィールド名は httpUrl です）。

{
  "mcpServers": {
    "getappniche": {
      "httpUrl": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Zed、Cline、Continue、JetBrains AI にも対応しています。 すべてのスニペットは getappniche.com/mcp にあります。 コンパニオンエージェントスキル： getappniche-com/aso-skills （npx skills add getappniche-com/aso-skills）。

ChatGPT — 「設定」→「コネクター」→ カスタムコネクターを作成し（開発者モード）、https://api.getappniche.com/mcp を指定して API key 認証を選び、キーを貼り付けます。

claude.ai のウェブ版はリクエストヘッダー認証について説明していますが、コネクターの UI で現在表示されるのは OAuth フィールドのみです。仕様が落ち着くまでは、上記のいずれかのクライアントをご利用ください。

このリポジトリの内容

MCP を標準入出力経由で使用するものの、HTTP ヘッダーを送信できないクライアント向けの、依存関係ゼロの標準入出力ブリッジです。bin/cli.mjs（Node 18 以降、@getappniche/mcp として公開）と server.py（Python 3.9 以降、標準ライブラリのみ）の 2 種類があります。どちらもすべての JSON-RPC メッセージを TLS 経由でホストされたエンドポイントに転送し、レスポンスをストリーミングで返します。

# Node — one-liner, no install
GETAPPNICHE_API_KEY="getappniche_..." npx -y @getappniche/mcp

# Python — no dependencies
GETAPPNICHE_API_KEY="getappniche_..." python3 server.py

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "getappniche": {
      "command": "npx",
      "args": ["-y", "@getappniche/mcp"],
      "env": { "GETAPPNICHE_API_KEY": "getappniche_..." }
    }
  }
}

server.json は、公式 MCP レジストリに com.getappniche/mcp として公開されているマニフェストです。

読みやすい約 150 行のコードは、通信で送られる内容のリファレンスとしても役立ちます。API キーが含まれるのは、api.getappniche.com への TLS リクエストの Authorization ヘッダーのみです。それ以外の場所には一切送られません。

ツール

• search_apps - 25 種類以上のフィルター（ストア、カテゴリ、言語、価格モデル、評価、レビュー、ダウンロード数、収益、リリース・更新時期）でアプリを検索し、任意の列で並べ替えます（返されるアプリ 1 件につき 1 クレジット。デフォルトでは 1 回につき 50 件、最大 100 件）
• get_app_detail - 正規 ID、Apple ID 単体、Android パッケージ名、または貼り付けたストア URL からアプリを 1 件取得します（1 クレジット）
• get_app_historicals - レビュー、評価、ダウンロード数、収益の時系列データを取得します（1 クレジット）
• get_keyword_difficulty - キーワードの人気度、難易度、トラフィック、機会を取得します（10 クレジット）
• batch_keyword_difficulty - 最大 10 個のキーワードをスコアリングし、機会の順に並べ替えます（キーワード 1 個につき 10 クレジット）
• get_app_reviews - ID、パッケージ名、URL を指定して任意のアプリの App Store または Google Play の最新レビューを取得するか、ワークスペースでモニタリングしているアプリの拡張データを含む行を取得します（返されるレビュー 1 件につき 1 クレジット。デフォルトでは 1 回につき 50 件、最大 100 件）
• get_supported_countries - 有効なストアの国コードを一覧表示します（無料）

クレジットは GetAppNiche のプランに含まれています（Pro：月 5,000 クレジット）。また、すべての結果に credits_charged が含まれます。レート制限：キーごとに 1 分あたり 60 リクエストです。

プロトコルに関する注意事項

• メソッド：initialize → notifications/initialized → tools/list / tools/call。プロトコルエラーには標準の JSON-RPC コードが使用されます。ツールレベルのエラー （無効な ID、クレジット不足）は、エージェントが読み取れるツールの結果として返されます。
• ブリッジは Mcp-Session-Id を尊重し、JSON と SSE 形式のレスポンスの両方を受け付けます。
• ヘッダーを設定できないクライアントのコネクター UI（claude.ai のウェブ版）向け OAuth は 開発中です。ChatGPT は現在、API キー認証で接続できます。

ライセンス

MIT。GetAppNiche が開発 · X @getappniche · LinkedIn