Skanuj stronę internetową

Polecenie scan pobiera publiczny adres URL, mierzy całkowity rozmiar strony i przeprowadza audyt zdrowia i18n oraz SEO strony. Generuje ono raport z punktacją (0–100) obejmujący atrybuty HTML, linki kanoniczne, tagi hreflang i ich linki zwrotne, robots.txt, mapy witryn, zlokalizowane linki wewnętrzne oraz wagę językową w pakiecie JavaScript.

Raportuje również, w jaki sposób witryna koduje język w swoich adresach URL (strategia routingu) oraz jakiego frameworka, biblioteki i18n, systemu zarządzania tłumaczeniami (TMS) lub proxy tłumaczeń używa. Te same testy napędzają internetowy skaner SEO i18n oraz rozszerzenie Intlayer do przeglądarki Chrome.

Nie są wymagane żadne dodatkowe zależności. Kiedy zainstalowany jest puppeteer, skanowanie może przechwytywać opóźnieniej ładowane (lazy-loaded) fragmenty kodu JavaScript dla dokładniejszej analizy pakietu; w przeciwnym razie wraca do inspekcji skryptów ładowanych natychmiast, zadeklarowanych w kodzie HTML.

Użycie

npx intlayer scan <url>

Przykład

npx intlayer scan https://example.com

Przykładowe dane wyjściowe:

🔍 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%)

Opcje

<url> (wymagane)

Pełny adres URL do zeskanowania (np. https://example.com).

--no-deep

Wyłącza głębsze skanowanie oparte na renderowaniu strony.

Domyślnie polecenie próbuje użyć biblioteki puppeteer do wyrenderowania strony w przeglądarce bezinterfejsowej (headless browser), przechwycenia opóźnioniej ładowanych fragmentów kodu JavaScript i zmierzenia rzeczywistego rozmiaru transferu. Jeśli puppeteer nie jest zainstalowany, polecenie automatycznie przechodzi w tryb podstawowy.

Przekaż --no-deep, aby wymusić tryb podstawowy, nawet gdy puppeteer jest dostępny.

Przykład: npx intlayer scan https://example.com --no-deep

--json

Wypisuje pełny wynik skanowania jako obiekt JSON zamiast sformatowanego raportu. Przydatne do użycia programistycznego lub w potokach CI.

Przykład: npx intlayer scan https://example.com --json

Standardowe opcje konfiguracji

• --base-dir: Katalog bazowy używany do zlokalizowania pliku intlayer.config.*.
• -e, --env: Środowisko docelowe (np. development, production).
• --env-file: Ścieżka do niestandardowego pliku .env.
• --no-cache: Wyłącza pamięć podręczną konfiguracji.
• --ci: Uruchamia polecenie w każdym projekcie Intlayer w monorepo (lub tylko w bieżącym, gdy uruchomione z katalogu projektu). Dane uwierzytelniające dla poszczególnych projektów można wstrzyknąć przez INTLAYER_PROJECT_CREDENTIALS, obiekt JSON mapujący ścieżkę projektu na { "clientId", "clientSecret" }.
• --verbose: Włącza pełne logowanie (domyślne w trybie CLI).
• --prefix: Niestandardowy prefiks logów.

Strategia routingu

Wzorzec językowy współdzielony przez alternatywy hreflang strony ujawnia, jak witryna kieruje swoimi językami. Bez alternatyw używany jest wyłącznie skanowany URL (niska pewność).

Sprawdzanie linków, linków kanonicznych, robots.txt i mapy witryny interpretuje każdy URL przez pryzmat tej strategii. Na przykład link bez prefiksu jest prawidłowy w domyślnym języku witryny prefix-no-default, a link bez ?lang= opuszcza język w witrynie typu search-params.

Wykryty stos

Frameworki, biblioteki i18n (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…), systemy zarządzania tłumaczeniami (Crowdin, Phrase, Lokalise, locize, Transifex, Tolgee, Localazy, SimpleLocalize, Localizely, Smartling, Intlayer CMS) oraz serwery proxy tłumaczeń (Weglot, Localize, GTranslate…) są identyfikowane na podstawie kodu HTML, załadowanych zasobów i pakietów JavaScript. Tryb głęboki odczytuje także zmienne globalne window oraz pliki cookie.

Co podlega sprawdzeniu

Ostrzeżenie daje połowę wagi punktowej. Ostateczny wynik jest ważoną sumą wykonanych sprawdzeń wyrażoną w procentach (0–100). Niepowodzenia w testach wyświetlają pierwsze znalezione problemy; użyj --json, aby uzyskać pełne szczegóły.

Programistyczne korzystanie z funkcji skanowania

Funkcja scan jest również eksportowana z @intlayer/cli, dzięki czemu można ją wywoływać z poziomu własnych skryptów:

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

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

W przypadku dostępu niskopoziomowego funkcja scanWebsite z modułu @intlayer/engine/scan zwraca ustrukturyzowany obiekt ScanResult:

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

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