Scan Website

Команда scan запрашивает публичный URL, измеряет общий размер страницы и проверяет состояние i18n и SEO страницы. Она создает отчет с оценкой (0–100), охватывающий HTML-атрибуты, канонические ссылки, теги hreflang и обратные ссылки на них, robots.txt, карты сайта, локализованные внутренние ссылки и вес локалей в JavaScript-бандле.

Она также сообщает, как сайт кодирует локаль в URL (стратегия маршрутизации), а также какой фреймворк, библиотеку i18n, систему управления переводами (TMS) или прокси переводов использует. Те же проверки работают в онлайн i18n SEO-сканере и в расширении Intlayer для Chrome.

Никаких дополнительных зависимостей не требуется. Если установлен puppeteer, сканирование может фиксировать лениво загружаемые (lazy-loaded) JavaScript-чанки для более точного анализа сборки; в противном случае оно проверяет только скрипты, объявленные в HTML для немедленной загрузки.

Использование

npx intlayer scan <url>

Пример

npx intlayer scan https://example.com

Пример вывода:

🔍 Scanned https://example.com/fr (basic mode)

Score: 91/100
Page size: 10.60 MB (HTML 42.31 KB)
Locales: fr, en, es, de
Routing: locale prefix except for the default locale (every hreflang alternate but "en" starts with a locale segment, default locale: en)

Stack:
  Framework Next.js 15.1.0
  i18n library next-intl
  TMS Crowdin
Checks:
  ✓ html lang attribute
  ✓ html dir attribute
  ✓ locale signals consistent (lang, URL, hreflang)
  ⚠ og:locale meta tag
      Missing <meta property="og:locale">: social previews default to en_US
  ✓ canonical link
  ✓ hreflang tags
  ✓ x-default hreflang
  ✓ hreflang alternates link back
  ✓ unused bundle locale content
  ✓ localized internal links
  ⚠ all internal links keep the locale
      2 internal links leave the "fr" locale (0 to another locale, 2 without locale)
        <a href="/pricing">Tarifs</a>
  ✓ crawlable language switcher
  ✓ robots.txt present
  ✓ robots.txt keeps localized URLs crawlable
  ✓ sitemap present
  ✓ sitemap lists every locale
  ✓ sitemap has alternate links
  ✓ sitemap has x-default

Bundle locale weight:
  Translations shipped: 120.50 KB
  Unused (other locales): 45.20 KB (37%)

Параметры

<url> (обязательно)

Полный URL-адрес для сканирования (например, https://example.com).

--no-deep

Отключить более глубокое сканирование на основе рендеринга страницы.

По умолчанию команда пытается использовать puppeteer для рендеринга страницы в headless-браузере, захвата отложенно загружаемых JS-чанков и измерения реального объема передаваемых данных. Если puppeteer не установлен, команда автоматически переключается в базовый режим.

Передайте --no-deep, чтобы принудительно использовать базовый режим, даже если puppeteer доступен.

Пример: npx intlayer scan https://example.com --no-deep

--json

Вывод полного результата сканирования в виде JSON-объекта вместо форматированного отчета. Полезно для программного использования или в CI-пайплайнах.

Пример: npx intlayer scan https://example.com --json

Стандартные параметры конфигурации

• --base-dir: Базовая директория для поиска файла intlayer.config.*.
• -e, --env: Целевое окружение (например, development, production).
• --env-file: Путь к кастомному файлу .env.
• --no-cache: Отключить кэширование конфигурации.
• --ci: Выполняет команду в каждом проекте Intlayer монорепозитория (или только в текущем при запуске из директории проекта). Учетные данные для каждого проекта можно подставить через INTLAYER_PROJECT_CREDENTIALS, JSON-объект, сопоставляющий путь проекта с { "clientId", "clientSecret" }.
• --verbose: Включить подробное логирование (по умолчанию включено в режиме CLI).
• --prefix: Кастомный префикс для логов.

Стратегия маршрутизации

Шаблон локалей, общий для альтернатив hreflang страницы, показывает, как сайт маршрутизирует свои локали. Без альтернатив используется только сканируемый URL (низкий уровень уверенности).

Проверки ссылок, канонических URL, robots.txt и карты сайта анализируют каждый URL через эту стратегию. Например, ссылка без префикса корректна для локали по умолчанию на сайте с prefix-no-default, а ссылка без ?lang= приводит к выходу из локали на сайте с search-params.

Обнаруженный стек

Фреймворки, библиотеки интернационализации (Intlayer, i18next, react-i18next, next-i18next, next-intl, use-intl, react-intl, vue-i18n, @nuxtjs/i18n, Lingui, svelte-i18n, Paraglide, ngx-translate, Transloco, Polylang, WPML…), системы управления переводами (Crowdin, Phrase, Lokalise, locize, Transifex, Tolgee, Localazy, SimpleLocalize, Localizely, Smartling, Intlayer CMS) и прокси переводов (Weglot, Localize, GTranslate…) определяются по HTML, загруженным ресурсам и JavaScript-бандлам. В глубоком режиме также проверяются глобальные переменные window и cookie.

Что проверяется

Предупреждение дает половину веса оценки. Итоговая оценка представляет собой средневзвешенную сумму всех выполненных проверок, выраженную в процентах (0–100). Непройденные проверки выводят первые обнаруженные проблемы; используйте --json для получения полной информации.

Использование функции сканирования в коде

Функция scan также экспортируется из пакета @intlayer/cli, поэтому её можно вызывать в ваших собственных скриптах:

import { scan } from "@intlayer/cli";

await scan("https://example.com", {
  deep: false,
  json: false,
});

Для более низкоуровневого доступа функция scanWebsite из модуля @intlayer/engine/scan возвращает структурированный объект ScanResult:

import { scanWebsite } from "@intlayer/engine/scan";

const result = await scanWebsite("https://example.com", { deep: false });
console.log(result.score, result.totalPageSize, result.events);