Google CrUX MCP

本地服务

github.com数据与分析04 周前更新

代码仓库访问官网

关于 Google CrUX MCP

Google CrUX MCP 将 Chrome UX Report 的真实用户 Core Web Vitals 数据提供给 AI 应用，适合网站和页面性能分析。它支持设备、站点与页面对比及历史趋势，数据仅限满足流量条件的公开对象。

主要功能

01评估 Core Web Vitals
02比较不同设备的数据
03比较站点与页面
04查看 40 周趋势
05读取最新和历史原始记录
06仅查询真实用户数据

适用场景

01检查页面是否通过 Core Web Vitals
02比较移动端与桌面端指标
03对比页面和站点平均值
04分析 LCP、INP 和 CLS 趋势

MCP 相关

作为 MCP 服务，它向客户端提供 CrUX 公开数据的只读查询工具，包括指标评估、对比和历史记录。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "a1-x-tech-mcp-google-crux": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-crux"
      ],
      "env": {
        "CRUX_API_KEY": "<CRUX_API_KEY>",
        "CRUX_API_BASE": "<CRUX_API_BASE>",
        "CRUX_TIMEOUT_MS": "<CRUX_TIMEOUT_MS>",
        "CRUX_MAX_RETRIES": "<CRUX_MAX_RETRIES>"
      }
    }
  }
}

启动命令npx -y mcp-google-crux

需要配置的环境变量

CRUX_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+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-google-crux1.1.0stdio

工具

收录的工具列表 · 更新于 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 周趋势，以及最新或历史原始记录。
真实用户数据。 使用的 CrUX 实测数据与 PageSpeed Insights 和 Google 的 Core Web Vitals 信号相同。
数据可用性边界明确。 只有流量足够的公开来源和 URL 才有数据；no_data 是有效结果。
配额成本明确。 CrUX 每个项目每分钟允许查询 150 次。设备对比会进行 4 次 API 调用；来源与页面对比会进行 2 次。

从一个只读问题开始：

https://example.com 在移动设备上是否通过 Core Web Vitals？

连接服务 · 探索使用场景 · 查看技术文档

一分钟了解它如何工作

你： 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 密钥。
将服务添加到 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

Codex MCP 文档

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 Code MCP 文档

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。

Claude Desktop MCP 文档

Cursor

在 macOS/Linux 上，将 {"mcpServers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}} 添加到 ~/.cursor/mcp.json；在 Windows 上则添加到 %USERPROFILE%\.cursor\mcp.json。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 会为你解读指标阈值；原始记录工具则会公开完整直方图和密度比例。

没有数据并不意味着网站出故障，而是表示 Google 没有针对该来源、URL 或设备组获取足够大的公开 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` 毫秒。
`CRUX_MAX_RETRIES`	否	针对 429、5xx 和网络故障的重试次数；默认值为 `3`。

数据、限制和后台工作

只读公共数据集。 服务无法更改网站、Search Console、CrUX 记录或 Google 排名。
考虑配额的重试。 遇到 429、5xx 和网络错误时会进行退避重试。规划 150 次查询/分钟的项目配额时，请考虑复合比较。
无后台监控。 只有在被调用时，服务才会运行。如果你的 AI 应用支持计划任务，可以创建定期性能报告。
匿名遥测。 遥测会发送安装和版本数据以及工具名称，但绝不会发送 API 密钥、查询的 URL、结果、参数或提示词。设置 ASKADS_TELEMETRY=0 即可选择退出。