ForHosting KIT · تحسين محركات البحث (SEO)

حقول أنواع Schema.org المطلوبة والموصى بها

اختيار نوع Schema.org ليس إلا الخطوة الأولى لإنشاء بيانات منظَّمة مفيدة. فالخصائص المدرجة هي التي تحدد قدرة محركات البحث والأنظمة الأخرى على فهم الصفحة.

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

شغّل الأداة مجانًا اطّلع على الـAPI

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

تقبل هذه الأداة أسماء معروفة مثل Article وProduct وRecipe وFAQPage، ثم تعرض فورًا قائمة عملية بالحقول. وهي تفصل الخصائص المطلوبة عادةً عن التحسينات الموصى بها، وتستخدم الأسماء القياسية، وترفض الأنواع غير المعروفة بوضوح كي لا تواصل العمليات الآلية عملها اعتمادًا على تخمين غير معلن.

ابدؤوا بالنوع الذي يمثل صفحتكم بدقة

تكون البيانات المنظَّمة أكثر فاعلية عندما يصف النوع المختار الموضوع الرئيسي للصفحة، لا مجرد عنصر صغير فيها. أدخلوا نوعًا من Schema.org مثل Product لسلعة قابلة للشراء، أو Recipe لتعليمات الطهي، أو Article للمحتوى التحريري، أو LocalBusiness لنشاط تجاري له وجود فعلي. لا يميز البحث بين حالة الأحرف، كما يقبل عنوان URL الكامل للنوع على schema.org، وهذا مفيد عندما تأتي القيمة من مستند JSON-LD موجود. تعرض النتيجة الاسم القياسي وعنوان URL القياسي مع قائمتين مرتبتين من الخصائص. إذا لم يكن الاسم ضمن الفهرس المدعوم، تعيد الأداة خطأ إدخال بدل اختراع تطابق تقريبي. يفيد ذلك في مسارات النشر، لأن خطأ مثل Productt سيوقف عملية البناء بدل إنتاج ترميز يبدو معقولًا لكنه بلا معنى محدد. اختاروا أدق نوع مدعوم يصف المحتوى، مع الانتباه إلى أن هذه الأداة تركز على الأنواع الشائعة في تطبيقات SEO ولا تشمل كل فئات مفردات Schema.org الكاملة.

تعاملوا مع الحقول بوصفها قائمة تنفيذ عملية

Schema.org هو معجم، ولا يفرض الخصائص على نحو شامل كما يفعل مخطط قاعدة البيانات. تضع ميزات البحث وأدوات التحقق والأنظمة اللاحقة قواعد أهلية خاصة بها، وقد تختلف باختلاف المنصة وطريقة العرض. لذلك تشير قائمة الحقول المطلوبة إلى الخصائص التي تعد عادةً الحد الأدنى المفيد في تطبيقات SEO، بينما تساعد الحقول الموصى بها على تحسين الاكتمال أو الأهلية أو جودة النتيجة المعروضة. اربطوا أولًا كل خاصية مطلوبة بمعلومة حقيقية وظاهرة في الصفحة، ثم أضيفوا الخصائص الموصى بها حين تتوفر بيانات مصدر موثوقة. لا تختلقوا تقييمًا أو سعرًا أو مؤلفًا أو صورة أو حالة توافر أو تاريخًا لمجرد إكمال القائمة. فكائن أقصر يستند إلى محتوى الصفحة أكثر أمانًا من ترميز غني يناقض ما يراه الزوار. تحتوي بعض الخصائص على كائنات متداخلة، مثل offers في Product وauthor في Article وlocation في Event وmainEntity في FAQPage. تسمي الأداة هذه الخصائص العليا، لكنها لا تنشئ القيم المتداخلة ولا تتحقق من مخطط JSON-LD كامل.

استخدموا النتائج الحتمية في التدقيق والنشر

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

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

تخطيط قالب JSON-LD

احصلوا على قائمة ثابتة قبل تصميم حقول CMS لقالب جديد من البيانات المنظَّمة.

تدقيق الخصائص الناقصة

قارنوا مفاتيح الترميز الحالي بالحد الأدنى والحقول الإضافية الشائعة للنوع المعلن.

إرشاد محرري المحتوى

اعرضوا المدخلات المطلوبة أولًا ثم الإضافات الموصى بها عند اختيار نوع الصفحة.

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

هل يفرض Schema.org نفسه هذه الحقول؟

لا. يعرّف Schema.org معجمًا لكنه لا يفرض الخصائص عادةً. تمثل قائمة الحقول المطلوبة الحد الأدنى الشائع في تطبيقات SEO.

ماذا يحدث عندما لا يكون النوع معروفًا؟

يعيد الطلب خطأ إدخال ويسرد الأسماء القياسية المدعومة، ولا يحاول مطلقًا تخمين نوع بديل.

هل يمكن إرسال عنوان Schema.org كامل؟

نعم. تُوحَّد قيمة مثل https://schema.org/Product إلى النوع القياسي Product.

هل تشمل النتيجة بنى الخصائص المتداخلة؟

لا. تسرد الخصائص العليا الشائعة فقط. يجب إنشاء كائنات مثل Offer وPerson وPostalAddress والتحقق منها بصورة منفصلة.

ما كلفة البحث عبر API؟

تبلغ كلفة كل طلب API مقدار $0.002. الخوارزمية حتمية ولا تستدعي أي خدمة خارجية.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/seo/schema-type-lookup

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

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

curl -X POST https://api.kit.forhosting.com/seo/schema-type-lookup \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"Product"}'

const res = await fetch("https://api.kit.forhosting.com/seo/schema-type-lookup", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "type": "Product"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/seo/schema-type-lookup",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "type": "Product"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/schema-type-lookup", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"type":"Product"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"type":"Product"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/schema-type-lookup", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "type": "Product"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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