Настройки cookie

Необходимые cookies держат сайт рабочим. Аналитика показывает, какие страницы полезны. Выбор можно изменить в любой момент — из футера.

Политика cookie — подробно: категории cookie, как мы храним ваш выбор в браузере и как отозвать согласие.

Необходимые

Базовые функции сайта и ваш выбор согласия. Всегда включены.

Аналитика

Помогает понять, как используют сайт. Загружается только после вашего разрешения.

GitHubСкачать ZIP

Отчёт CrUX по Core Web Vitals

Полевые Core Web Vitals из Chrome UX Report. Лабораторные замеры вынесены отдельно, чтобы их не путали. Понадобится свой ключ Google Cloud API.

Открыть на GitHubБыстрый старт

Что делает

  • Терминал: опции seohead crux-report

Полевые данные, а не лабораторные

crux-report возвращает LCP, INP и CLS на 75-м перцентиле по реальным визитам в Chrome. Каждую метрику сверяют с порогами web.dev и отмечают как хорошо, нужно улучшить или плохо. Результаты Lighthouse и PageSpeed — лабораторные замеры, они хранятся в отдельных отчётах.

  • Пороги: LCP 2,5 и 4 с, INP 200 и 500 мс, CLS 0,1 и 0,25.
  • Если данных нет, метрика помечается как недоступная, а не как пройденная.
  • В отчёте указаны даты сбора.

Ключ и охват

Нужен ключ Google Cloud API с включённым Chrome UX Report API. Без него отчёт сообщит, что не запустился. Можно запросить один URL, origin или ограниченную выборку до 25 URL.

  • Ключ читается из CRUX_API_KEY или из пути в конфиге и отправляется в заголовке запроса, а не в URL.
  • --form-factor принимает PHONE, DESKTOP или TABLET.
  • --origin даёт агрегат по origin с соответствующей пометкой. Он не заменяет отсутствующие данные по URL.
  • --cache-dir сохраняет локальный кэш только для вас для запусков на выборке.

В аудит сайта

Сохраните JSON от crux-report и передайте его в site-audit с --crux-evidence. Аудит читает сохранённый файл и не обращается к Google. Так один результат по полевым данным можно использовать в нескольких аудитах.

  • Области URL и origin в аудите остаются раздельными.
  • Полевые результаты никогда не заменяют лабораторные результаты Lighthouse.

Три шага — один сохранённый скан

  1. Добавьте ключ Google API

    Сохраните ключ Chrome UX Report API в пути конфига или в CRUX_API_KEY. Без него отчёт сообщит, что не запустился.

  2. Получите полевой p75 для одного URL

    Запустите crux-report для URL, при необходимости с --form-factor PHONE или DESKTOP, и получите LCP, INP и CLS на 75-м перцентиле.

  3. Сверьте значения с официальными порогами

    Каждая метрика помечается как хорошо, нужно улучшить или плохо по лимитам web.dev (LCP 2,5/4 с, INP 200/500 мс, CLS 0,1/0,25). Отсутствующие данные показываются как недоступные, а не как пройденные.

Одна команда

bash
seohead crux-report --url https://example.com/

Сначала установите: руководство по установке. Каждая команда работает и как MCP-инструмент для ИИ-агентов.

Что нужно

  • Ключ Google Cloud API с включённым Chrome UX Report API
  • Адрес страницы, origin или до 25 URL для выборки
  • Необязательно: форм-фактор (PHONE, DESKTOP или TABLET)

Ограничения

  • CrUX покрывает только URL и origin с достаточным трафиком из Chrome. Для остальных данных не будет.
  • Отчёт показывает текущее окно сбора, а не причину, по которой страница медленная.
  • Разбор ответа SpiderHead проверяет офлайн. Что ваш ключ работает, он не утверждает, пока вы не запустите отчёт.
  • Полевые данные — не лабораторные, и они не заменяют Lighthouse.

Вопросы

Нужен аккаунт Google или платный тариф?
Нужен ключ Google Cloud API с включённым Chrome UX Report API. Вызовы бесплатны в пределах квоты Google API.
Почему метрика помечена как недоступная?
Для этого URL или форм-фактора в CrUX нет актуальной записи, период сбора некорректен или запрос к провайдеру не удался. Недоступная метрика никогда не засчитывается как пройденная.
Можно получить CrUX для всего сайта?
Используйте --origin для агрегата по origin. Он помечен как агрегат по origin и не заменяет отсутствующие данные по URL. Для нескольких страниц передайте --urls с выборкой до 25 URL.
Это то же самое, что PageSpeed или Lighthouse?
Нет. CrUX — полевые данные реальных пользователей Chrome. PSI и Lighthouse — лабораторные замеры, в отчётах они хранятся отдельно.
Как добавить CrUX в аудит сайта?
Сохраните JSON от crux-report, затем передайте его в site-audit с --crux-evidence. Аудит читает сохранённый файл локально и не обращается к Google.
Что сохраняется на моём компьютере?
По умолчанию ничего. Ключ остаётся в переменных окружения или в папке конфига. Если вы используете --cache-dir, кэш выборочных результатов хранится там приватно 24 часа по умолчанию.

Что ещё посмотреть

Из блога и глоссария

Core Web Vitals: полное руководство 2026БлогLCP: как оптимизировать Largest Contentful PaintБлогChrome UX Report (CrUX)ГлоссарийCore Web VitalsГлоссарийInteraction to Next Paint (INP)Глоссарий

Ещё в этой группе · Источники данных

Интеграция с Google Search ConsoleВозможностьДанные GA4 и Яндекс МетрикиВозможностьИнтеграция с Яндекс ВебмастеромВозможностьАнализатор лог-файлов сервераВозможностьПроверка обратных ссылок по известным донорамВозможностьИнструмент для сбора семантического ядраВозможность

Проверьте на своём сайте

Скачать ZIPВсе возможности