ForHosting KIT · قراءة المواقع ومراقبتها

إنشاء مخطط BreadcrumbList بصيغة JSON-LD

حوّلوا مسار التنقل الظاهر إلى بيانات منظّمة من دون ترقيم العناصر أو تركيب JSON متداخل يدويًا.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

أدخلوا أسماء الصفحات وروابطها المطلقة حسب ترتيب ظهورها، بدءًا من الصفحة الأعم وصولًا إلى الصفحة الحالية. ينشئ المولّد كائن BreadcrumbList من schema.org وكتلة script كاملة بصيغة JSON-LD، جاهزة للوضع في رأس الصفحة أو متنها. ويتحقق قبل إخراج الترميز من القوائم الفارغة والصفوف غير الصحيحة والأسماء الناقصة والروابط غير المدعومة.

جهّزوا مسار التنقل وفق ترتيب الصفحة

ابدؤوا بالتسلسل الهرمي نفسه الذي يراه زائر الصفحة. يمثّل الصف الأول عادة الصفحة الرئيسية أو أوسع قسم مفيد، ثم تأتي صفحات أكثر تخصيصًا بالتدريج، ويحدّد الصف الأخير الصفحة الحالية. يحتاج كل صف إلى اسم ظاهر وموجز وإلى رابط مطلق يستخدم HTTP أو HTTPS. تزيل الروابط المطلقة الالتباس لدى برامج الزحف وتجعل الترميز قابلًا للاستخدام عبر القوالب ونطاقات المعاينة وأنظمة إدارة المحتوى. اجعلوا الأسماء مطابقة للصفحات المرتبطة بدل حشوها بالكلمات المفتاحية. تحافظ الأداة على الترتيب المرسل تمامًا وتمنح المواضع بدءًا من 1، ولذلك فإن تبديل الصفوف يغيّر معنى المسار. لا تزحف الأداة إلى الموقع، ولا تستنتج بنيته، ولا تقارن العناصر بالتنقل المعروض في HTML. راجعوا عمليات إعادة التوجيه والروابط الأساسية والتهجئة وحالة الأحرف قبل إنشاء الكتلة. تُرفض القائمة الفارغة لأنها لا تعبّر عن مسار مفيد، وغالبًا ما تدل على قالب معطّل أو طلب غير مكتمل.

افهموا بنية JSON-LD الناتجة

تتضمن النتيجة كائن schema للاستخدام البرمجي وكتلة script كاملة يمكن إدراجها مباشرة في صفحة ويب. في المستوى الأعلى يشير السياق إلى schema.org ويكون النوع BreadcrumbList. يتحول كل زوج مُدخل إلى ListItem يضم موضعًا يبدأ من 1، والاسم بعد حذف المسافات الطرفية، والرابط داخل الخاصية item. يسهل التنسيق المقروء مراجعة الناتج ويعطي النتيجة نفسها للمدخلات المتطابقة. كما يستبدل المولّد محارف أصغر من داخل القيم المتسلسلة، كي لا يتمكن نص مدخل من إغلاق عنصر script مبكرًا عند تضمينه في HTML. لا يقبل التحقق إلا أسماء غير فارغة وروابط مطلقة تستخدم HTTP أو HTTPS؛ أما مخططات javascript وdata وmailto والمسارات النسبية فتُرفض. الخوارزمية حتمية ولا ترسل أي طلبات عبر الشبكة، لذلك لا تؤكد استجابة الرابط أو قابلية الصفحة للفهرسة. استخدموا كائن schema عندما يتولى تطبيق آخر التسلسل، أو حقل jsonld عندما تحتاجون إلى الترميز الكامل من دون تجميع إضافي.

انشروا ترميز المسار وتحققوا منه

أضيفوا كتلة script واحدة منشأة إلى الصفحة التي يمثّلها المسار، سواء في رأس المستند أو متنه وفق ما يسمح به نظام النشر لـ JSON-LD. أبقوا المسار المنظّم متوافقًا مع روابط يستطيع المستخدمون رؤيتها وفتحها فعلًا. إذا كان نظام إدارة المحتوى يصدر أصلًا بيانات منظّمة لمسار التنقل، فاستبدلوا الكتلة القديمة أو عطّلوها بدل نشر نسخ متنافسة تختلف في المواضع أو الروابط. أعيدوا إنشاء الترميز كلما انتقلت صفحة أو تغير اسم قسم أو عُدلت الروابط الأساسية. بعد النشر افحصوا HTML النهائي المعروض، لا القالب المصدري فقط، لأن القوالب ومديري الوسوم وإضافات التحسين قد تكرر عناصر script أو تحذفها أو تعدلها. استخدموا بعد ذلك أداة لاختبار البيانات المنظّمة أو فحص محرك البحث لاكتشاف المشكلات الخارجة عن نطاق المولّد، مثل الوجهات المتعذرة أو الوسوم الأساسية المتعارضة أو الترميز الموضوع في صفحة خاطئة. صحة JSON-LD شرط تقني وليست ضمانًا لظهور خاص في نتائج البحث. تبلغ تكلفة طلب API الواحد $0.002، ويمكن للمتصفح تنفيذ المنطق نفسه من دون إرسال بيانات المسار عبر الشبكة.

حالات الاستخدام

إضافة الترميز إلى قالب صفحة

حوّلوا مسار القالب المرتب إلى كتلة BreadcrumbList جاهزة للإدراج.

توحيد مخرجات نظام المحتوى

أنشئوا بنية JSON-LD متسقة للمقالات والمنتجات والفئات وأقسام التوثيق.

إصلاح البيانات المنظّمة الناقصة

أنشئوا ترميزًا بديلًا عندما يظهر المسار للزوار ولا يتوفر بصيغة قابلة لقراءة الآلات.

الأسئلة الشائعة

ماذا يحدث إذا كانت القائمة فارغة؟

يفشل الطلب بخطأ إدخال غير صالح، لأن BreadcrumbList يجب أن يحتوي على عنصر مفيد واحد على الأقل.

ما الترتيب الذي ينبغي استخدامه؟

أدخلوا الصفحات من المستوى الأعم إلى الصفحة الحالية؛ يحافظ المولّد على هذا الترتيب ويرقّم بدءًا من 1.

هل يمكن استخدام روابط نسبية؟

لا. يحتاج كل عنصر إلى رابط مطلق يستخدم HTTP أو HTTPS لكي تكون البيانات المنظّمة واضحة.

هل يتحقق المولّد من وجود الصفحات؟

لا. فهو لا يتصل بالشبكة؛ يتحقق من الصياغة والمخطط، وليس من الحالة أو الفهرسة أو التحويلات أو الروابط الأساسية.

أين توضع الكتلة الناتجة؟

ضعوا عنصر script في الرأس أو المتن وفق نظام النشر، وتأكدوا من عدم إصدار ترميز مكرر لمسار التنقل.

ما تكلفة طلب API؟

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن تنفيذ التحويل الحتمي نفسه داخل المتصفح أيضًا.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/web/breadcrumb-schema-generate

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/web/breadcrumb-schema-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"breadcrumbs":[{"name":"Home","url":"https://example.com/"},{"name":"Guides","url":"https://example.com/guides"},{"name":"Technical SEO","url":"https://example.com/guides/technical-seo"}]}'

const res = await fetch("https://api.kit.forhosting.com/web/breadcrumb-schema-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "breadcrumbs": [
      {
        "name": "Home",
        "url": "https://example.com/"
      },
      {
        "name": "Guides",
        "url": "https://example.com/guides"
      },
      {
        "name": "Technical SEO",
        "url": "https://example.com/guides/technical-seo"
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/breadcrumb-schema-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "breadcrumbs": [
        {
            "name": "Home",
            "url": "https://example.com/"
        },
        {
            "name": "Guides",
            "url": "https://example.com/guides"
        },
        {
            "name": "Technical SEO",
            "url": "https://example.com/guides/technical-seo"
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/breadcrumb-schema-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"breadcrumbs":[{"name":"Home","url":"https://example.com/"},{"name":"Guides","url":"https://example.com/guides"},{"name":"Technical SEO","url":"https://example.com/guides/technical-seo"}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"breadcrumbs":[{"name":"Home","url":"https://example.com/"},{"name":"Guides","url":"https://example.com/guides"},{"name":"Technical SEO","url":"https://example.com/guides/technical-seo"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/breadcrumb-schema-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "breadcrumbs": [
    {
      "name": "Home",
      "url": "https://example.com/"
    },
    {
      "name": "Guides",
      "url": "https://example.com/guides"
    },
    {
      "name": "Technical SEO",
      "url": "https://example.com/guides/technical-seo"
    }
  ]
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.breadcrumb_schema_generate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`timeout_sec`	30
`max_crawl_pages`	25

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←