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

إنشاء وسوم meta بلغة HTML من العنوان والوصف

يحوّل مولد وسوم meta بلغة HTML عنوان الصفحة ووصفها المخصص لنتائج البحث وقائمة الكلمات المفتاحية الاختيارية إلى شيفرة مرتبة داخل رأس المستند.

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

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

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

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

اكتب عنوانًا محددًا ووصفًا مفيدًا

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

أضف الكلمات المفتاحية عند حاجة سير العمل إليها فقط

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

ضع الكتلة المنشأة وتحقق من الصفحة

تقدم الاستجابة الشيفرة الكاملة في حقل html، وتعيد العناصر نفسها في مصفوفة tags لأدوات البناء التي تفضل التعامل مع أسطر منفردة. ضع الكتلة داخل رأس المستند، واحرص على وجود عنصر title واحد ووسم meta واحد للوصف في كل صفحة. في التطبيق الذي يرسم الصفحات على الخادم، تضاف عادة إلى بيانات المسار الوصفية أو مكوّن الرأس المشترك، بينما يستطيع مولد المواقع الثابتة إدراجها في أثناء بناء الصفحة. تؤمّن النتيجة علامة العطف والأقواس الزاوية وعلامات الاقتباس والفاصلة العليا، فلا يستطيع النص المرسل الخروج من سياق HTML. لا تزور الأداة الصفحة المقصودة، ولا تكتب نصًا تسويقيًا، ولا تقيس العرض المرئي بالبكسل، ولا تضيف وسوم المشاركة مثل Open Graph وTwitter Card. بعد النشر، افحص مصدر الصفحة المرسل فعليًا بدل الاكتفاء بالمحرر المرئي، وتأكد من أن القالب أو الإضافة لم ينشئا وسومًا منافسة، ثم اختبر الرابط النهائي بأدوات مشرفي المواقع التابعة لمحرك البحث المعني. قد تعيد خدمات البحث صياغة المقتطف المعروض، لذلك تمثل الشيفرة الصحيحة توجيهًا واضحًا لا ضمانًا لشكل مطابق تمامًا.

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

جهز صفحة هبوط لمنتج

حوّل النص المعتمد للمنتج إلى شيفرة مؤمّنة ومفحوصة الطول قبل الإصدار.

تحقق من البيانات الوصفية التحريرية

ارفض العناوين أو الأوصاف التي تتجاوز قواعد النشر المعتمدة في سير العمل.

أتمت بناء الصفحات الثابتة

أنشئ عناصر رأس حتمية وأسطرًا منظمة انطلاقًا من بيانات كل صفحة.

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

ماذا يحدث إذا تجاوز العنوان 60 حرفًا؟

يفشل الطلب بخطأ إدخال ولا تُنشأ أي وسوم meta.

ماذا يحدث إذا تجاوز الوصف 160 حرفًا؟

يفشل الطلب بخطأ إدخال يحدد أن الوصف تجاوز الحد المسموح.

هل الكلمات المفتاحية مطلوبة؟

لا. عند حذف القائمة أو إرسالها فارغة، لا يظهر وسم meta الخاص بالكلمات المفتاحية.

هل يؤمّن المولد محارف HTML؟

نعم. تؤمّن النصوص التي قد تؤثر في بنية HTML داخل العناصر والسمات على السواء.

هل ينشئ وسوم Open Graph أو Twitter Card؟

لا. ينشئ العنوان والوصف والكلمات المفتاحية الاختيارية المحددة لهذه الإمكانية.

ما تكلفة API؟

تكلفة API هي $0.002 لكل طلب. نسخة المتصفح متاحة مجانًا في هذه الصفحة.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/web/meta-tags-generate

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

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

curl -X POST https://api.kit.forhosting.com/web/meta-tags-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Fresh Coffee Delivered to Your Door","description":"Discover freshly roasted coffee delivered on your schedule, with flexible plans and beans selected for every brewing style."}'

const res = await fetch("https://api.kit.forhosting.com/web/meta-tags-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "title": "Fresh Coffee Delivered to Your Door",
    "description": "Discover freshly roasted coffee delivered on your schedule, with flexible plans and beans selected for every brewing style."
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/meta-tags-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "title": "Fresh Coffee Delivered to Your Door",
    "description": "Discover freshly roasted coffee delivered on your schedule, with flexible plans and beans selected for every brewing style."
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/meta-tags-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"title":"Fresh Coffee Delivered to Your Door","description":"Discover freshly roasted coffee delivered on your schedule, with flexible plans and beans selected for every brewing style."}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"title":"Fresh Coffee Delivered to Your Door","description":"Discover freshly roasted coffee delivered on your schedule, with flexible plans and beans selected for every brewing style."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/meta-tags-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "title": "Fresh Coffee Delivered to Your Door",
  "description": "Discover freshly roasted coffee delivered on your schedule, with flexible plans and beans selected for every brewing style."
}

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

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