# Découverte par les agents DZBuild publie des fichiers lisibles par les machines pour que les agents IA, les assistants et les moteurs de recherche IA trouvent la plateforme, se connectent à une boutique et lisent son catalogue sans deviner. Cette page liste chaque URL publique. Toutes sont en lecture seule, ne demandent aucun compte et portent `X-Robots-Tag: noindex`, elles ne concurrencent donc jamais les pages que lisent les gens. ## La plateforme (dzbuild.com)[​](#la-plateforme-dzbuildcom "Lien direct vers La plateforme (dzbuild.com)") | URL | Ce que c'est | | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | `https://dzbuild.com/.well-known/api-catalog` | Linkset RFC 9727 : l'API REST, sa description OpenAPI, le connecteur MCP et leur documentation | | `https://dzbuild.com/.well-known/mcp/server-card.json` | Carte de serveur MCP du connecteur de boutique DZBuild | | `https://dzbuild.com/.well-known/ai-catalog.json` | Catalogue des ressources pour agents avec des questions types, aussi servi sous `/.well-known/ard.json` | | `https://dzbuild.com/.well-known/agent-skills/index.json` | Index de trois compétences qu'un agent peut charger : se connecter par MCP, appeler l'API REST, acheter sur une boutique | | `https://dzbuild.com/.well-known/oauth-protected-resource` | Métadonnées OAuth de ressource protégée de l'API servie sur dzbuild.com | | `https://dzbuild.com/auth.md` | Comment un agent obtient des identifiants. Pas d'inscription anonyme : un marchand approuve chaque connexion | | `https://dzbuild.com/openapi.json` | Description OpenAPI 3.1 de l'API REST | | `https://dzbuild.com/llms.txt` | Plan en texte brut de la plateforme pour les modèles de langage | Chaque page marketing répond avec un en-tête `Link` qui pointe vers le catalogue d'API, le fichier OpenAPI et l'index des compétences, et renvoie du Markdown quand la requête porte `Accept: text/markdown`. Le `robots.txt` déclare `Content-Signal: search=yes, ai-input=yes, ai-train=yes` et liste le catalogue IA sous `Agentmap:`. ## Le connecteur MCP (mcp.dzbuild.com)[​](#le-connecteur-mcp-mcpdzbuildcom "Lien direct vers Le connecteur MCP (mcp.dzbuild.com)") | URL | Ce que c'est | | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `https://mcp.dzbuild.com/mcp` | Le point d'entrée du connecteur (Streamable HTTP, OAuth 2.1 avec PKCE). Ajoutez-le comme connecteur personnalisé dans Claude, ou dans ChatGPT avec le mode développeur | | `https://mcp.dzbuild.com/mcp/server-card` | Carte de serveur, publique | | `https://mcp.dzbuild.com/.well-known/oauth-authorization-server` | Métadonnées du serveur d'autorisation | | `https://mcp.dzbuild.com/.well-known/oauth-protected-resource/mcp` | Métadonnées de ressource protégée du point d'entrée | | `https://mcp.dzbuild.com/.well-known/api-catalog`, `/llms.txt`, `/robots.txt`, `/sitemap.xml` | Fichiers de découverte de l'hôte | Le marchand se connecte et choisit les boutiques sur la page de consentement. Rien ne fonctionne avant cette approbation, et le marchand peut révoquer la connexion depuis le tableau de bord à tout moment. Les outils sont décrits dans [DZBuild Copilot](https://dzbuild.com/fr/fr/docs/copilot/overview.md). ## L'API REST (api.dzbuild.app)[​](#lapi-rest-apidzbuildapp "Lien direct vers L'API REST (api.dzbuild.app)") `https://api.dzbuild.app/.well-known/api-catalog`, `/llms.txt`, `/robots.txt` et `/sitemap.xml` sont publics. `https://api.dzbuild.app/openapi.json` redirige vers le fichier OpenAPI sur dzbuild.com. Un appel sans clé valide répond `401` avec un en-tête `WWW-Authenticate: Bearer`. Les identifiants viennent du tableau de bord du marchand (**Paramètres → API**), voir [Authentification](https://dzbuild.com/fr/fr/api-docs/authentication.md). ## Chaque boutique[​](#chaque-boutique "Lien direct vers Chaque boutique") Chaque boutique, sur son adresse `*.dzbuild.app` ou sur le domaine du marchand, publie les mêmes fichiers : | URL | Ce que c'est | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `/robots.txt` | Les règles propres à la boutique, avec la ligne Content-Signal et son propre sitemap | | `/sitemap.xml` | Produits, catégories et pages de cette boutique | | `/llms.txt` | La boutique en texte brut : présentation, catégories, jusqu'à 50 produits avec prix et stock, comment acheter | | `/.well-known/api-catalog` | Linkset pointant vers le flux catalogue, le sitemap et llms.txt | | `/feed/facebook.xml` | Le catalogue complet en RSS 2.0 avec prix et disponibilité | | `/.well-known/ucp` | Profil Universal Commerce Protocol avec trois capacités : recherche catalogue, consultation catalogue et permalien | | `POST /ucp/v1/catalog/search` | Corps JSON `{"query": "...", "pagination": {"limit": 20}}` ; répond les produits avec le prix en unités mineures de DZD et la disponibilité | | `POST /ucp/v1/catalog/lookup` | Corps JSON `{"ids": ["177185"]}` avec jusqu'à 20 identifiants de produit | | `GET /buy/{id}:{qty}` | Répond 303 vers la page produit ; un identifiant arabe voyage sous la forme `~` suivi de sa version base64url | La page d'accueil répond avec un en-tête `Link` vers ces fichiers, chaque page produit porte des données schema.org `Product` et `Offer` avec l'état réel du stock, et les boutiques servies par Cloudflare renvoient du Markdown quand on le demande avec `Accept: text/markdown`. Une boutique dont le plan a expiré ou qui a atteint son plafond de commandes ne publie rien : ces fichiers répondent `404`, comme son sitemap. ## Règles pour les agents[​](#règles-pour-les-agents "Lien direct vers Règles pour les agents") * L'achat se fait sur le formulaire de commande de la boutique. La plupart des boutiques vendent en paiement à la livraison : l'acheteur saisit nom, téléphone, wilaya et commune, et la boutique confirme par téléphone. Un agent présente le lien du produit et le prix et s'arrête là : il ne remplit ni n'envoie le formulaire, et n'appelle pas les endpoints de commande. * Respectez les en-têtes `Cache-Control` : les fichiers de boutique peuvent être mis en cache 30 minutes, les réponses du catalogue UCP une minute. Chaque hôte de boutique est limité en débit ; une rafale au-dessus de la limite répond `429` avec `Retry-After`. * Il n'y a pas d'API d'inscription ni d'identifiant sans un clic du marchand. Un agent qui a besoin d'une boutique demande au marchand d'en créer une sur [dzbuild.com](https://dzbuild.com) et de la connecter par le connecteur MCP. ## Le portail développeurs (dzbuild.dev)[​](#le-portail-développeurs-dzbuilddev "Lien direct vers Le portail développeurs (dzbuild.dev)") `https://dzbuild.dev/llms.txt`, `/.well-known/api-catalog`, `/.well-known/mcp/server-card.json`, `/kit/docs-index.json` et les packs `/agents/` servent la documentation développeurs aux agents ; chaque page a un jumeau `.md` et répond en Markdown à `Accept: text/markdown`.