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
APIキーを作成
Rankglassで設定 → ワークスペース → API & MCPを開き、キーを作成します。キーは一度しか表示されないため、すぐにコピーしてください。1つのキーで読み取れるのは1つのワークスペースです。アシスタントやスクリプトごとにキーを作成すると、個別に無効化できます。
ステップ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
普段の言葉で質問
アシスタントが適切なツールを選びます。どのツールもワークスペースの内容を変更することはできません。
アシスタントが読み取れるデータ
読み取り専用のツールは11個です。それぞれにREST APIの対応するGETエンドポイントがあります。
| MCPツール | 返す内容 | RESTエンドポイント |
|---|---|---|
list_apps | アプリの一覧と、各アプリのストア、追跡中の国、キーワード数、今週の主要な数値。最初の呼び出しに適しています。 | GET /v1/apps |
get_keyword_rankings | 1つのストアと国でアプリが追跡しているすべてのキーワード:順位、7日間の変動、検索結果への新規ランクインや圏外への移動、最高順位、推定月間検索数、難易度、競合の順位。 | GET /v1/keywords |
get_rank_changes | 直近数日間で順位が大きく上昇・下降したキーワード(すべてのキーワード、ストア、国が対象)と、トップ10に入った・外れたキーワード。 | GET /v1/rank-changes |
get_competitors | フォロー中の競合アプリとその評価、互いに相手より上位にあるキーワードの数、競合がトップ10に入っていて自分は入っていないキーワード。 | GET /v1/competitors |
get_competitor_keywords | 1つの国で競合アプリがランクインしているキーワード。まだ追跡していないものも含み、月間検索数、難易度、双方の順位が付きます。 | 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_score | 1つのストアと国での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サーバーの設定方法をご覧ください。