Google CrUX MCP

English | Русский

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クエリを許可します。デバイス比較は4回の API 呼び出しを行い、オリジンとページの比較は2回行います。

読み取り専用の質問から始めましょう：

https://example.com はモバイルで Core Web Vitals を満たしていますか？

サーバーに接続 · ユースケースを見る · 技術ドキュメントを開く

1分で動作を確認する

あなた: https://example.com/pricing はモバイルで Core Web Vitals を満たしていますか？

アシスタント: p75 の LCP、INP、CLS と、それらの良好/改善が必要/不良の評価、および総合結果を表示します。何も変更されません。

あなた: このページをサイト平均と比較し、モバイルとデスクトップの違いを表示してください。

アシスタント: オリジンと URL を比較し、次にデバイスグループとそのトラフィックシェアを比較します。6つのツールはすべて公開 CrUX データセットのみを読み取ります。

Related MCP server: GSC Analyst Connector

目次

• クイックスタート

• 依頼できること

• CrUX データの読み方

• アクセス権の取得

• 設定

• データ、制限、バックグラウンド処理

• 技術ドキュメント

• サポート

クイックスタート

Node.js 20 以上と、Chrome UX Report API を有効にした Google Cloud API キーが必要です。

1. 制限付き API キーを作成します。

2. サーバーを AI アプリに追加します。

3. 上記の読み取り専用の質問をします。

Settings → Plugins → MCP servers で Add server を選択し、CRUX_API_KEY を指定して npx -y mcp-google-crux@latest を追加します。

codex mcp add google-crux --env CRUX_API_KEY=your_key -- npx -y mcp-google-crux@latest
codex mcp list

Codex MCP ドキュメント

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 Code MCP ドキュメント

Settings → Developer → Edit Config を開き、{"mcpServers":{"google-crux":{"command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}} を追加します。

Edit Config が利用できない場合は、macOS では ~/Library/Application Support/Claude/claude_desktop_config.json を、Windows では %APPDATA%\Claude\claude_desktop_config.json を編集します。Claude Desktop MCP ドキュメント

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 ドキュメント

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 を満たしていますか？

• スマートフォン、デスクトップ、タブレット、全デバイスの結果を比較できます。

• このページはサイト平均より速いですか、遅いですか？

• LCP、INP、CLS は過去25週間でどのように変化しましたか？

• 技術レビューのために、生の CrUX ヒストグラムとパーセンタイルを表示できます。

CrUX データの読み方

CrUX は、毎日更新される28日間のローリングウィンドウを報告します。履歴データは週次で、月曜日に更新されます。重要な値は p75 です。観測された訪問の75%がこの値以下です。get_core_web_vitals はメトリクスのしきい値を解釈します。生レコードツールは完全なヒストグラムと密度割合を公開します。

データがないことはサイトが壊れていることを意味しません。そのオリジン、URL、またはデバイスグループに対して、Google が十分に大きな公開 Chrome ユーザーサンプルを持っていないことを意味します。タブレットや個別の URL にはデータがないことがよくあります。

アクセス権の取得

1. Google Cloud Console でプロジェクトを作成または選択します。CrUX には課金アカウントは不要です。

2. Chrome UX Report API を有効にします。

3. APIs & Services → Credentials で API キーを作成します。

4. キーを Chrome UX Report API に制限し、CRUX_API_KEY として渡します。

キーは MCP クライアント構成に保存され、API リクエスト URL で送信されるため、パスワードとして扱ってください。

設定

データ、制限、バックグラウンド処理

• 読み取り専用の公開データセット。 サーバーはサイト、Search Console、CrUX レコード、Google ランキングを変更できません。

• クォータを考慮した再試行。 429、5xx、ネットワークエラーをバックオフ付きで再試行します。プロジェクトの毎分150クエリのクォータを計画するときは、複合比較を考慮してください。

• バックグラウンド監視なし。 サーバーは呼び出されたときだけ動作します。AI アプリがスケジュールタスクをサポートしている場合は、定期的なパフォーマンスレポートを作成できます。

• 匿名テレメトリ。 インストール情報、バージョン情報、ツール名を送信します。API キー、クエリされた URL、結果、引数、プロンプトは決して送信しません。オプトアウトするには ASKADS_TELEMETRY=0 を設定します。

技術ドキュメント

• MCP 機能カタログ — すべてのツールのタスク指向ページ。

• すべてのツールと入力

• 開発ドキュメント

• 公開ドキュメント

• CrUX API ドキュメント

サポート

バグを見つけた場合やシナリオが必要な場合は、issue を作成 するか、Telegram で連絡してください。