ウェブサイトのスキャン

scan コマンドは、公開URLを取得し、総ページサイズを測定し、そのページの i18n および SEO の健全性を監査します。HTML属性、カノニカルリンク、hreflangタグ、robots.txt、sitemap.xml、ローカライズされた内部リンク、およびJavaScriptバンドル内のロケールデータ重量をカバーするスコア付きレポート（0〜100）を生成します。

追加の依存関係は必要ありません。puppeteer がインストールされている場合、より正確なバンドル分析のために、遅延ロード（lazy-loaded）されるJavaScriptチャンクを取得できます。インストールされていない場合は、HTML内に宣言されている即時ロードされるスクリプトの検査にフォールバックします。

使用方法

npx intlayer scan <url>

例

npx intlayer scan https://example.com

出力例：

🔍 Scanned https://example.com (basic mode)Score: 90/100Page size: 10.60 MB (HTML 42.31 KB)Locales: en, fr, es, de, …Checks:  ✓ html lang attribute  ✓ html dir attribute  ✓ canonical link  ✓ hreflang tags  ✓ x-default hreflang  ✓ localized internal links  ⚠ all internal links localized  ✓ current locale detected  ✓ robots.txt present  ✓ robots.txt keeps locale paths crawlable  ✓ sitemap.xml present  ✓ sitemap lists every locale  ✓ sitemap has alternate links  ✓ sitemap has x-defaultBundle locale weight:  Translations shipped: 120.50 KB  Unused (other locales): 45.20 KB (37%)

オプション

<url>（必須）

スキャンする完全修飾URL（例：https://example.com）。

--no-deep

レンダリングに基づく深いスキャンを無効にします。

デフォルトでは、コマンドは puppeteer を使用してヘッドレスブラウザでページをレンダリングし、遅延ロードされるJavaScriptチャンクを取得して、実際の転送サイズを測定しようとします。puppeteerがインストールされていない場合、コマンドは自動的に基本モードにフォールバックします。

puppeteerが利用可能な場合でも、基本モードを強制するには --no-deep を渡します。

例：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 — 設定キャッシュを無効にします。
• --verbose — 詳細ログを有効にします（CLIモードではデフォルト）。
• --prefix — カスタムログプレフィックス。

チェック項目

最終スコアは、合格したすべてのチェックの加重合計をパーセンテージ（0〜100）で表したものです。

プログラムによるスキャン機能の使用

scan 関数は @intlayer/cli からもエクスポートされており、独自のスクリプトから呼び出すことができます：

import { scan } from "@intlayer/cli";await scan("https://example.com", {  deep: false,  json: false,});

より低レベルのアクセスには、@intlayer/chokidar/scan の scanWebsite が構造化された ScanResult オブジェクトを返します：

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