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

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

## المنصة (dzbuild.com)[​](#المنصة-dzbuildcom "رابط مباشر إلى المنصة (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)[​](#موصّل-mcp-mcpdzbuildcom "رابط مباشر إلى موصّل 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](https://dzbuild.com/ar/ar/docs/copilot/overview.md).

## واجهة REST API (api.dzbuild.app)[​](#واجهة-rest-api-apidzbuildapp "رابط مباشر إلى واجهة 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**)، انظر [المصادقة](https://dzbuild.com/ar/ar/api-docs/authentication.md).

## كل متجر[​](#كل-متجر "رابط مباشر إلى كل متجر")

ينشر كل متجر، على عنوانه `*.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](https://dzbuild.com) وربطه عبر موصّل MCP.

## بوابة المطوّرين (dzbuild.dev)[​](#بوابة-المطوّرين-dzbuilddev "رابط مباشر إلى بوابة المطوّرين (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`.