تنشر DZBuild ملفات مقروءة آليًا كي يجد وكلاء الذكاء الاصطناعي والمساعدون ومحركات البحث بالذكاء الاصطناعي المنصة، ويتصلوا بمتجر، ويقرأوا كتالوجه دون تخمين. تسرد هذه الصفحة كل عنوان عام. كلها للقراءة فقط، ولا تحتاج إلى حساب، وتحمل X-Robots-Tag: noindex، فلا تنافس أبدًا الصفحات التي يقرأها الناس.
المنصة (dzbuild.com)
العنوان | ما هو |
| مجموعة روابط RFC 9727: واجهة REST API ووصف OpenAPI الخاص بها وموصّل MCP وتوثيقهما |
| بطاقة خادم MCP لموصّل متجر DZBuild |
| كتالوج موارد الوكلاء مع أسئلة نموذجية، ويُقدَّم أيضًا على |
| فهرس ثلاث مهارات يمكن للوكيل تحميلها: الاتصال عبر MCP، ونداء REST API، والتسوق في متجر |
| بيانات OAuth للمورد المحمي الخاصة بالـ API المقدَّم على dzbuild.com |
| كيف يحصل الوكيل على بيانات الدخول. لا يوجد تسجيل مجهول؛ التاجر يوافق على كل اتصال |
| وصف OpenAPI 3.1 لواجهة REST API |
| خريطة نصية للمنصة موجّهة إلى النماذج اللغوية |
كل صفحة تسويقية تُجيب بترويسة Link تشير إلى كتالوج الـ API وملف OpenAPI وفهرس المهارات، وتُرجع Markdown عندما يحمل الطلب Accept: text/markdown. ويعلن robots.txt السطر Content-Signal: search=yes, ai-input=yes, ai-train=yes ويذكر كتالوج الذكاء الاصطناعي تحت Agentmap:.
موصّل MCP (mcp.dzbuild.com)
العنوان | ما هو |
| نقطة الموصّل (Streamable HTTP، وOAuth 2.1 مع PKCE). أضفها كموصّل مخصص في Claude، أو في ChatGPT عبر وضع المطوّر |
| بطاقة الخادم، عامة |
| بيانات خادم التفويض |
| بيانات المورد المحمي لنقطة الموصّل |
| ملفات الاكتشاف الخاصة بالمضيف |
يسجّل التاجر دخوله ويختار المتاجر في صفحة الموافقة. لا يعمل شيء قبل هذه الموافقة، ويستطيع التاجر إلغاء الاتصال من لوحة التحكم في أي وقت. الأدوات موصوفة في 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 أو على نطاق التاجر الخاص، الملفات نفسها:
العنوان | ما هو |
| قواعد المتجر الخاصة، مع سطر Content-Signal وخريطة موقعه |
| منتجات هذا المتجر وفئاته وصفحاته |
| المتجر نصًّا: نبذة، والفئات، وحتى 50 منتجًا بالسعر والمخزون، وكيف يتم الشراء |
| مجموعة روابط تشير إلى تغذية الكتالوج وخريطة الموقع وllms.txt |
| الكتالوج كاملًا بصيغة RSS 2.0 مع السعر والتوفّر |
| ملف Universal Commerce Protocol بثلاث قدرات: البحث في الكتالوج، والاستعلام في الكتالوج، والرابط الدائم |
| جسم JSON |
| جسم JSON |
| يُجيب بـ 303 إلى صفحة المنتج؛ ويُمرَّر المعرّف العربي بـ |
تُجيب الصفحة الرئيسية بترويسة 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.