Pagespeed Insights

@pipeworx/pagespeed-insights

Google の PageSpeed Insights — Google 独自のインフラストラクチャ上で、あらゆる公開 URL に対して Lighthouse を実行し、パフォーマンス／アクセシビリティ／ベストプラクティス／SEO のスコア、それらの基となるラボの計測時間指標、各修正で削減できるミリ秒数やバイト数を示した具体的な修正項目のランキングを返します。さらに、そのページとオリジンの実ユーザーの Chrome UX Report データも返します。

Pipeworx の一部です。AI エージェントを 1683 以上のライブデータソースに接続する MCP ゲートウェイです。

ツール

• pagespeed_audit(url, strategy?, categories?, max_opportunities?, locale?) — ラボの実行結果と、ランキング形式の改善機会です。
• pagespeed_field_metrics(url, strategy?) — ページとそのオリジンの実ユーザーの Core Web Vitals と、Google の合格／不合格判定です。

認証

BYO とプラットフォームのフォールバックに対応しています。_apiKey を指定するか、ゲートウェイにシークレットとして設定されている場合は PLATFORM_GOOGLE_API_KEY を使用します。

キーなしで利用できるとドキュメントに記載された方法はありますが、使用できません。 キーなしのリクエストは、単一の共有 Google 匿名コンシューマープロジェクトに課金されますが、その日次クォータは使い果たされています。キーなしの呼び出しを連続して 3 回行ったところ、「consumer 'project_number:583797351490' のクォータを超過しました」という HTTP 429 が返されました（2026-09-17 にライブ環境で確認）。このプロジェクト番号はインターネット上の匿名ユーザー全員で共通のため、こちらでクォータを確保することはできず、再試行しても解決しません。このパックはまずキーなしで試し、キーが必要であることを示すメッセージとともに処理を拒否します。

キーは無料ですぐに取得でき、請求先アカウントは不要です。https://console.cloud.google.com/apis/credentials で作成し、https://console.cloud.google.com/apis/library/pagespeedonline.googleapis.com で PageSpeed Insights API を有効にしてください。クォータは 1 日あたり 25,000 リクエスト、1 分あたり 240 リクエストです。同じキーを chrome-ux-report パックでも使用できます。

chrome-ux-report パックとの関係

chrome-ux-report は実際の訪問者が体験した状況を報告しますが、フィールドデータには診断情報が含まれないため、理由はわかりません。このパックはページを実行し、原因を示します。「実際のユーザーにとってこのサイトは速いか」には CrUX を、「具体的に何が遅くしていて、何を優先して修正すべきか」にはこのパックを使ってください。

データソース

• https://www.googleapis.com/pagespeedonline/v5/runPagespeed

2026-09-17 にライブ環境で確認した注意点

• 呼び出しには 10～40 秒かかります。 Google が実際にページを読み込みます。このパックでは明示的に 60 秒の上限を設定しています。URL を 10 件まとめて処理する場合は、数分かかることを見込んでください。
• ラボとフィールドの結果は頻繁に食い違いますが、どちらも正しい値です。 ラボの実行結果は、Google のデータセンターから、スロットリングされたエミュレート端末で 1 回読み込んだ値です。フィールドブロックは、実際のデバイスでの 28 日間の実訪問データです。ラボスコアが 95 でもフィールドの CWV が不合格なら、実際のユーザーはエミュレーションより性能の低いハードウェアを使っており、Google 検索が使用するのはフィールドの値です。両方をラベル付きで返し、決して混ぜません。
• loadingExperience はページ、originLoadingExperience はサイトを示します — トラフィックの少ない URL では、Google がページブロックにオリジンの値を設定し、origin_fallback: true を設定することがあります。それをページのデータとして読み取ると、サイト全体のパフォーマンスを 1 つの URL に誤って帰属させることになります。ここでは is_origin_fallback として報告します。
• カテゴリスコアは 0～1 の浮動小数点数で、null の場合もあります。 カテゴリでエラーが発生すると、0 ではなく null が返されます。
• 到達できないターゲットに対する Google の応答は HTTP 400 で、404 や 5xx ではありません。 有用な情報は error.errors[].reason の奥にあります。ここでの「Bad request」は多くの場合、「サイトが Google のクローラーに 500 を返した」という意味です。
• この API の CLS は整数を 100 倍した値です（5 は 0.05）。一方、CrUX API は同じ指標を小数の文字列として返します。このパックでは小数に正規化します。

クイックスタート

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

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

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

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

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

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

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

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

MCP クライアントがなくても、HTTP で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/pagespeed_audit \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://www.wikipedia.org"}'

最初の呼び出しにアカウントは不要です。任意のツールの情報を確認するには、GET https://gateway.pipeworx.io/v1/tools/pagespeed_audit を使います。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使います。

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

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

{
  "mcpServers": {
    "pagespeed-insights": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-pagespeed-insights"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-pagespeed-insights

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Pagespeed Insights data" })

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

詳細情報

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

ライセンス

MIT