Google CrUX MCP

English | Русский

A1 Google CrUX MCP добавляет в AI-приложение реальные пользовательские данные Core Web Vitals. Проверяйте, соответствует ли публичный сайт или страница порогам LCP, INP и CLS, сравнивайте мобильную и десктопную версии и смотрите, как метрики менялись со временем.

Он читает набор данных Google Chrome UX Report — полевые данные, собранные от пользователей Chrome, а не синтетический тест скорости и не инструмент для изменения сайта.

• 6 инструментов только для чтения. Оценка Core Web Vitals, сравнение устройств, сравнение источника и страницы, тренд за 40 недель и «сырые» свежие или исторические записи.

• Реальные пользовательские данные. Это те же полевые данные CrUX, которые используются в PageSpeed Insights и сигналах Core Web Vitals от Google.

• Понятная граница доступности. Данные есть только у публичных источников и URL с достаточным трафиком реальных пользователей; no_data — это корректный результат.

• Известная стоимость квоты. CrUX разрешает 150 запросов в минуту на проект. Сравнение устройств совершает четыре вызова API, сравнение источника и страницы — два.

Начните с вопроса в режиме только для чтения:

Соответствует ли https://example.com Core Web Vitals на мобильных?

Подключить сервер · Примеры использования · Техническая документация

Посмотрите, как это работает, за минуту

Вы: Соответствует ли https://example.com/pricing Core Web Vitals на мобильных?

Ассистент: Показывает значения LCP, INP и CLS на уровне p75, их оценки «хорошо/требует улучшений/плохо» и общий результат. Ничего не меняется.

Вы: Сравните эту страницу со средними значениями по сайту и покажите, чем мобильная версия отличается от десктопной.

Ассистент: Сравнивает источник и URL, затем группы устройств и их доли трафика. Все шесть инструментов читают только публичный набор данных CrUX.

Related MCP server: GSC Analyst Connector

Содержание

• Быстрый старт

• Что можно попросить сервер сделать

• Как читать данные CrUX

• Получение доступа

• Настройка

• Данные, лимиты и фоновая работа

• Техническая документация

• Поддержка

Быстрый старт

Нужны Node.js 20+ и API-ключ Google Cloud с включённым Chrome UX Report API.

1. Создайте ключ API с ограниченными правами.

2. Добавьте сервер в своё AI-приложение.

3. Задайте вопрос выше — в режиме только чтения.

В Settings → Plugins → MCP servers выберите Add server, затем добавьте npx -y mcp-google-crux@latest и передайте CRUX_API_KEY.

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"}}}}.

Если пункт Изменить конфигурацию недоступен, отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows. Документация по MCP для Claude Desktop

Добавьте {"mcpServers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}} в ~/.cursor/mcp.json на macOS/Linux или %USERPROFILE%\.cursor\mcp.json на Windows. Документация по MCP для Cursor

Выполните 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. Документация по MCP для VS Code

Что можно попросить сервер сделать

• Проходит ли этот публичный источник или URL проверку Core Web Vitals?

• Сравните результаты для телефона, десктопа, планшета и всех устройств.

• Эта страница быстрее или медленнее, чем в среднем по сайту?

• Как менялись LCP, INP и CLS за последние 40 недель?

• Покажите «сырые» гистограммы и перцентили CrUX для технической проверки.

Как читать данные CrUX

CrUX предоставляет данные за скользящее окно в 28 дней, которое обновляется ежедневно. Исторические данные — еженедельные, обновляются по понедельникам. Ключевое значение — p75: ему оно 75% зафиксированных визитов находятся на этом уровне или ниже. get_core_web_vitals сам интерпретирует пороги метрик, а инструменты «сырых» записей показывают полные гистограммы и доли плотности.

Отсутствие данных не означает, что сайт сломан. Это значит, что у Google нет достаточно большой выборки публичных пользователей Chrome для этого источника, URL или группы устройств. У планшетов и отдельных URL данных часто нет.

Получение доступа

1. В Google Cloud Console создайте или выберите проект. Для CrUX не нужен платёжный аккаунт.

2. Включите Chrome UX Report API.

3. Создайте API-ключ в APIs & Services → Credentials.

4. Ограничьте ключ только Chrome UX Report API и передайте его как CRUX_API_KEY.

Ключ хранится в конфигурации MCP-клиента и передаётся в URL запроса к API, поэтому обращайтесь с ним как с паролем.

Настройка

Данные, лимиты и фоновая работа

• Публичный набор данных, только чтение. Сервер не может изменять сайты, Search Console, записи CrUX или позиции в Google.

• С учётом лимита. Повторяет запросы при 429, 5xx и сетевых ошибках с экспоненциальной задержкой. Учитывая составные сравнения, планируйте квоту 150 запросов в минуту на проект.

• Нет фонового мониторинга. Сервер работает только при вызове. Если ваше AI-приложение поддерживает плановые задания, оно может создавать периодический отчёт о производительности.

• Анонимная телеметрия. Отправляются данные об установке, версии и названия инструментов; никогда не передаются ключи API, запрашиваемые URL, результаты, аргументы или промпты. Установите ASKADS_TELEMETRY=0, чтобы отказаться.

Техническая документация

• Каталог возможностей MCP — страницы по задачам для каждого инструмента.

• Все инструменты и входные данные

• Документация для разработки

• Документация по публикации

• Документация CrUX API

Поддержка

Нашли ошибку или нужен сценарий? Создайте issue или напишите в Telegram.