ملف llms.txt: المواصفة، والتنفيذ الصحيح، وكيف تتحقق منه
ما هو ملف llms.txt؟
llms.txt ملف Markdown يوضع في جذر الموقع (example.com/llms.txt) ليقدّم لنماذج الذكاء الاصطناعي ملخصًا منظمًا للموقع وروابط أهم صفحاته. اقترحه Jeremy Howard في 3 سبتمبر 2024، وصدر الإصدار الثاني من المواصفة في أغسطس 2026. هو مقترح مفتوح وليس معيارًا ملزمًا، ولا تشترطه Google للظهور في نتائجها.
لماذا وُجد هذا الملف؟
صفحة الويب العادية مكتوبة لمتصفح: قوائم تنقل، وسكربتات، ونوافذ منبثقة، وتنسيقات. عندما يقرأها نموذج لغوي ضمن نافذة سياق محدودة، يضيع جزء كبير من هذه النافذة على عناصر لا تحمل معنى. فكرة llms.txt أن يقدّم صاحب الموقع بنفسه نسخة مختصرة ومنظمة: من نحن، وما أهم صفحاتنا، وأين يجد النموذج التفاصيل بصيغة نظيفة.
البنية حسب المواصفة
الترتيب الذي تحدده المواصفة:
- عنوان H1 باسم الموقع. هذا هو القسم الإلزامي الوحيد.
- اقتباس (blockquote) يلخص الموقع في جملة أو جملتين.
- أقسام تفصيلية بأي صيغة Markdown عدا العناوين، لمعلومات تساعد على فهم الروابط التالية.
- قوائم روابط تحت عناوين H2، وكل عنصر رابط بصيغة
[الاسم](الرابط)يليه اختياريًا نقطتان ووصف قصير. - قسم اختياري باسم Optional لروابط ثانوية يمكن للنموذج تجاهلها عندما يحتاج سياقًا أقصر.
مثال كامل لموقع شركة ثنائي اللغة
# Example Co.
> Example Co. designs and runs bilingual Arabic and English websites
> for companies in Saudi Arabia, the UAE, Qatar, and Oman.
Prices are starting prices in each country's currency; final scope and
price come in a written proposal.
## Services
- [Company websites](https://example.com/en/company-websites.md): bilingual sites, scope and price
- [Care plan](https://example.com/en/care-plan.md): hosting, backups, updates, protection
- [AI search visibility](https://example.com/en/ai-search.md): what we check and measure
## Arabic
- [مواقع الشركات](https://example.com/company-websites.md): النسخة العربية
## Optional
- [Guides](https://example.com/en/guides.md): long-form articles
لاحظ أن الروابط تشير إلى نسخ Markdown من الصفحات، وهذا ما تقترحه المواصفة في إصدارها الثاني.
نسخ Markdown للصفحات وطريقة اكتشافها
تقترح المواصفة أن يكون لكل صفحة مهمة نسخة Markdown على نفس العنوان مع امتداد .md، مثل page.html.md أو page.md، والعنوان الذي بلا اسم ملف يستخدم index.html.md أو index.md. ولكي تجدها الأدوات تلقائيًا، أعلن عنها بإحدى طريقتين:
<!-- داخل <head> في صفحة HTML -->
<link rel="alternate" type="text/markdown" href="/en/care-plan.md">
<link rel="describedby" href="/llms.txt">
Link: </en/care-plan.md>; rel="alternate"; type="text/markdown"
التنفيذ الصحيح: أربع قواعد
| القاعدة | لماذا |
|---|---|
| ولّد الملف آليًا من نفس مصدر بيانات الموقع | الملف المكتوب يدويًا يتقادم، وتبقى فيه روابط لصفحات حُذفت |
| كل رابط يعيد الحالة 200 مباشرة بلا تحويل | الرابط المحوَّل أو المعطل يعطي النموذج صورة خاطئة عن موقعك |
| استخدم الروابط القانونية نفسها الموجودة في خريطة الموقع | تكرار نفس الصفحة بعناوين مختلفة يربك أي قارئ آلي |
| قدّم الملف بترميز UTF-8 | حتى يظهر النص العربي سليمًا |
في موقع قوام سولوشنز يُولَّد ملف llms.txt أثناء بناء الموقع من نفس بيانات الخدمات والأسعار والأعمال التي تعرضها الصفحات، فلا يمكن أن يختلف عنها.
أوامر التحقق
افحص أن الملف موجود وما نوع المحتوى الذي يعيده الخادم:
curl -sI https://example.com/llms.txt
افحص كل رابط داخل الملف واعرض حالته وعنوانه النهائي:
curl -s https://example.com/llms.txt \
| grep -oE 'https?://[^) ]+' \
| while read -r url; do
curl -s -o /dev/null -w "%{http_code} %{num_redirects} $url\n" -L "$url"
done
أي سطر حالته ليست 200، أو فيه عدد تحويلات أكبر من صفر، يحتاج إصلاحًا.
ولمعرفة من يقرأ الملف فعلًا، ابحث في سجلات الخادم:
grep '"GET /llms.txt' access.log | awk -F'"' '{print $6}' | sort | uniq -c | sort -rn
ما الذي لا يفعله الملف
- لا يحل محل تحسين محركات البحث. تقول Google صراحة إنه لا يلزم أي ملف خاص للظهور في AI Overviews أو AI Mode.
- لا يتحكم في الوصول. التحكم في البوتات مكانه robots.txt، ومنه تسمح لبوت البحث الخاص بـ ChatGPT واسمه OAI-SearchBot.
- لا يضمن الاستشهاد. قرار الاستشهاد بمصدر يعود إلى المحرك نفسه.
الخلاصة الهندسية
عامل llms.txt كطبقة توثيق آلية فوق موقع سليم: ولّده من مصدر البيانات، واربطه بنسخ Markdown للصفحات المهمة، وافحص روابطه في كل نشر، وقِس من يقرؤه من سجلات الخادم. في تقارير منارة نفحص صلاحية روابط الملف تلقائيًا، لأن ملفًا قديمًا بروابط معطلة أسوأ من عدم وجوده.
أسئلة شائعة
ما الحد الأدنى المطلوب في الملف؟
حسب المواصفة، القسم الوحيد الإلزامي هو عنوان H1 باسم الموقع أو المشروع. كل ما بعده اختياري: ملخص في اقتباس، ثم أقسام تفصيلية، ثم قوائم روابط تحت عناوين H2.
هل أحتاج ملف llms-full.txt؟
ملف llms-full.txt ليس جزءًا من المواصفة الرسمية، بل اصطلاح تستخدمه بعض المواقع لوضع المحتوى كاملًا في ملف واحد. المواصفة الحالية تقترح بدلًا منه نسخة Markdown نظيفة لكل صفحة مهمة.
كيف تكتشف الأدوات نسخة Markdown لصفحتي؟
عبر رابط من النوع rel="alternate" type="text/markdown"، إما كعنصر link داخل صفحة HTML أو كترويسة HTTP باسم Link. ويمكن للصفحة أن تشير إلى ملف llms.txt الذي يغطيها عبر rel="describedby".
هل تقرأ Google هذا الملف؟
تقول Google في توثيقها إنك لا تحتاج إلى ملفات نصية خاصة بالذكاء الاصطناعي أو ترميز إضافي للظهور في AI Overviews أو AI Mode. الشرط عندها أن تكون الصفحة مفهرسة وقابلة للظهور في البحث العادي.
كيف أعرف إن كانت أداة ذكاء اصطناعي قرأت الملف؟
من سجلات الخادم: ابحث عن طلبات المسار /llms.txt وانظر إلى قيمة User-Agent لكل طلب. هذا هو الدليل الوحيد المباشر، لأن الأدوات لا تعلن عادة أنها استخدمت الملف.