Chrome Ux Report

@pipeworx/chrome-ux-report

十分なトラフィックがあるあらゆるサイトの、実ユーザーによる Core Web Vitals を Google の Chrome UX Report から取得します。実際に Chrome を利用した訪問者が過去 28 日間に体験した、75 パーセンタイルの Largest Contentful Paint、Interaction to Next Paint、Cumulative Layout Shift と、各数値の分布、および約 40 週間分の履歴を確認できます。

Pipeworx の一部です。AI エージェントを 1875 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携しておらず、承認も公開も受けていません。

これは Google 検索が Core Web Vitals の評価に使用するフィールドデータセットです。そのため、「このサイトは Core Web Vitals に合格しているか」という問いに答えられます。Lighthouse を含め、ラボツールでは答えられません。

ツール

• crux_query_origin(origin, form_factor?, metrics?) — サイト全体。
• crux_query_url(url, form_factor?, metrics?) — 個別のページ。
• crux_history(origin? | url?, form_factor?, metrics?) — 約 40 週分のデータポイント。

認証

BYO とプラットフォームのフォールバックに対応しています。_apiKey を指定するか、ゲートウェイにシークレットが設定されている場合は PLATFORM_GOOGLE_API_KEY を使用します。API キーなしでの利用方法はありません。キーなしのリクエストに対して、API は HTTP 403「Method doesn't allow unregistered callers」を返します。

API キーは無料で、すぐに利用でき、自分で設定できます。課金アカウントは不要です。https://console.cloud.google.com/apis/credentials でキーを作成し、https://console.cloud.google.com/apis/library/chromeuxreport.googleapis.com で Chrome UX Report API を有効にしてください。クォータは 1 分あたり 150 クエリです。

同じ PLATFORM_GOOGLE_API_KEY が pagespeed-insights パックでも使われます。両方の API を有効にした Google Cloud キー 1 つで、両方を利用できます。

データソース

• https://chromeuxreport.googleapis.com/v1/records:queryRecord
• https://chromeuxreport.googleapis.com/v1/records:queryHistoryRecord

注意点（2026-09-17 に実環境で検証済み）

• 3 種類の認証情報エラーは、それぞれまったく異なる形式で返されます。 キーがない場合 → HTTP 403 PERMISSION_DENIED「Method doesn't allow unregistered callers」。キーが誤っている場合 → HTTP 400 INVALID_ARGUMENT「API key not valid」。プロジェクトで API が有効になっていないキーの場合 → 3 つ目の形式（SERVICE_DISABLED）。これらを「認証失敗」とひとまとめにすると、呼び出し元は誤った問題に対処することになります。それぞれ個別に報告します。
• origin と url は異なる問い合わせで、指定できるのはどちらか一方だけです。 両方を指定すると 400 になります。origin にパスを含めることはできません。
• HTTP 404 は、ウェブ上のほとんどのサイトに対する通常の応答です。 CrUX は、統計的に妥当で個人を特定できないだけの、オプトイン済み Chrome トラフィックが集まったページまたは origin のみを公開します。これはデータセットとしての回答であり、サービス停止ではありません。このパックは found: false, reason: "insufficient_traffic" として返します。URL のデータがなくても、その origin のデータは存在することがあります。より対象を絞ったフォームファクターには、それぞれ独立した、より高いしきい値が設定されています。
• 見出しに使われる数値は平均ではなく p75 です。 検索では 75 パーセンタイルで評価されます。ヒストグラムの平均を計算すると、異なる誤った数値になります。
• CLS は単位がなく、ほかのすべての指標はミリ秒単位です。 CrUX は CLS の p75 を小数の 文字列 として返し、時間の値は整数で返します。（PageSpeed Insights API は同じ指標を整数 ×100 として返します。2 つの Google API は、同じ数値のエンコード方式が一致していません。）
• crux_history の各データポイントは、過去 28 日間のローリングウィンドウです。 連続する週次データポイントは 27 日分重複するため、系列内の変化はローリング平均の変化です。また、1 週間の悪化は 4 つのデータポイントに分散して現れます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "chrome-ux-report": {
      "url": "https://gateway.pipeworx.io/chrome-ux-report/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/chrome-ux-report/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加えて、共有ツールが約 30 個表示されます。接続の initialize 応答に正確な対象範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然に多重化されているわけではありません。メタツールを使うと、このパックで扱わない質問にも、カタログ全体を横断する ask_pipeworx 経由で回答できます。そのため、2 つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールを含めずにパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1875 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/crux_query_origin \
  -H 'Content-Type: application/json' \
  -d '{"origin":"https://www.shopify.com"}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/crux_query_origin を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイを経由した通信も不要です。

{
  "mcpServers": {
    "chrome-ux-report": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-chrome-ux-report"]
    }
  }
}

または、次のように直接実行して、起動することを確認できます。

npx -y @pipeworx/mcp-chrome-ux-report

stdin／stdout 経由で MCP を使用し、initialize／tools/list／tools/call に対して、このパックのツールのみを提供します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールですが、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Chrome Ux Report data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT