Chrome Ux Report

@pipeworx/chrome-ux-report

适用于流量充足的任意网站的真实用户 Core Web Vitals 数据，来自 Google Chrome UX Report——实际 Chrome 访客在过去 28 天体验到的第 75 百分位最大内容绘制、交互到下次绘制 和累积布局偏移数据，以及每个数值背后的分布和约 40 周的历史数据。

属于 Pipeworx——一个将 AI Agent 连接到 1875+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关，也未获得其认可或发布。

这是 Google Search 用于评估 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 个每周数据点。

身份验证

支持自带密钥，并在平台上配置回退：_apiKey，或网关设置了该密钥时使用 PLATFORM_GOOGLE_API_KEY。不支持无密钥调用——未携带密钥的请求会收到 API 返回的 HTTP 403 错误“Method doesn't allow unregistered callers”。

密钥免费、即时可用且可自行申请，无需结算账号：前往 https://console.cloud.google.com/apis/credentials 创建密钥，并在 https://console.cloud.google.com/apis/library/chromeuxreport.googleapis.com 启用 Chrome UX Report API。配额为每分钟 150 次查询。

同一个 PLATFORM_GOOGLE_API_KEY 也适用于 pagespeed-insights 包：只需一个启用了这两个 API 的 Google Cloud 密钥即可同时调用。

数据来源

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

陷阱，已于 2026-09-17 通过实时验证

• 三种凭据错误的表现完全不同。 缺少密钥 → HTTP 403 PERMISSION_DENIED，“Method doesn't allow unregistered callers”。密钥错误 → HTTP 400 INVALID_ARGUMENT，“API key not valid”。密钥所属项目未启用 API → 第三种错误形式（SERVICE_DISABLED）。若将它们统统归为“身份验证失败”，就会让调用方排查错误的问题；这里会分别报告。
• origin 和 url 是不同的问题，而且只能传入其中一个。 同时传入两者会返回 400。Origin 不能包含路径。
• 对大多数网站而言，HTTP 404 是正常响应。 CrUX 只会在页面或 Origin 的 Chrome 用户选择加入流量达到足够数量、确保统计结果可靠且无法识别个人后才发布数据。这是数据集给出的结果，不是服务中断；此工具会将其返回为 found: false, reason: "insufficient_traffic"。URL 可能没有数据，但其 Origin 有数据。较窄的设备类型各自有更高的门槛。
• 核心数值是 p75，而不是平均值。 Search 按第 75 百分位进行评估；对直方图取平均值会得到不同且错误的数值。
• CLS 没有单位；其他所有指标的单位均为毫秒。 CrUX 返回的 CLS p75 是十进制字符串，而时间指标是整数。（PageSpeed Insights API 将相同指标返回为整数 ×100——两个 Google API 对同一数值的编码方式不一致。）
• crux_history 中的每个数据点都是过去 28 天的滚动窗口。 连续的每周数据点会重叠 27 天，因此数据序列中的变化代表滚动平均值的变化，而为期一周的回退会分散到四个数据点中。

快速开始

添加到你的 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 跨整个目录进行路由——而无需你添加第二个 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