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 次查询。设备对比需要四次 API 调用；来源与页面对比需要两次。

从一个只读问题开始：

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

连接服务器 · 探索用例 · 打开技术文档

一分钟体验

你： https://example.com/pricing 在移动端是否通过 Core Web Vitals？

助手： 显示 p75 LCP、INP 和 CLS，它们的良好/需要改进/较差评级以及总体结果。不会改变任何内容。

你： 将此页面与站点平均值进行比较，并展示移动端与桌面端的差异。

助手： 比较来源和 URL，然后比较设备组及其流量占比。所有六个工具都只读取公开的 CrUX 数据集。

Related MCP server: GSC Analyst Connector

目录

• 快速开始

• 你可以让它做什么

• 如何阅读 CrUX 数据

• 获取访问权限

• 配置

• 数据、限制和后台工作

• 技术文档

• 支持

快速开始

你需要 Node.js 20+ 和已启用 Chrome UX Report API 的 Google Cloud API 密钥。

1. 创建受限 API 密钥。

2. 将服务器添加到你的 AI 应用。

3. 提出上面的只读问题。

在 设置 → 插件 → MCP 服务器 中，选择 添加服务器，然后使用 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 文档

打开 设置 → 开发者 → 编辑配置 并添加 {"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 文档

将 {"mcpServers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}} 添加到 macOS/Linux 上的 ~/.cursor/mcp.json，或 Windows 上的 %USERPROFILE%\.cursor\mcp.json。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？

• 比较手机、桌面、平板和所有设备的结果。

• 这个页面比站点平均值更快还是更慢？

• 过去 25 周里 LCP、INP 和 CLS 如何变化？

• 显示原始 CrUX 直方图和百分位数，供技术审查使用。

如何阅读 CrUX 数据

CrUX 报告一个滚动 28 天窗口，每日更新。历史数据按周提供，每周一更新。关键值是 p75：75% 的观测访问量等于或低于该值。get_core_web_vitals 会为你解读指标阈值；原始记录工具则暴露完整的直方图和密度分数。

没有数据并不意味着网站有问题。它意味着 Google 没有针对该来源、URL 或设备组的足够大的公开 Chrome 用户样本。平板设备和单个 URL 通常没有数据。

获取访问权限

1. 在 Google Cloud Console 中创建或选择一个项目；CrUX 不需要结算账户。

2. 启用 Chrome UX Report API。

3. 在 API 和服务 → 凭据 中创建 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 文档

支持

发现 bug 或需要某个场景？创建 issue 或在 Telegram 中留言。