أداة مجانية

أداة التحقق من JSON-LD للبيانات المنظَّمة

اكتشف أخطاء صيغة JSON-LD بالسطر والعمود، ثم افحص الخصائص التي تطلبها Google في 7 أنواع من schema. أداة مجانية تعمل في متصفحك.

تعمل بالكامل في متصفحك. لا يُرفع ما تُدخله، ولا يُسجَّل، ولا يُحفظ.

كتلة JSON-LD

لا يُرسل أي شيء تلصقه هنا إلى أي مكان؛ يُحلَّل في متصفحك فقط.

أهم النقاط

يظهر خطأ صيغة JSON مع رقم السطر والعمود، بدل رسالة عامة عن فشل التحليل.
تقول Google إن Article وOrganization ليس لهما خصائص مطلوبة، بل خصائص مقترحة فقط.
تقول Google إن عليك تضمين كل الخصائص المطلوبة ليصبح العنصر مؤهلًا للعرض المحسَّن في البحث.
لم يعد FAQPage وHowTo يحصلان على نتيجة غنية بصريًا في بحث Google، حتى مع ترميز صالح.
تحذّر Google من ترميز معلومات لا يراها المستخدم، ولا تستطيع أي أداة تحقق كشف ذلك من كتلة ملصقة.

ما تحتاج إليه

كتلة JSON-LD ملصقة، تُحرَّر مباشرة في مربع النص

أدوات أخرى

كلها مجانية، وكلها تعمل في المتصفح.

تصفّح الأدوات

طريقة الاستخدام

1الصق كتلة JSON-LDانسخ محتوى وسم script الذي نوعه application/ld+json من الصفحة، لا شيفرة HTML المحيطة به.
2أصلح أخطاء الصيغة أولًافاصلة ناقصة أو مفتاح بلا علامتي تنصيص يوقف JSON.parse قبل أي فحص للبنية، ويشير السطر والعمود المعروضان إلى موضع الخطأ.
3راجِع النوع المكتشفتقرأ الأداة @context و@type من الكائن، وتبحث عن النوع في جدول خصائصها. والنوع غير المدعوم تذكره باسمه بدل تخطيه بصمت.
4قارن قائمة الخصائص بالصفحةالخاصية المفقودة لا تهم إلا إذا كانت الصفحة الحقيقية تعرض ذلك المحتوى؛ لا تضف خاصية لا تظهر قيمتها في الصفحة.
5اعتبر نتائج FAQPage وHowTo للعلم فقطكلاهما معلَّم بأنه لم يعد مؤهلًا لنتيجة غنية بصريًا في Google، فالنجاح فيهما يؤكد صحة الترميز، لا الظهور في البحث.

تصف Google تنسيق JSON-LD بأنه التنسيق الذي توصي به للبيانات المنظَّمة، والأسهل في التطبيق والصيانة على نطاق واسع. لكنه سهل الكسر أيضًا: فاصلة واحدة ناقصة وتُتجاهل الكتلة كلها.

تلتقط هذه الأداة ذلك أولًا، ثم تقارن الكتلة بالخصائص التي توثقها Google لنوعها، وهي قائمة أضيق وأكثر فائدة من كل ما يسمح به schema.org.

ماذا تفحص الأداة؟

تعمل الأداة على مرحلتين، في متصفحك.

الصيغة: يمر النص عبر JSON.parse الصارمة. وعند الفشل تعرض رسالة المحلّل، وإذا ذكر المتصفح موضع الحرف، كما يفعل Chrome، تحوّله إلى سطر وعمود. ولا يعمل أي فحص آخر حتى يُحلَّل JSON.

البنية: مع JSON صالح تفحص ثلاثة أمور:

المستوى الأعلى كائن واحد، لا مصفوفة ولا قيمة مفردة.
@context نص يحتوي على schema.org. والسياق المفقود، أو الذي ليس نصًا، يظهر كمفقود.
@type موجود. وإذا طابق أحد الأنواع السبعة، تظهر كل خاصية موثّقة كموجودة، أو مفقودة (مطلوبة)، أو مفقودة (مقترحة).

@type	المطلوب في الأداة
Article	لا شيء
Product	name، وواحدة من review أو aggregateRating أو offers
FAQPage	mainEntity
HowTo	name وstep
Organization	لا شيء
BreadcrumbList	itemListElement
Recipe	name وimage

والخصائص المقترحة في الأداة:

Article: headline وimage وauthor وdatePublished وdateModified.
Product: aggregateRating وoffers وreview.
Organization: name وurl وlogo وsameAs وcontactPoint.
Recipe: author وdatePublished وdescription وprepTime وcookTime وtotalTime وrecipeYield وrecipeIngredient وrecipeInstructions وnutrition.calories.
FAQPage وHowTo وBreadcrumbList: لا شيء.

ليس لـ Article وOrganization خصائص مطلوبة لأن Google تقول إنه لا توجد لأي منهما. أما FAQPage وHowTo، اللذان حُذفت وثائقهما لدى Google، فتفحص الأداة لهما قائمة قصيرة من عندها، وتضيف ملاحظة بأن النتيجة الغنية بصريًا انتهت.

ويسجّل سجل تحديثات Google حذف وثائق HowTo في 14 سبتمبر 2023، وحذف وثائق الأسئلة الشائعة في 15 يونيو 2026، مع توضيح أن الميزة لم تعد تظهر في البحث.

كيف تقرأ النتائج؟

خطأ في الصيغة: اذهب إلى السطر والعمود المعروضين. والأسباب المعتادة فاصلة زائدة بعد آخر خاصية، أو فاصلة ناقصة بين خاصيتين، أو علامات تنصيص مفردة بدل المزدوجة.
@context أو @type كتحذير: حُلِّلت الكتلة، لكن لا يمكن التعرف عليها كترميز schema.org.
مفقودة (مطلوبة): تقول Google إن عليك تضمين كل خاصية مطلوبة ليصبح العنصر مؤهلًا للعرض المحسَّن. أصلح هذه قبل النشر.
مفقودة (مقترحة): قرار تقديري. تقول Google إن عددًا أقل من الخصائص المقترحة الكاملة والدقيقة أفضل من خصائص كثيرة سيئة الصياغة، فأضف فقط ما تعرضه الصفحة فعلًا.
سطر “تمت المقارنة مع”: يذكر صفحة وثائق Google التي جاءت منها قائمة الخصائص.

مثال عملي

تفتح الأداة بكتلة Article: عنوان في headline، ورابط صورة واحد، وdatePublished وdateModified بصيغة ISO 8601، ومؤلف من نوع Person له name وurl.

تعرض الأداة أن JSON صالح، و@context هو https://schema.org، و@type هو Article، والخصائص المقترحة الخمس كلها موجودة.

احذف سطر image وستتحول image إلى مفقودة (مقترحة)، لا إلى فشل، لأن Google لا تذكر خصائص مطلوبة لـ Article. وإذا غيّرت @type إلى Product بدلًا من ذلك، تحصل على خطأين في الخصائص المطلوبة: name، وواحدة من review أو aggregateRating أو offers.

أخطاء شائعة تكشفها

الفواصل الزائدة: صالحة في JavaScript وغير صالحة في JSON، وهي أكثر سبب يجعل الكتلة تفشل بصمت.
لصق وسم script: الغلاف <script> شيفرة HTML، فيفشل التحليل عند أول حرف. الصق ما بداخله فقط.
ترميز Product بلا مراجعة أو تقييم أو عرض: تشترط Google واحدًا من الثلاثة لمقتطف المنتج.
Recipe بلا صورة: الخاصية image واحدة من خاصيتين مطلوبتين فقط في Recipe.
الاعتماد على FAQPage أو HowTo لنتيجة غنية بصريًا: الترميز صالح، لكن الميزة انتهت في Google.

ما لا تستطيع الأداة فحصه هو تطابق الترميز مع الصفحة. تحذّر Google من ترميز معلومات لا يراها المستخدمون، حتى لو كانت دقيقة. اختبر العنوان الحقيقي في اختبار النتائج الغنية بصريًا من Google قبل الاعتماد على أي نتيجة.

أدوات وقراءات ذات صلة

المصادر

1.Understand how structured data works، Google Search Centralمصدر أساسي
2.Article, NewsArticle, BlogPosting structured data، Google Search Central
3.Product snippet structured data، Google Search Central
4.Organization structured data، Google Search Central
5.Recipe structured data، Google Search Central
6.Breadcrumb structured data، Google Search Central
7.Latest Google Search documentation updates، Google Search Centralمصدر أساسي

أسئلة شائعة

كيف أتحقق من JSON-LD؟

انسخ النص داخل وسم script من نوع application/ld+json في الصفحة، دون الوسم نفسه، والصقه في المربع. تحلّله الأداة مع كل تغيير أو عند الضغط على تحقّق، وتعرض أي خطأ صيغة مع موضعه، ثم الخصائص الموثّقة لدى Google الموجودة لنوع @type المكتشف.

هل تعني النتيجة النظيفة أن الصفحة مؤهلة لنتيجة غنية بصريًا؟

لا. تعني أن الكتلة تُحلَّل وتحمل الخصائص التي توثقها Google لذلك النوع. تقول Google إن البيانات المنظَّمة لا تضمن نتيجة غنية بصريًا، وإن الأهلية تعتمد على سياسات مثل ترميز المحتوى الظاهر فقط. ونتيجة FAQPage وHowTo لم تعد موجودة.

لماذا لا يظهر شيء مطلوب في Article؟

لأن وثائق Google تقول إنه لا توجد خصائص مطلوبة. فالخصائص headline وimage وauthor وdatePublished وdateModified مقترحة، لذلك تعلّم الأداة الناقصة منها كمقترحة لا كفشل. وOrganization مثلها.

ما الأنواع التي تفحصها الأداة؟

Article وProduct وFAQPage وHowTo وOrganization وBreadcrumbList وRecipe. وأي @type آخر يحصل على فحوص الصيغة و@context و@type، مع ملاحظة أنه لا جدول خصائص له. ولنوع JobPosting استخدم أداة فحص JobPosting المخصصة.

لماذا يظهر @type مفقودًا في كتلة @graph؟

تقرأ الأداة @type من الكائن في المستوى الأعلى فقط. والكتلة التي تضم عدة عناصر داخل @graph ليس لها @type في المستوى الأعلى، والمصفوفة في المستوى الأعلى تُرفض مباشرة. الصق كل عنصر ككائن مستقل لفحصه.