ブラックフライデー月払いプランの初月が25%オフ 特典を受け取る

MCPサーバーとREST API

ASOデータをAIアシスタントで使う

RankglassのMCPサーバーを使うと、Claude Code、Cursor、Claude Desktop、Codex、ChatGPTデスクトップアプリなどのMCPクライアントから、追跡中のキーワード、順位、競合、掲載情報スコアを読み取れます。REST APIでは、同じデータを自作のスクリプトで利用できます。

概要

MCPエンドポイント
https://app.rankglass.com/api/mcp
トランスポート
Streamable HTTP
認証
ワークスペースのAPIキー(Authorization: Bearer YOUR_API_KEYとして送信)
アクセス
読み取り専用
プラン
Starter、Pro、Agency
レート制限
キーごとに1分あたり60リクエスト、1日あたり2,000リクエスト

ヘッダーを送信できるMCPクライアントで動作

RankglassはすべてのリクエストでAPIキーを確認するため、クライアントはキーをヘッダーで送るだけです。次のクライアントの設定方法を下に載せています。

  • Claude Code
  • Cursor
  • Claude Desktop(mcp-remote経由、Node.jsが必要)
  • CodexとChatGPTデスクトップアプリ
  • その他のMCPクライアントや自作のエージェント(上記のエンドポイントとヘッダーを使用)

OAuthのログインでしか接続できないクライアントはキーを送れないため、現時点ではRankglassを追加できません。

3ステップで設定

  1. ステップ1

    APIキーを作成

    Rankglassで設定 → ワークスペース → API & MCPを開き、キーを作成します。キーは一度しか表示されないため、すぐにコピーしてください。1つのキーで読み取れるのは1つのワークスペースです。アシスタントやスクリプトごとにキーを作成すると、個別に無効化できます。

  2. ステップ2

    アシスタントにRankglassを追加

    お使いのクライアント用の設定を貼り付け、YOUR_API_KEYを自分のキーに置き換えてください。

    Claude Code

    ターミナルで実行してください。--scope userを付けると、すべてのプロジェクトでRankglassを使えます。

    claude mcp add --transport http --scope user rankglass https://app.rankglass.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

    Cursorなどのクライアント

    Cursorの場合は、~/.cursor/mcp.json、またはプロジェクト内の.cursor/mcp.jsonに追加してください。その他のクライアントは各自の設定でMCPサーバーを管理しています。必要なのはエンドポイントとヘッダーだけです。

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

    Claude Desktop

    claude_desktop_config.json(設定 → 開発者 → 構成を編集)に追加し、Claudeを再起動してください。npxでmcp-remoteを実行するため、Node.jsのインストールが必要です。

    {
      "mcpServers": {
        "rankglass": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://app.rankglass.com/api/mcp",
            "--header",
            "Authorization:${RANKGLASS_AUTH}"
          ],
          "env": {
            "RANKGLASS_AUTH": "Bearer YOUR_API_KEY"
          }
        }
      }
    }

    CodexとChatGPTデスクトップアプリ

    ~/.codex/config.tomlに追加してください。このファイルはCodex CLI、Codex IDE拡張機能、ChatGPTデスクトップアプリで共有されます。キーはBearerを付けずに、RANKGLASS_API_KEYという名前の環境変数に設定してください。

    [mcp_servers.rankglass]
    url = "https://app.rankglass.com/api/mcp"
    bearer_token_env_var = "RANKGLASS_API_KEY"

    Authorizationヘッダーを設定できないクライアントは、代わりにx-api-key: YOUR_API_KEYを送信できます。

  3. ステップ3

    普段の言葉で質問

    アシスタントが適切なツールを選びます。どのツールもワークスペースの内容を変更することはできません。

アシスタントが読み取れるデータ

読み取り専用のツールは11個です。それぞれにREST APIの対応するGETエンドポイントがあります。

MCPツールと対応するRESTエンドポイント
MCPツール返す内容RESTエンドポイント
list_appsアプリの一覧と、各アプリのストア、追跡中の国、キーワード数、今週の主要な数値。最初の呼び出しに適しています。GET /v1/apps
get_keyword_rankings1つのストアと国でアプリが追跡しているすべてのキーワード:順位、7日間の変動、検索結果への新規ランクインや圏外への移動、最高順位、推定月間検索数、難易度、競合の順位。GET /v1/keywords
get_rank_changes直近数日間で順位が大きく上昇・下降したキーワード(すべてのキーワード、ストア、国が対象)と、トップ10に入った・外れたキーワード。GET /v1/rank-changes
get_competitorsフォロー中の競合アプリとその評価、互いに相手より上位にあるキーワードの数、競合がトップ10に入っていて自分は入っていないキーワード。GET /v1/competitors
get_competitor_keywords1つの国で競合アプリがランクインしているキーワード。まだ追跡していないものも含み、月間検索数、難易度、双方の順位が付きます。GET /v1/competitor-keywords
get_competitor_insights競合アプリのストア情報、星ごとの評価、チャート順位、推定月間ダウンロード数と収益、最新のAIレビュー要約。GET /v1/competitor-insights
get_competitor_growthベータ競合アプリがどのようにユーザーを獲得しているか:広告、SNSアカウント、クリエイター、ストア検索、ウェブサイトと、推定広告費、広告経由のインストール数、SNSのリーチ、最新のAI戦略。ProとAgency。GET /v1/competitor-growth
get_store_page_changes自分と競合のストアページの最近の変更:タイトル、サブタイトル、説明文、スクリーンショット、バージョン、リリースノート。GET /v1/store-page-changes
get_aso_score1つのストアと国での0〜100のASOスコア、その内訳となるチェック、キーワードのクイックウィン、最新のAIによる掲載情報の提案。GET /v1/aso-score
get_weekly_briefアプリの最新の週次レポート:変化した点、考えられる理由、次に取り組むこと(最大3つ)。GET /v1/weekly-brief
get_keyword_game_planベータ追跡中のキーワードの最新の攻略プラン:目標順位と、そこに到達するための最大5つのステップ。GET /v1/keyword-game-plan

REST API

同じデータをJSONで取得し、自作のスクリプト、ダッシュボード、スプレッドシートで使えます。すべてのエンドポイントはhttps://app.rankglass.com/api/v1以下へのGETリクエストで、同じキーを使います。

最初のリクエスト例:過去7日間で最も大きな順位変動。

curl "https://app.rankglass.com/api/v1/rank-changes?days=7" -H "Authorization: Bearer YOUR_API_KEY"

制限とアクセス

  • 読み取り専用です。ツールとエンドポイントはRankglassに保存済みのデータを読み取るだけで、新しい検索を開始することはありません。新しい国で競合のキーワードを調べるなど、費用のかかる処理はダッシュボードから開始します。
  • 各キーは1分あたり60リクエスト、1日あたり2,000リクエストまで利用でき、MCPサーバーとREST APIで共有されます。上限を超えると、リクエストにはRetry-Afterヘッダー付きの429レスポンスが返ります。
  • APIとMCPはStarter、Pro、Agencyプランで利用できます。対象外のプランでは、リクエストに403レスポンスが返ります。
  • キーはそのワークスペースのすべてのデータを読み取れるため、パスワードと同じように扱ってください。設定ページで各キーの最終使用日時を確認でき、そこで無効化もできます。

試してみたい質問

  • 今週順位が下がったキーワードは?
  • ドイツで「habit tracker」の自分のアプリの順位は?自分より上位にいるのはどのアプリ?
  • トップの競合がランクインしていて、自分がまだ追跡していないキーワードは?
  • 今月、競合はストアページで何を変更した?
  • イギリスでの自分のASOスコアは?最初に直すべき点は?
  • 各アプリの今週のレポートを要約して。

MCPサーバーに関する質問

ChatGPTで使えますか?

はい、ChatGPTデスクトップアプリで使えます。このアプリはMCPサーバーの設定を~/.codex/config.tomlでCodex CLIやCodex IDE拡張機能と共有しており、環境変数(bearer_token_env_var)からキーを送信できます。設定内容は上記のとおりです。Web版のChatGPTはOAuthのログインにしか対応していないコネクタでツールを追加するため、現時点ではキーを送れません。ヘッダー付きでAPIを呼び出せるものであれば、代わりにREST APIを利用できます。

アシスタントがRankglassの内容を変更することはありますか?

いいえ。すべてのツールとエンドポイントは読み取りのみです。アプリの追加、キーワードの追跡、検索の開始はダッシュボードで行います。

データはどのくらい新しいですか?

ダッシュボードと同じです。有料プランでは、追跡中のすべてのキーワードを1日1回チェックし、週次レポートは毎週月曜日に作成されます。ツールはRankglassに保存済みのデータを読み取るだけで、チェックを開始することはありません。

データはどこに送られますか?

データを要求したクライアントにのみ、キーが属するワークスペースのデータだけが送られます。その後は、アシスタントの提供元が自社の規約に従って扱います。キーを削除すれば、いつでも送信を止められます。

手順を追って確認したい場合は、Rankglass MCPサーバーの設定方法をご覧ください。

自分のアプリの次の一手を見つける

ストアのリンクひとつでアプリを追加して、今日の順位を確認しましょう。

無料で始める

無料プラン・クレジットカード不要・いつでも解約可能