اكتشاف الوكلاء

تنشر DZBuild ملفات مقروءة آليًا كي يجد وكلاء الذكاء الاصطناعي والمساعدون ومحركات البحث بالذكاء الاصطناعي المنصة، ويتصلوا بمتجر، ويقرأوا كتالوجه دون تخمين. تسرد هذه الصفحة كل عنوان عام. كلها للقراءة فقط، ولا تحتاج إلى حساب، وتحمل X-Robots-Tag: noindex، فلا تنافس أبدًا الصفحات التي يقرأها الناس.

المنصة (dzbuild.com)

العنوان	ما هو
https://dzbuild.com/.well-known/api-catalog	مجموعة روابط RFC 9727: واجهة REST API ووصف OpenAPI الخاص بها وموصّل MCP وتوثيقهما
https://dzbuild.com/.well-known/mcp/server-card.json	بطاقة خادم MCP لموصّل متجر DZBuild
https://dzbuild.com/.well-known/ai-catalog.json	كتالوج موارد الوكلاء مع أسئلة نموذجية، ويُقدَّم أيضًا على /.well-known/ard.json
https://dzbuild.com/.well-known/agent-skills/index.json	فهرس ثلاث مهارات يمكن للوكيل تحميلها: الاتصال عبر MCP، ونداء REST API، والتسوق في متجر
https://dzbuild.com/.well-known/oauth-protected-resource	بيانات OAuth للمورد المحمي الخاصة بالـ API المقدَّم على dzbuild.com
https://dzbuild.com/auth.md	كيف يحصل الوكيل على بيانات الدخول. لا يوجد تسجيل مجهول؛ التاجر يوافق على كل اتصال
https://dzbuild.com/openapi.json	وصف OpenAPI 3.1 لواجهة REST API
https://dzbuild.com/llms.txt	خريطة نصية للمنصة موجّهة إلى النماذج اللغوية

كل صفحة تسويقية تُجيب بترويسة Link تشير إلى كتالوج الـ API وملف OpenAPI وفهرس المهارات، وتُرجع Markdown عندما يحمل الطلب Accept: text/markdown. ويعلن robots.txt السطر Content-Signal: search=yes, ai-input=yes, ai-train=yes ويذكر كتالوج الذكاء الاصطناعي تحت Agentmap:.

موصّل MCP (mcp.dzbuild.com)

العنوان	ما هو
https://mcp.dzbuild.com/mcp	نقطة الموصّل (Streamable HTTP، وOAuth 2.1 مع PKCE). أضفها كموصّل مخصص في Claude، أو في ChatGPT عبر وضع المطوّر
https://mcp.dzbuild.com/mcp/server-card	بطاقة الخادم، عامة
https://mcp.dzbuild.com/.well-known/oauth-authorization-server	بيانات خادم التفويض
https://mcp.dzbuild.com/.well-known/oauth-protected-resource/mcp	بيانات المورد المحمي لنقطة الموصّل
https://mcp.dzbuild.com/.well-known/api-catalog و/llms.txt و/robots.txt و/sitemap.xml	ملفات الاكتشاف الخاصة بالمضيف

يسجّل التاجر دخوله ويختار المتاجر في صفحة الموافقة. لا يعمل شيء قبل هذه الموافقة، ويستطيع التاجر إلغاء الاتصال من لوحة التحكم في أي وقت. الأدوات موصوفة في DZBuild Copilot.

واجهة REST API (api.dzbuild.app)

العناوين https://api.dzbuild.app/.well-known/api-catalog و/llms.txt و/robots.txt و/sitemap.xml عامة. ويُحوِّل https://api.dzbuild.app/openapi.json إلى ملف OpenAPI على dzbuild.com. النداء بلا مفتاح صالح يُجاب بـ 401 مع ترويسة WWW-Authenticate: Bearer. تأتي بيانات الدخول من لوحة تحكم التاجر (الإعدادات ← واجهة API)، انظر المصادقة.

كل متجر

ينشر كل متجر، على عنوانه *.dzbuild.app أو على نطاق التاجر الخاص، الملفات نفسها:

العنوان	ما هو
/robots.txt	قواعد المتجر الخاصة، مع سطر Content-Signal وخريطة موقعه
/sitemap.xml	منتجات هذا المتجر وفئاته وصفحاته
/llms.txt	المتجر نصًّا: نبذة، والفئات، وحتى 50 منتجًا بالسعر والمخزون، وكيف يتم الشراء
/.well-known/api-catalog	مجموعة روابط تشير إلى تغذية الكتالوج وخريطة الموقع وllms.txt
/feed/facebook.xml	الكتالوج كاملًا بصيغة RSS 2.0 مع السعر والتوفّر
/.well-known/ucp	ملف Universal Commerce Protocol بثلاث قدرات: البحث في الكتالوج، والاستعلام في الكتالوج، والرابط الدائم
POST /ucp/v1/catalog/search	جسم JSON {"query": "...", "pagination": {"limit": 20}}؛ يُجيب بالمنتجات مع السعر بأصغر وحدة من الدينار والتوفّر
POST /ucp/v1/catalog/lookup	جسم JSON {"ids": ["177185"]} بحدّ 20 معرّف منتج
GET /buy/{id}:{qty}	يُجيب بـ 303 إلى صفحة المنتج؛ ويُمرَّر المعرّف العربي بـ ~ متبوعة بصيغته base64url

تُجيب الصفحة الرئيسية بترويسة Link إلى هذه الملفات، وتحمل كل صفحة منتج بيانات schema.org من نوع Product وOffer بحالة المخزون الحقيقية، والمتاجر المقدَّمة عبر Cloudflare تُرجع Markdown عند طلبها بـ Accept: text/markdown.

المتجر الذي انتهت باقته أو بلغ سقف طلباته لا ينشر شيئًا: تُجيب هذه الملفات بـ 404، مثل خريطة موقعه.

قواعد الوكلاء

• يتم الشراء في نموذج الطلب الخاص بالمتجر. أغلب المتاجر تبيع بالدفع عند الاستلام: يملأ المشتري الاسم والهاتف والولاية والبلدية، ويؤكّد المتجر بالهاتف. يعرض الوكيل رابط المنتج والسعر ويتوقف هناك: لا يملأ النموذج ولا يرسله، ولا ينادي نقاط الطلبات.
• احترم ترويسات Cache-Control: ملفات المتجر قابلة للتخزين 30 دقيقة، وإجابات كتالوج UCP دقيقة واحدة. كل مضيف متجر محدود المعدل؛ الدفعة التي تتجاوز الحد تُجاب بـ 429 مع Retry-After.
• لا توجد واجهة تسجيل ولا بيانات دخول دون نقرة من التاجر. الوكيل الذي يحتاج إلى متجر يطلب من التاجر إنشاءه على dzbuild.com وربطه عبر موصّل MCP.

بوابة المطوّرين (dzbuild.dev)

تقدّم https://dzbuild.dev/llms.txt و/.well-known/api-catalog و/.well-known/mcp/server-card.json و/kit/docs-index.json وحزم /agents/ توثيق المطوّرين إلى الوكلاء؛ ولكل صفحة نسخة .md وتُجيب بـ Markdown عند Accept: text/markdown.