Scansiona il sito web

Il comando scan recupera un URL pubblico, misura la dimensione totale della pagina e controlla la salute i18n e SEO della pagina. Produce un rapporto con punteggio (0–100) che copre attributi HTML, collegamenti canonici, tag hreflang e relativi link di ritorno, robots.txt, sitemap, collegamenti interni localizzati e il peso della locale nel bundle JavaScript.

Indica inoltre in che modo il sito codifica la locale nei suoi URL (strategia di routing) e quale framework, libreria i18n, sistema di gestione delle traduzioni (TMS) o proxy di traduzione utilizza. Gli stessi controlli alimentano lo scanner SEO i18n online e l'estensione Chrome di Intlayer.

Non sono richieste dipendenze aggiuntive. Quando puppeteer è installato, la scansione può catturare frammenti JavaScript caricati in modo ritardato (lazy-loaded) per un'analisi del bundle più precisa; in caso contrario, ricorre all'ispezione degli script caricati direttamente dichiarati nell'HTML.

Utilizzo

npx intlayer scan <url>

Esempio

npx intlayer scan https://example.com

Esempio di output:

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

Opzioni

<url> (richiesto)

L'URL completo da scansionare (ad esempio, https://example.com).

--no-deep

Disabilita la scansione approfondita basata sul rendering.

Per impostazione predefinita, il comando tenta di utilizzare puppeteer per eseguire il rendering della pagina in un browser headless, catturare frammenti JavaScript caricati in modo ritardato e misurare la dimensione reale del trasferimento. Se puppeteer non è installato, il comando ricorre automaticamente alla modalità base.

Passa --no-deep per forzare la modalità base anche quando puppeteer è disponibile.

Esempio: npx intlayer scan https://example.com --no-deep

--json

Mostra il risultato completo della scansione come oggetto JSON invece di un rapporto formattato. Utile per l'integrazione programmatica o pipeline di CI.

Esempio: npx intlayer scan https://example.com --json

Opzioni di configurazione standard

• --base-dir: Directory di base utilizzata per individuare il file intlayer.config.*.
• -e, --env: Ambiente di destinazione (ad esempio, development, production).
• --env-file: Percorso di un file .env personalizzato.
• --no-cache: Disabilita la cache di configurazione.
• --ci: Esegue il comando in ogni progetto Intlayer del monorepo (o solo in quello corrente se lanciato da una directory di progetto). Le credenziali per progetto possono essere iniettate tramite INTLAYER_PROJECT_CREDENTIALS, un oggetto JSON che associa ogni percorso di progetto a { "clientId", "clientSecret" }.
• --verbose: Abilita la registrazione dettagliata (impostazione predefinita in modalità CLI).
• --prefix: Prefisso di registro personalizzato.

Strategia di routing

Il pattern di locale condiviso dalle alternative hreflang della pagina rivela come il sito instrada le sue locale. Senza alternative, viene utilizzato unicamente l'URL scansionato (basso livello di confidenza).

I controlli su collegamenti, link canonici, robots.txt e sitemap leggono ogni URL attraverso questa strategia. Ad esempio, un link non prefissato è corretto nella locale predefinita di un sito prefix-no-default, e un link senza ?lang= abbandona la locale su un sito search-params.

Stack rilevato

Framework, librerie 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…), sistemi di gestione delle traduzioni (Crowdin, Phrase, Lokalise, locize, Transifex, Tolgee, Localazy, SimpleLocalize, Localizely, Smartling, Intlayer CMS) e proxy di traduzione (Weglot, Localize, GTranslate…) sono identificati dall'HTML, dalle risorse caricate e dai bundle JavaScript. La modalità avanzata legge anche le variabili globali di window e i cookie.

Cosa viene controllato

Un avviso assegna metà del punteggio. Il punteggio finale è la somma ponderata dei controlli eseguiti espressa in percentuale (0–100). I controlli non superati stampano i primi problemi rilevati; usa --json per tutti i dettagli.

Utilizzo programmatico della funzione di scansione

La funzione scan viene anche esportata da @intlayer/cli per essere richiamata dai tuoi script:

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

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

Per l'accesso di livello inferiore, scanWebsite da @intlayer/engine/scan restituisce un oggetto ScanResult strutturato:

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

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