افحص التسلسل الهرمي للعناوين وأخطاء H1
أدخل عناوينك بترتيب الصفحة لترى هل يصمد التسلسل: h1 وh2 وh3 وh2 وh3 تنجح، أما الانتقال من h2 مباشرة إلى h4 فيُبلَّغ عنه بوصفه h3 مفقودًا في موضعه بالضبط. ويلزم عنوان h1 واحد فقط. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- العناوين
- h1, h2, h3, h2, h3
- عدد العناوين
- 5
- عدد وسوم H1
- 1
قد يبدو التسلسل الهرمي للعناوين صحيحًا على الشاشة، بينما تروي الوسوم الأساسية قصة مختلفة. يستقبل هذا الفاحص وسوم العناوين بترتيب المستند، مثل h1 وh2 وh3 وh2، ثم يطبق قاعدتين محددتين: يجب أن يوجد h1 واحد بالضبط، وألا يهبط أي عنوان أكثر من مستوى واحد في كل انتقال. تعرض النتيجة حالة الصلاحية وعدد h1 والموضع الدقيق لكل مستوى متخطى، حتى تتمكن فرق التحرير وأنظمة النشر من معالجة المشكلات بوضوح.
جهزوا تسلسل الوسوم بحسب ترتيب المستند
ابدؤوا بوسوم العناوين كما تظهر تمامًا في المستند المعروض، وليس كما تظهر في ملف التصميم أو المخطط التحريري. قد يكون الإدخال المعتاد h1 وh2 وh3 وh2 وh3. للترتيب أهمية لأن التسلسل الهرمي يظهر في الانتقال من عنوان إلى العنوان الذي يليه.
يقبل الفاحص الوسوم من h1 إلى h6، ويحذف المسافات المحيطة، ويعامل الصيغ الكبيرة مثل H2 مثل الصيغ الصغيرة. ولا يقبل HTML عشوائيًا أو نص العنوان أو فئات CSS أو أرقامًا منفردة. استخرجوا هذه العناصر قبل إرسال الطلب ليظل الإدخال قائمة وسوم واضحة لا لبس فيها.
تُرفض القائمة الفارغة بوصفها إدخالًا غير صالح، إذ لا تتضمن بنية مستند قابلة للتقييم. ويُرفض الوسم المخالف أيضًا مع ذكر فهرسه في المصفوفة، مما يسهل تشخيص أي خلل في مرحلة الاستخراج. يفيد هذا الفصل في مسارات العمل الآلية: تحدد مرحلة الاستخراج الوسوم الموجودة، بينما تقيّم هذه القدرة ترتيبها ومستوياتها فقط، من دون خلط التنسيق المرئي بالبنية الدلالية.
افهموا قاعدتي التسلسل الهرمي
تشترط القاعدة الأولى وجود h1 واحد بالضبط في القائمة الكاملة. تفشل النتيجة عند غياب h1 لأن المستند يفتقر إلى عنوان رئيسي وحيد، كما تفشل عند وجود اثنين أو أكثر لأن المستوى الأعلى يصبح مكررًا. تفحص القاعدة الثانية كل زوج متجاور، وتسجل تخطيًا عندما يكون الرقم التالي أكبر من السابق بأكثر من واحد.
لذلك، يشير الانتقال من h2 إلى h4 إلى غياب h3. ويشير الانتقال من h1 إلى h5 إلى غياب h2 وh3 وh4 في ذلك الموضع. أما الصعود من h4 إلى h2 فهو مسموح، لأنه يغلق محتوى متداخلًا ويعود إلى قسم أوسع.
ويُسمح كذلك بتكرار المستوى، إذ يمكن لوسمي h2 متتاليين تقديم قسمين متوازيين. يبلغ الفاحص عن جميع حالات التخطي بدل التوقف عند أول حالة. يتضمن كل سجل فهرس وسم الوجهة بدءًا من الصفر، والانتقال، وجميع الوسوم الوسيطة المفقودة.
لا تكون النتيجة صالحة إلا إذا كان عدد h1 واحدًا وكانت قائمة المستويات المتخطاة فارغة.
استخدموا النتيجة في المراجعة وضوابط النشر
استخدموا حقل الصلاحية لاتخاذ قرار بسيط بالقبول أو الرفض، ثم احتفظوا بالتفاصيل لتقديم إرشادات تصحيح مفيدة. يؤكد العدد الإجمالي عدد الوسوم التي جرى تقييمها، ويوضح عدد h1 ما إذا كانت قاعدة المستوى الأعلى قد تحققت. تشير كل حالة تخطٍ إلى فهرس وسم الوجهة الذي حدث عنده الهبوط غير الصحيح، وبذلك يستطيع المحرر أو نظام البناء تحديد العنوان المعني من دون تفسير رسالة غامضة.
تقدم قائمة المشكلات ملخصات إنجليزية موجزة للسجلات أو تعليقات المراجعة أو واجهة إدارة المحتوى. لا تقيّم هذه القدرة صياغة العناوين أو الكلمات المفتاحية أو الحجم المرئي أو النص الفارغ أو العدد المناسب للأقسام. وهي لا تجلب عنوان URL ولا تحلل HTML؛ فإذا بدأتم من صفحة، استخرجوا قائمة الوسوم المرتبة أولًا.
ولأن الخوارزمية لا تستخدم الشبكة أو العشوائية أو الساعة أو حالة مخفية، فإن القائمة نفسها تنتج دائمًا الاستجابة نفسها، مما يجعلها مناسبة لفحوص ما قبل النشر واختبارات التراجع وعمليات التدقيق المجمعة.
حالات الاستخدام
منع مخططات المقالات غير الصحيحة
ارفضوا المسودة عندما لا تتضمن الوسوم المستخرجة h1 واحدًا، أو عندما تنتقل مباشرة إلى مستوى متداخل بصورة خاطئة.
فحص القوالب بعد إعادة التصميم
قارنوا صفحات ممثلة بعد عرضها، واكتشفوا تخطي المستويات الناتج عن المكونات القابلة لإعادة الاستخدام أو تغييرات القالب.
إضافة فحص البنية إلى CI
حولوا قائمة الوسوم المرتبة من بناء موقع ثابت إلى نتيجة نجاح أو فشل حتمية قبل النشر.
الأسئلة الشائعة
هل تُعد العودة من h4 إلى h2 تخطيًا؟
لا. يُسمح بالعودة إلى مستوى أوسع؛ ولا يُبلغ إلا عن هبوط يزيد على مستوى واحد.
هل تُقبل الوسوم المكتوبة بأحرف كبيرة؟
نعم. تُوحّد صيغ مثل H1 وH3 إلى الأحرف الصغيرة بعد التحقق، وتُتجاهل المسافات المحيطة.
هل تحلل هذه القدرة صفحة HTML؟
لا. فهي تتوقع قائمة مستخرجة مسبقًا من وسوم h1 إلى h6 بترتيب المستند، وتتحقق من ذلك التسلسل فقط.
ماذا يحدث إذا لم يكن في الصفحة h1 أو كان فيها أكثر من واحد؟
يفشل الفحص في الحالتين. فبلا h1 لا يكون للمستند عنوان أعلى واحد، ومع اثنين أو أكثر يتكرر المستوى الأعلى. ويُعاد عدد عناوين h1 لتعرف أي الحالتين تنطبق.
كيف يُبلَّغ عن القفز من h1 إلى h5؟
يُبلَّغ في موضع ذلك الانتقال بأن h2 وh3 وh4 مفقودة. وإذا تعددت القفزات فلا يتوقف الفحص عند أولها، بل يعرضها كلها مع موضع العنوان الذي وقعت عنده.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/seo/heading-structure-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"headings":["h1","h2","h3","h2"]}'const res = await fetch("https://api.kit.forhosting.com/seo/heading-structure-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"headings": [
"h1",
"h2",
"h3",
"h2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/seo/heading-structure-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"headings": [
"h1",
"h2",
"h3",
"h2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/heading-structure-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"headings":["h1","h2","h3","h2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"headings":["h1","h2","h3","h2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/heading-structure-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"headings": [
"h1",
"h2",
"h3",
"h2"
]
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.heading_structure_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
أسئلة تقنية
ما تكلفة الفحص؟
تكلف كل مطالبة API مقدار $0.002. الحساب حتمي ولا يستدعي أي خدمات خارجية.
ماذا يحدث عندما تكون قائمة العناوين فارغة؟
يعيد الطلب خطأ invalid_input لأن التسلسل الفارغ لا يحتوي على بنية يمكن التحقق منها.