Web Sitesini Tara

scan komutu, herkese açık bir URL'yi getirir, toplam sayfa boyutunu ölçer ve sayfanın i18n ile SEO durumunu denetler. HTML özniteliklerini, kurallı (canonical) bağlantıları, hreflang etiketlerini ve dönüş bağlantılarını, robots.txt dosyasını, site haritalarını, yerelleştirilmiş dahili bağlantıları ve JavaScript paketindeki yerel ayar ağırlığını kapsayan puanlı bir rapor (0–100) üretir.

Ayrıca sitenin URL'lerinde yerel ayarı nasıl kodladığını (yönlendirme stratejisi) ve hangi çerçeveyi, i18n kütüphanesini, çeviri yönetim sistemini (TMS) veya çeviri vekil sunucusunu kullandığını raporlar. Aynı kontroller çevrimiçi i18n SEO tarayıcısını ve Intlayer Chrome uzantısını güçlendirir.

Ekstra bağımlılık gerekmez. puppeteer kurulu olduğunda tarama işlemi, daha hassas bir paket analizi için geç yüklenen (lazy-loaded) JavaScript parçalarını yakalayabilir; aksi takdirde HTML'de bildirilen doğrudan yüklenen betikleri incelemeye geri döner.

Kullanım

npx intlayer scan <url>

Örnek

npx intlayer scan https://example.com

Örnek çıktı:

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

Seçenekler

<url> (gerekli)

Taranacak tam nitelikli URL (örneğin https://example.com).

--no-deep

Daha derin işleme tabanlı taramayı devre dışı bırakır.

Varsayılan olarak komut, sayfayı başsız (headless) bir tarayıcıda işlemek, geç yüklenen JavaScript parçalarını yakalamak ve gerçek aktarım boyutunu ölçmek için puppeteer kullanmaya çalışır. Puppeteer kurulu değilse, komut otomatik olarak temel moda geri döner.

Puppeteer kullanılabilir olduğunda bile temel modu zorlamak için --no-deep parametresini geçirin.

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

--json

Biçimlendirilmiş bir rapor yerine tarama sonucunun tamamını bir JSON nesnesi olarak çıktı verir. Programatik tüketim veya CI hatları için kullanışlıdır.

Örnek: npx intlayer scan https://example.com --json

Standart yapılandırma seçenekleri

• --base-dir: intlayer.config.* dosyasını bulmak için kullanılan temel dizin.
• -e, --env: Hedef ortam (örneğin development, production).
• --env-file: Özel bir .env dosyasının yolu.
• --no-cache: Yapılandırma önbelleğini devre dışı bırakır.
• --ci: Komutu monorepo'nun her Intlayer projesinde çalıştırır (bir proje dizininden çalıştırıldığında yalnızca mevcut projede). Proje başına kimlik bilgileri, proje yolunu { "clientId", "clientSecret" } ile eşleyen bir JSON nesnesi olan INTLAYER_PROJECT_CREDENTIALS aracılığıyla eklenebilir.
• --verbose: Ayrıntılı günlüğe kaydetmeyi etkinleştirir (CLI modunda varsayılan).
• --prefix: Özel günlük ön eki.

Yönlendirme stratejisi

Sayfanın hreflang alternatifleri tarafından paylaşılan yerel ayar deseni, sitenin dillerini nasıl yönlendirdiğini ortaya çıkarır. Alternatifler olmadığında yalnızca taranan URL kullanılır (düşük güvenilirlik).

Bağlantı, canonical, robots.txt ve site haritası kontrolleri her URL'yi bu strateji üzerinden okur. Örneğin, ön eksiz bir bağlantı prefix-no-default bir sitenin varsayılan dilinde doğrudur, search-params bir sitede ise ?lang= içermeyen bir bağlantı dilden ayrılır.

Tespit edilen yığın

Çerçeveler, i18n kütüphaneleri (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…), çeviri yönetim sistemleri (Crowdin, Phrase, Lokalise, locize, Transifex, Tolgee, Localazy, SimpleLocalize, Localizely, Smartling, Intlayer CMS) ve çeviri vekilleri (Weglot, Localize, GTranslate…) HTML'den, yüklenen kaynaklardan ve JavaScript paketlerinden tanımlanır. Derin mod ayrıca window genel değişkenlerini ve çerezleri de okur.

Neler kontrol edilir?

Bir uyarı ağırlığın yarısını kazandırır. Nihai puan, çalıştırılan kontrollerin ağırlıklı toplamının yüzde olarak ifadesidir (0–100). Başarısız kontroller ilk bulunan sorunları yazdırır; tüm ayrıntılar için --json kullanın.

Tarama işlevini programlı olarak kullanma

scan işlevi, kendi betiklerinizden çağrılabilmesi için @intlayer/cli paketinden de dışa aktarılır:

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

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

Daha düşük seviyeli erişim için, @intlayer/engine/scan altındaki scanWebsite yapılandırılmış bir ScanResult nesnesi döndürür:

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

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