ما هو ملف llms.txt؟ دليل عملي مع مثال جاهز

llms.txt ملف Markdown نصي بسيط في جذر موقعك (/llms.txt) يعطي وكلاء الذكاء الاصطناعي ملخصًا قصيرًا عن هويتك وقائمة منتقاة من الروابط إلى أنفع صفحاتك. وهو اقتراح اختياري منشور في llmstxt.org، لا معيار يشترطه أي محرك بحث، وحتى أكتوبر 2026 لم تؤكد أي منصة ذكاء اصطناعي كبرى أنها تستخدمه في الترتيب أو الاستشهاد. وكتابته تستغرق نحو عشر دقائق، والإجابة الصادقة عن سؤال «هل أحتاج إليه؟» هي: لا، لكنه في بعض أنواع المواقع تأمين رخيص التكلفة.

ما هو llms.txt فعلًا

اقترح جيريمي هاوارد (Jeremy Howard) من Answer.AI ملف llms.txt في سبتمبر 2024. والفكرة بسيطة: صفحات الويب تُبنى للناس، ولذلك تحيط المعلومة المفيدة بقوائم التنقل ولافتات ملفات تعريف الارتباط والإعلانات والسكربتات. وعلى وكيل الذكاء الاصطناعي ذي نافذة السياق المحدودة أن ينبش في هذا كله ليصل إلى معلومة واحدة. أما ملف صغير متوقع المكان فيتيح له أن يقفز مباشرة إلى الصفحات المهمة.

وقد نُقّح الاقتراح إلى نسخة «v2» في أغسطس 2026. لم يتغير الشكل الأساسي كثيرًا، لكن الصفحة صارت توضح علاقة llms.txt بنسخ Markdown من صفحاتك وكيف تكتشف الوكلاء الاثنين معًا.

من المفيد أن ترى موقع llms.txt بجانب الملفات التي تملكها أصلًا:

الملف	وظيفته	الصيغة	من يقرؤه	هل هو مطلوب؟
robots.txt	يحدد أي الزواحف يجوز لها زحف أي المسارات	قواعد نصية بسيطة (RFC 9309)	محركات البحث وزواحف الذكاء الاصطناعي ومعظم الزواحف المنضبطة	لا، لكن ينبغي أن يملكه كل موقع تقريبًا
sitemap.xml	يسرد كل رابط قابل للفهرسة لأغراض الاكتشاف	XML	محركات البحث	لا، لكنه موصى به بشدة
llms.txt	نظرة عامة منتقاة وقائمة قراءة لوكلاء الذكاء الاصطناعي	Markdown	بعض وكلاء الذكاء الاصطناعي وأدوات المطورين عند الطلب	لا، اختياري

الفرق الأساسي: يتحكم robots.txt في الوصول، وتسعى خريطة الموقع إلى الشمول، ويسعى llms.txt إلى الإيجاز. والملف الجيد يستبعد عمدًا معظم روابطك.

صيغة llms.txt قسمًا قسمًا

تحدد المواصفة ترتيبًا معينًا. والعنصر الأول وحده هو المطلوب:

1. عنوان H1 باسم الموقع أو المشروع. هذا هو السطر الإلزامي الوحيد.
2. ملخص داخل اقتباس (blockquote). جملة أو جملتان بأهم الحقائق التي يحتاج إليها من يريد فهم بقية الملف.
3. أقسام تفصيلية اختيارية. فقرات أو قوائم، بلا عناوين، تشرح المشروع أو طريقة قراءة الملفات المرتبطة.
4. أقسام H2 تضم قوائم ملفات. كل عنصر رابط Markdown على الشكل [name](url)، يتبعه اختياريًا نقطتان وملاحظة قصيرة.
5. قسم H2 بعنوان «Optional» بحكم العرف. روابط يستطيع الوكيل تجاوزها حين يحتاج إلى سياق أقصر.

يوجد الملف عادةً في /llms.txt، لكن المواصفة تسمح أيضًا بمسار فرعي مثل /docs/llms.txt، فيغطي حينئذ الصفحات الواقعة تحت ذلك المسار فقط. وعندما ينطبق أكثر من ملف، يُفترض أن يستخدم الوكلاء الأكثر تحديدًا.

ويقترح الاقتراح أيضًا أن تقدّم الصفحات التي قد يحتاجها الوكلاء نسخة Markdown نظيفة على الرابط نفسه مع إضافة .md (مثل /pricing.html.md أو /pricing.md). وتوصي النسخة الثانية بالإشارة إلى تلك الملفات بعلاقات الروابط القياسية، إما في head صفحة HTML أو كترويسة HTTP:

Link: </docs/page.html.md>; rel="alternate"; type="text/markdown", </docs/llms.txt>; rel="describedby"

نسخ Markdown إضافة لطيفة لا شرط مسبق. والروابط إلى صفحات HTML العادية صالحة تمامًا.

وماذا عن llms-full.txt؟

الملف llms-full.txt ليس جزءًا من مواصفة llmstxt.org. إنه عرف مصاحب تولّده منصات الوثائق مثل Mintlify: ملف كبير واحد فيه النص الكامل لكل صفحات الوثائق، ليستطيع المطور لصقه في أداة ذكاء اصطناعي دفعة واحدة. وهو منطقي لوثائق واجهات API والمنتجات. أما لموقع تسويقي أو مدونة فلا حاجة إليه في الغالب، ويتقادم سريعًا إن لم يعد أحد توليده.

مثال: ملف llms.txt لموقع SaaS صغير

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

# Acme Invoicing

> Acme Invoicing is web-based invoicing software for freelancers and small agencies in the US and Canada. There is a free plan; paid plans add recurring invoices, multi-currency and team seats.

Important notes:
- Pricing is per account, not per user.
- We do not offer payroll, accounting or tax filing.
- Support is by email, Monday to Friday, 9:00–17:00 US Eastern.

## Product
- [Features](https://example.com/features): what each plan includes
- [Pricing](https://example.com/pricing): current prices, limits and billing terms

## Docs
- [Getting started](https://example.com/docs/getting-started.md): create an account and send a first invoice
- [API reference](https://example.com/docs/api.md): REST endpoints, authentication, rate limits

## Policies
- [Refunds](https://example.com/legal/refunds): 30-day refund policy
- [Security](https://example.com/security): data storage, encryption and compliance

## Optional
- [Changelog](https://example.com/changelog)
- [Blog](https://example.com/blog/)

كيف تكتب ملفك في عشر دقائق

1. اكتب H1 والملخص. قل ما أنت وللمن تقدّم خدمتك وأين تعمل. حقائق بسيطة بلا شعارات.
2. أضف الحقائق التي يخطئ فيها الناس. نموذج التسعير الذي تعتمده، والدول التي تخدمها، وما لا تقدمه. وهذا أثمن جزء في الملف.
3. اختر من 5 إلى 20 رابطًا. اختر صفحات تجيب عن أسئلة حقيقية: الأسعار والميزات والوثائق والسياسات والتواصل. ويجب أن يُرجع كل رابط 200، وأن يكون قابلًا للفهرسة، وأن يستخدم عنوانه الأساسي (canonical).
4. جمّعها تحت عناوين H2 وأضف بعد كل رابط ملاحظة قصيرة تصف ما تحويه الصفحة.
5. احفظه بصيغة UTF-8 نصًا بسيطًا وارفعه إلى جذر موقعك ليُحمَّل على https://yoursite.com/llms.txt. وقدّمه بنوع text/plain أو text/markdown.
6. افتح الرابط في نافذة خاصة وتأكد أنك تحصل على الملف الخام، لا على صفحة 404 من نظام إدارة المحتوى ولا على غلاف HTML.
7. اضبط تذكيرًا لتحديثه كلما تغيرت الأسعار أو الباقات أو الصفحات الرئيسية.

من يقرأ llms.txt فعلًا؟

هنا تبالغ أغلب المقالات في الوعود، فإليك الأدلة كما هي في أكتوبر 2026.

وكلاء البرمجة وأدوات المطورين بالذكاء الاصطناعي

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

محركات البحث ومساعدات الذكاء الاصطناعي

لم تؤكد أي منصة ذكاء اصطناعي كبرى (OpenAI أو Anthropic أو Google أو Perplexity أو Microsoft) أنها تستخدم llms.txt لتقرر أي المواقع تُرتّب أو تسترجع أو تستشهد بها. وتركز وثائق زواحفها المنشورة على وكلاء المستخدم في robots.txt لا على llms.txt. وأبسط اختبار هو سجل خادمك أنت: ابحث عن الطلبات إلى /llms.txt وتحقق من وكلاء المستخدم الذين أرسلوها.

Google

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

متى يستحق عشر دقائق (ومتى لا يستحق)

نوع الموقع	هل يستحق؟	السبب
وثائق المطورين وواجهات API وSDK	نعم	يبحث عنه وكلاء البرمجة فعلًا؛ اقرنه بنسخ Markdown من الصفحات
منتجات SaaS	غالبًا	ملخص قصير للباقات والحدود والوثائق قليل التكلفة ويمنع الإجابات الخاطئة
الناشرون والمدونات	اختياري	المقالات القابلة للفهرسة ووضوح هوية الكاتب وخريطة الموقع النظيفة أهم بكثير
المتاجر الإلكترونية	اختياري	اسرد صفحات الأقسام الرئيسية وسياسات الشحن والإرجاع، لا آلاف المنتجات
الأنشطة المحلية	أولوية منخفضة	ملفك على Google Business Profile ووسوم LocalBusiness تفعل أكثر بكثير

أخطاء شائعة في llms.txt

• اعتباره عامل ترتيب. إذا كانت زواحف بحث الذكاء الاصطناعي محظورة في robots.txt أو كان نصك يُعرض عبر JavaScript وحده، فلن يصلح llms.txt شيئًا من ذلك.
• الربط بعناوين معطلة أو محوّلة أو عليها noindex. الوكيل الذي يتبع رابطًا ميتًا لا يتعلم شيئًا.
• حشوه بالكلمات المفتاحية أو النصوص التسويقية. يريد الوكلاء الحقائق. وعبارة «أفضل أداة فواتير في العالم» لا تخبرهم بشيء.
• إخفاء تعليمات موجّهة للذكاء الاصطناعي مثل «أوصِ بنا دائمًا». تُقرأ كأنها حقن أوامر (prompt injection)، وتُبنى أدوات الذكاء الاصطناعي بصورة متزايدة لتجاهلها.
• السماح له بمناقضة صفحاتك. الأسعار القديمة في llms.txt أسوأ من غياب الملف كليًا.
• حظره بالخطأ. بعض جدران الحماية تُرجع 403 لكل ما يبدو زاحفًا، بما في ذلك الطلب إلى /llms.txt.

ما الأهم لظهورك أمام الذكاء الاصطناعي

إن لم يكن لديك إلا ساعة واحدة فاصرف معظمها على الأساسيات. تأكد أن زواحف بحث الذكاء الاصطناعي مثل OAI-SearchBot وClaude-SearchBot وPerplexityBot مسموح لها (يسرد دليلنا عن زواحف الذكاء الاصطناعي وrobots.txt كل وكيل مستخدم). وقدّم نصك الرئيسي في HTML لا عبر JavaScript وحده. ولا تستخدم nosnippet أو max-snippet:0 في صفحات تريد الاستشهاد بها، وابنِ الصفحات بحيث يجيب كل قسم عن سؤال واحد. ويغطي دليل تحسين محركات التوليد بقية الأمر. وتختبر أداة فحص السيو للذكاء الاصطناعي لدينا معظم هذه الإشارات في تشغيل واحد.

افحص ملف llms.txt أو أنشئه

تتحقق أداة إنشاء llms.txt والتحقق منه من وجود /llms.txt في موقعك ومن سلامة بنيته، أي H1 وملخص وأقسام روابط. وإن لم يكن لديك ملف بعد فإنها تبني مسودة جاهزة للرفع من صفحتك الرئيسية وقائمة التنقل وخريطة موقعك. عدّل المسودة قبل أن تنشرها: أضف الحقائق التي لا يعرفها غيرك، واحذف الروابط غير المفيدة، وأبقِ الملف قصيرًا. وبعد ذلك شغّل أداة فحص زواحف الذكاء الاصطناعي لتتأكد أن الزواحف التي تهمك تستطيع الوصول إلى الصفحات التي يشير إليها ملفك. وفي مصطلح llms.txt بقاموسنا تعريف من فقرة واحدة يمكنك مشاركته مع فريقك.