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

معاينة مقتطف SERP

قد تبدو نتيجة البحث مرتبة في مستند، ثم تظهر بصورة غير مناسبة في صفحة النتائج. تستقبل معاينة مقتطف SERP هذه العنوان والرابط المطلق ووصف الميتا المراد نشرها، وتطبق حدود العرض الشائعة، ثم تعيد تخطيطاً نصياً بسيطاً من ثلاثة أسطر.

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

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

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

كما توضح الحقول التي اختُصرت، مما يجعلها مناسبة للمراجعة التحريرية السريعة، وضمان الجودة القابل للتكرار، ومسارات المحتوى الآلية قبل نشر الصفحات.

عاين النص الذي يُرجح أن يتصفحه الباحثون

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

افهم الاختصار الحتمي والتحقق من الرابط

يجب أن يكون كل حقل مطلوب سلسلة نصية غير فارغة. تُختزل المسافات المتتابعة إلى مسافة واحدة قبل العد، مما يمنع اختلافات التنسيق غير المرئية من إنتاج معاينات مضللة. يعتمد العد على نقاط ترميز Unicode، ولذلك لا تُقسم الأحرف الشائعة ذات العلامات ولا الرموز التعبيرية في منتصف تمثيلها المرمّز. إذا تجاوزت القيمة الموحّدة حدها، يُستبدل آخر حرف ظاهر بعلامة حذف؛ وهكذا تظل النتيجة المكتملة ضمن الحد المعلن. تخضع الروابط لفحص إضافي، إذ يجب أن تُحلل بوصفها عناوين مطلقة وأن تستخدم HTTP أو HTTPS. تُرفض المسارات النسبية مثل /products/new لأنها لا تعيّن وجهة كاملة لنتيجة البحث. يُسلسل الرابط الصالح بصيغة موحّدة قبل عده وعرضه. تتضمن الاستجابة الحقول المعروضة وسلسلة معاينة جاهزة للاستخدام وقيمة منطقية للاختصار تخص كل حقل والحدود المطبقة. تتيح هذه المخرجات المنظمة للتطبيق عرض المعاينة وإصدار تنبيه تحريري خاص به عندما تُختصر أي قيمة.

استخدم المعاينة في النشر وضمان الجودة

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

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

راجع البيانات الوصفية قبل النشر

تحقق من بقاء أهم كلمات العنوان والوصف ظاهرة بعد تطبيق الاختصار المعتاد.

أضف الفحوص إلى مسار CMS

اعرض البيانات الوصفية المحفوظة واستخدم علامات الاختصار لتوجيه المحررين إلى الحقول التي تحتاج صياغة أقصر.

اختبر صفحات الهبوط المولدة

شغّل معاينات حتمية لعدد كبير من الصفحات المولدة، واحتفظ بالمخرجات المنظمة في تقارير الجودة.

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

ما تكلفة المعاينة الواحدة؟

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

هل تحاكي الأداة نتائج Google بدقة؟

لا. فهي تطبق حدوداً عملية للحروف لتقديم معاينة تحريرية متسقة، بينما تختلف المقتطفات الفعلية باختلاف البحث والجهاز والعرض وإعادة الصياغة.

لماذا يجب أن يكون الرابط مطلقاً؟

يوفر عنوان HTTP أو HTTPS الكامل المصدر والوجهة اللازمين لنتيجة بحث واضحة. أما المسارات النسبية فتُرفض.

كيف يُختصر النص الطويل؟

يُحذف النص الذي يتجاوز حد الحقل، ويُستخدم آخر موضع متاح للحرف من أجل علامة الحذف.

هل تجلب الأداة صفحتي أو تفحصها؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/seo/serp-snippet-preview

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

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

curl -X POST https://api.kit.forhosting.com/seo/serp-snippet-preview \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Practical Technical SEO Checklist for Growing Websites","url":"https://example.com/resources/technical-seo-checklist","description":"Review crawlability, indexing, metadata, internal links, structured data, performance, and monitoring with a practical technical SEO checklist."}'

const res = await fetch("https://api.kit.forhosting.com/seo/serp-snippet-preview", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "title": "Practical Technical SEO Checklist for Growing Websites",
    "url": "https://example.com/resources/technical-seo-checklist",
    "description": "Review crawlability, indexing, metadata, internal links, structured data, performance, and monitoring with a practical technical SEO checklist."
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/seo/serp-snippet-preview",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "title": "Practical Technical SEO Checklist for Growing Websites",
    "url": "https://example.com/resources/technical-seo-checklist",
    "description": "Review crawlability, indexing, metadata, internal links, structured data, performance, and monitoring with a practical technical SEO checklist."
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/serp-snippet-preview", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"title":"Practical Technical SEO Checklist for Growing Websites","url":"https://example.com/resources/technical-seo-checklist","description":"Review crawlability, indexing, metadata, internal links, structured data, performance, and monitoring with a practical technical SEO checklist."}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"title":"Practical Technical SEO Checklist for Growing Websites","url":"https://example.com/resources/technical-seo-checklist","description":"Review crawlability, indexing, metadata, internal links, structured data, performance, and monitoring with a practical technical SEO checklist."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/serp-snippet-preview", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "title": "Practical Technical SEO Checklist for Growing Websites",
  "url": "https://example.com/resources/technical-seo-checklist",
  "description": "Review crawlability, indexing, metadata, internal links, structured data, performance, and monitoring with a practical technical SEO checklist."
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "seo.serp_snippet_preview",
  "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 الكامل ←