Scan Website

Perintah scan mengambil URL publik, mengukur total ukuran halaman, dan mengaudit kesehatan i18n serta SEO halaman tersebut. Ini menghasilkan laporan dengan skor (0–100) yang mencakup atribut HTML, tautan kanonis, tag hreflang dan tautan baliknya, robots.txt, sitemap, tautan internal yang terlokalisasi, dan bobot bahasa pada bundel JavaScript.

Perintah ini juga melaporkan bagaimana situs mengodekan locale pada URL-nya (strategi perutean) serta framework, pustaka i18n, sistem manajemen terjemahan (TMS), atau proxy terjemahan yang digunakan. Pemeriksaan yang sama mendukung pemindai SEO i18n online dan ekstensi Chrome Intlayer.

Tidak diperlukan dependensi tambahan. Jika puppeteer terinstal, pemindaian dapat menangkap fragmen JavaScript yang dimuat secara asinkron (lazy-loaded) untuk analisis bundel yang lebih presisi; jika tidak, perintah akan kembali memeriksa skrip yang dimuat secara langsung yang dideklarasikan dalam HTML.

Penggunaan

npx intlayer scan <url>

Contoh

npx intlayer scan https://example.com

Contoh keluaran:

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

Opsi

<url> (diperlukan)

URL lengkap yang akan dipindai (misalnya https://example.com).

--no-deep

Menonaktifkan pemindaian mendalam berbasis rendering.

Secara default, perintah mencoba menggunakan puppeteer untuk merender halaman di browser headless, menangkap fragmen JavaScript yang dimuat secara asinkron, dan mengukur ukuran transfer sebenarnya. Jika puppeteer tidak terinstal, perintah akan secara otomatis beralih ke mode dasar.

Gunakan --no-deep untuk memaksa mode dasar bahkan ketika puppeteer tersedia.

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

--json

Menghasilkan seluruh hasil pemindaian sebagai objek JSON alih-alih laporan terformat. Berguna untuk penggunaan programatis atau alur kerja CI.

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

Opsi konfigurasi standar

• --base-dir: Direktori dasar yang digunakan untuk mencari file intlayer.config.*.
• -e, --env: Lingkungan target (misalnya development, production).
• --env-file: Jalur ke file .env kustom.
• --no-cache: Menonaktifkan cache konfigurasi.
• --ci: Menjalankan perintah di setiap proyek Intlayer dalam monorepo (atau hanya proyek saat ini jika dijalankan dari direktori proyek). Kredensial per proyek dapat disuntikkan melalui INTLAYER_PROJECT_CREDENTIALS, sebuah objek JSON yang memetakan path proyek ke { "clientId", "clientSecret" }.
• --verbose: Mengaktifkan pencatatan detail (default dalam mode CLI).
• --prefix: Prefiks pencatatan kustom.

Strategi perutean

Pola locale yang dibagikan oleh alternatif hreflang halaman mengungkapkan bagaimana situs merutekan locale-nya. Tanpa alternatif, hanya URL yang dipindai yang digunakan (keandalan rendah).

Pemeriksaan tautan, kanonikal, robots.txt, dan sitemap membaca setiap URL melalui strategi ini. Sebagai contoh, tautan tanpa awalan sudah benar pada locale default dari situs prefix-no-default, dan tautan tanpa ?lang= akan meninggalkan locale pada situs search-params.

Stack yang terdeteksi

Framework, pustaka 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…), sistem manajemen terjemahan (Crowdin, Phrase, Lokalise, locize, Transifex, Tolgee, Localazy, SimpleLocalize, Localizely, Smartling, Intlayer CMS), dan proxy terjemahan (Weglot, Localize, GTranslate…) diidentifikasi dari HTML, sumber daya yang dimuat, dan bundel JavaScript. Mode mendalam juga membaca variabel global window dan cookie.

Apa yang diperiksa

Peringatan menghasilkan setengah dari bobot nilai. Skor akhir adalah jumlah bobot dari pemeriksaan yang dijalankan yang dinyatakan dalam persentase (0–100). Pemeriksaan yang gagal mencetak masalah pertama yang ditemukan; gunakan --json untuk rincian lengkap.

Menggunakan fungsi scan secara programatis

Fungsi scan juga diekspor dari @intlayer/cli sehingga dapat dipanggil dari skrip Anda sendiri:

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

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

Untuk akses tingkat lebih rendah, scanWebsite dari @intlayer/engine/scan mengembalikan objek ScanResult yang terstruktur:

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

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