مسح موقع الويب

يقوم الأمر scan بجلب عنوان URL عام، وقياس الحجم الإجمالي للصفحة، وتدقيق صحة i18n و SEO للصفحة. ينتج عنه تقرير بنقاط (0-100) يغطي سمات HTML، والروابط الأساسية، وعلامات hreflang وروابط العودة المقابلة لها، و robots.txt، وخرائط المواقع، والروابط الداخلية المترجمة، ووزن اللغة لحزمة JavaScript.

كما يوضح كيفية ترميز الموقع للغة في عناوين URL الخاصة به (استراتيجية التوجيه) وأي إطار عمل، أو مكتبة i18n، أو نظام إدارة الترجمة (TMS) أو وكيل ترجمة يستخدمه. تعمل نفس الفحوصات في أداة فحص i18n SEO عبر الإنترنت وملحق Intlayer لمتصفح Chrome.

لا توجد تبعيات إضافية مطلوبة. عندما يكون puppeteer مثبتًا، يمكن للمسح التقاط أجزاء JavaScript التي يتم تحميلها بشكل كسول (lazy-loaded) لتحليل حزمة أكثر دقة؛ وإلا فإنه يتراجع عن فحص البرامج النصية المحملة بلهفة المعلن عنها في HTML.

الاستخدام

npx intlayer scan <url>

مثال

npx intlayer scan https://example.com

نموذج المخرجات:

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

الخيارات

<url> (مطلوب)

عنوان URL المؤهل بالكامل للمسح (على سبيل المثال https://example.com).

--no-deep

تعطيل المسح العميق القائم على العرض.

بشكل افتراضي ، يحاول الأمر استخدام puppeteer لعرض الصفحة في متصفح بدون رأس ، والتقاط أجزاء JavaScript التي يتم تحميلها بشكل كسول ، وقياس حجم نقل السلك الحقيقي. إذا لم يكن puppeteer مثبتًا ، يتراجع الأمر تلقائيًا إلى الوضع الأساسي.

قم بتمرير --no-deep لفرض الوضع الأساسي حتى عند توفر puppeteer.

مثال: 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: تعطيل ذاكرة التخزين المؤقت للتكوين.
• --ci: ينفّذ الأمر في كل مشروع Intlayer في الـ monorepo (أو في المشروع الحالي فقط عند التشغيل من مجلد مشروع). يمكن حقن بيانات اعتماد لكل مشروع عبر INTLAYER_PROJECT_CREDENTIALS، وهو كائن JSON يربط مسار كل مشروع بـ { "clientId", "clientSecret" }.
• --verbose: تمكين التسجيل التفصيلي (افتراضي في وضع CLI).
• --prefix: بادئة تسجيل مخصصة.

استراتيجية التوجيه

يكشف نمط اللغة المشترك بين بدائل hreflang للصفحة عن كيفية توجيه الموقع للغاته. في حالة عدم وجود بدائل، يتم استخدام عنوان URL الممسوح بمفرده (مستوى ثقة منخفض).

تقرأ فحوصات الروابط والروابط الأساسية و robots.txt وخريطة الموقع كل عنوان URL عبر هذه الاستراتيجية. على سبيل المثال، يكون الرابط بدون بادئة صحيحًا في اللغة الافتراضية لموقع يعتمد prefix-no-default، بينما يؤدي الرابط بدون ?lang= إلى الخروج من اللغة في موقع يعتمد search-params.

التقنيات المكتشفة

يتم تحديد أطر العمل، ومكتبات 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…)، وأنظمة إدارة الترجمة (مثل Crowdin و Phrase و Lokalise و locize و Transifex و Tolgee و Localazy و SimpleLocalize و Localizely و Smartling و Intlayer CMS) ووكلاء الترجمة (مثل Weglot و Localize و GTranslate…) من خلال كود HTML والموارد المحملة وحزم JavaScript. كما يقرأ الوضع العميق المتغيرات العامة لـ window وملفات تعريف الارتباط.

ما يتم فحصه

يمنح التحذير نصف الوزن. النتيجة النهائية هي المجموع الموزون للفحوصات التي تم تشغيلها، معبرًا عنها كنسبة مئوية (0-100). تطبع الفحوصات الفاشلة المشاكل الأولى التي تم العثور عليها؛ استخدم --json للحصول على التفاصيل الكاملة.

استخدام وظيفة المسح برمجياً

يتم تصدير وظيفة scan أيضًا من @intlayer/cli بحيث يمكن استدعاؤها من البرامج النصية الخاصة بك:

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

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

للوصول إلى مستوى أدنى ، يعيد scanWebsite من @intlayer/engine/scan كائن ScanResult مهيكل:

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

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