Google CrUX MCP について
Google CrUX MCPはChrome UX Reportの実ユーザーデータをAIアプリに提供し、サイトやページのCore Web Vitals分析に使えます。デバイス別・オリジンとページの比較、履歴の確認に対応し、十分な利用データがある公開対象に限られます。
主な機能
- 01Core Web Vitalsの評価
- 02デバイス別データの比較
- 03オリジンとページの比較
- 0440週間の推移確認
- 05最新・過去レコードの取得
- 06実ユーザーデータのみを照会
活用シーン
- 01ページのCore Web Vitals合格状況を確認
- 02モバイルとデスクトップの指標を比較
- 03ページとオリジン平均を比較
- 04LCP、INP、CLSの推移を確認
MCP 対応
MCP サーバーとして、評価、比較、履歴データを含むCrUX公開データの読み取り専用ツールをクライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y mcp-google-cruxCRUX_API_KEYシークレットGoogle Cloud API key with the Chrome UX Report API enabled (sent as the key= query parameter). Treat it as a secret.CRUX_API_BASEAPI root host override.CRUX_TIMEOUT_MSPer-request timeout in milliseconds.CRUX_MAX_RETRIESRetries on transient errors (429, 5xx, network).ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
6掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| url | string | いいえ | 特定ページの URL。例：https://example.com/pricing/。`origin` とは同時に指定できません。リダイレクト後の最終 URL を渡してください（API はリダイレクトを追跡しません）。データセットによってフラグメントとクエリパラメーターが削除されます。単一ページはサンプル数が少なく、データがないこともよくあります。結果が no_data の場合は `origin` に切り替えてください。 |
| origin | string | いいえ | サイトの origin。scheme と host のみを指定します。例：https://example.com（パスなし、末尾のスラッシュなし）。サイトのすべてのページにわたる実ユーザーデータを集計します。`url` とは同時に指定できません。http/https と www/非 www は別々のキーです。正規のバリアントを使用してください。 |
| form_factor | enum | いいえ | デバイスクラスのフィルターです。省略すると、全デバイスを集計したレコードが返されます。タブレットのトラフィックはごく少なく、通常データはありません。phone | desktop | tablet |
詳細
Google CrUX MCP
日本語 | Русский
A1 Google CrUX MCP は、実ユーザーの Core Web Vitals データを AI アプリで利用できるようにします。公開サイトやページが LCP、INP、CLS の基準を満たしているかを確認し、モバイルとデスクトップを比較して、指標が時間の経過とともにどのように変化したかを把握できます。
Google の Chrome UX Report データセットを読み取ります。これは Chrome ユーザーから収集されたフィールドデータであり、合成的な速度テストではなく、サイトを変更するものでもありません。
- 読み取り専用のツールが 6 つ。 Core Web Vitals の評価、デバイス比較、オリジンとページの比較、40 週間の傾向、最新または過去の記録の生データに対応します。
- 実ユーザーのデータ。 PageSpeed Insights と Google の Core Web Vitals シグナルで使用されるものと同じ CrUX フィールドデータです。
- データの利用可能範囲が明確。 十分な実ユーザートラフィックがある公開オリジンと URL のみデータを利用できます。
no_dataも有効な結果です。 - 既知のクォータコスト。 CrUX ではプロジェクトごとに毎分 150 クエリまで許可されています。デバイス比較では API を 4 回呼び出し、オリジンとページの比較では 2 回呼び出します。
まず、読み取り専用の質問から始めましょう。
https://example.comはモバイルで Core Web Vitals の基準を満たしていますか？
サーバーに接続 · ユースケースを見る · 技術ドキュメントを開く
1 分で動作を確認
あなた：
https://example.com/pricingはモバイルで Core Web Vitals の基準を満たしていますか？アシスタント： p75 の LCP、INP、CLS、それぞれの「良好」「改善が必要」「不良」の評価と全体の結果を表示します。何も変更されません。
あなた： このページをサイトの平均と比較し、モバイルとデスクトップの違いを表示してください。
アシスタント： オリジンと URL を比較した後、デバイスグループとそのトラフィックの割合を比較します。6 つのツールはいずれも公開 CrUX データセットのみを読み取ります。
目次
クイックスタート
Node.js 20 以降と、Chrome UX Report API を有効にした Google Cloud API キーが必要です。
- 制限付き API キーを作成します。
- MCP サーバーを AI アプリに追加します。
- 上記の読み取り専用の質問をします。
Codex
Settings → MCP servers で Add server を選択し、STDIO を選びます。コマンド npx -y mcp-google-crux@latest と環境変数 CRUX_API_KEY を入力してから、Save と Restart を選択します。
codex mcp add google-crux --env CRUX_API_KEY=your_key -- npx -y mcp-google-crux@latest
codex mcp list
Claude Code
claude mcp add --env CRUX_API_KEY=your_key --transport stdio --scope user google-crux -- npx -y mcp-google-crux@latest
claude mcp list
Claude Desktop
現在の公式手順は Settings → Extensions です。カスタムデスクトップ拡張機能を使う場合は、Advanced settings → Extension Developer → Install Extension… を開き、.mcpb ファイルを選択して、画面の指示に従ってください。
このリポジトリで現在公開されているのは npm の stdio パッケージであり、.mcpb バンドルは含まれていません。ローカル設定を引き続きサポートする Claude Desktop のビルドでは、代わりに次の JSON stdio 設定を使用してください。
{"mcpServers":{"google-crux":{"command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}}
これらのビルドでは、macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json に、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json に保存してください。
Cursor
macOS/Linux では ~/.cursor/mcp.json に、Windows では %USERPROFILE%\.cursor\mcp.json に {"mcpServers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}} を追加します。Cursor MCP ドキュメント
VS Code
MCP: Open User Configuration を実行して、次を追加します。
{"servers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"${input:crux_api_key}"}}},"inputs":[{"type":"promptString","id":"crux_api_key","description":"Google Cloud API key","password":true}]}
MCP: List Servers で確認します。VS Code MCP ドキュメント
できること
- この公開オリジンまたは URL は Core Web Vitals に合格していますか？
- スマートフォン、デスクトップ、タブレット、全デバイスの結果を比較します。
- このページはサイトの平均より速いですか、遅いですか？
- 過去 25 週間で LCP、INP、CLS はどのように変化しましたか？
- 技術レビュー用に、CrUX の生のヒストグラムとパーセンタイルを表示します。
CrUX データの読み方
CrUX は 28 日間のローリングウィンドウを報告し、毎日更新されます。履歴データは週単位で、月曜日に更新されます。重要な値は p75 です。観測された訪問の 75% が、この値以下です。get_core_web_vitals は指標のしきい値を解釈します。生レコードのツールでは、完全なヒストグラムと密度の割合を確認できます。
データがないからといって、サイトに問題があるとは限りません。そのオリジン、URL、またはデバイスグループについて、Google が十分な規模の公開 Chrome ユーザーサンプルを得られていないことを意味します。タブレットや個別の URL では、データがないことがよくあります。
アクセスの取得
- Google Cloud Console でプロジェクトを作成するか、既存のプロジェクトを選択します。CrUX では課金アカウントは必要ありません。
- Chrome UX Report API を有効にします。
- APIs & Services → Credentials で API キーを作成します。
- キーの使用先を Chrome UX Report API に制限し、
CRUX_API_KEYとして渡します。
キーは MCP クライアントの設定に保存され、API リクエスト URL に含めて送信されるため、パスワードとして扱ってください。
設定
| 変数 | 必須 | 説明 |
|---|---|---|
CRUX_API_KEY | はい | Chrome UX Report API が有効になっている Google Cloud キーです。 |
CRUX_API_BASE | いいえ | API ベース URL の上書き設定です。 |
CRUX_TIMEOUT_MS | いいえ | リクエストごとのタイムアウトです。デフォルトは 30000 ms です。 |
CRUX_MAX_RETRIES | いいえ | 429、5xx、ネットワーク障害時の再試行回数です。デフォルトは 3 です。 |
データ、制限、バックグラウンド処理
- 読み取り専用の公開データセットです。 サーバーはサイト、Search Console、CrUX の記録、Google のランキングを変更できません。
- クォータを考慮した再試行を行います。 429、5xx、ネットワークエラーが発生すると、バックオフして再試行します。1 分あたり 150 クエリというプロジェクトのクォータを見積もる際は、複合的な比較を考慮してください。
- バックグラウンドでのモニタリングは行いません。 サーバーは呼び出されている間だけ動作します。AI アプリがスケジュールされたタスクに対応している場合は、定期的なパフォーマンスレポートを作成できます。
- 匿名のテレメトリです。 インストール情報、バージョン情報、ツール名を送信しますが、API キー、照会した URL、結果、引数、プロンプトは送信しません。オプトアウトするには、
ASKADS_TELEMETRY=0を設定してください。
技術ドキュメント
- MCP 機能カタログ — 各ツールのタスク別ページです。
- すべてのツールと入力
- 開発ドキュメント
- 公開ドキュメント
- CrUX API ドキュメント
サポート
バグを見つけた場合や、シナリオが必要な場合は、issue を作成するか、Telegram にご連絡ください。
最後までご覧いただき、ありがとうございます！
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。