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)
URL | Ce que c'est |
| Linkset RFC 9727 : l'API REST, sa description OpenAPI, le connecteur MCP et leur documentation |
| Carte de serveur MCP du connecteur de boutique DZBuild |
| Catalogue des ressources pour agents avec des questions types, aussi servi sous |
| Index de trois compétences qu'un agent peut charger : se connecter par MCP, appeler l'API REST, acheter sur une boutique |
| Métadonnées OAuth de ressource protégée de l'API servie sur dzbuild.com |
| Comment un agent obtient des identifiants. Pas d'inscription anonyme : un marchand approuve chaque connexion |
| Description OpenAPI 3.1 de l'API REST |
| 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)
URL | Ce que c'est |
| 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 |
| Carte de serveur, publique |
| Métadonnées du serveur d'autorisation |
| Métadonnées de ressource protégée du point d'entrée |
| 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.
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.
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 |
| Les règles propres à la boutique, avec la ligne Content-Signal et son propre sitemap |
| Produits, catégories et pages de cette boutique |
| La boutique en texte brut : présentation, catégories, jusqu'à 50 produits avec prix et stock, comment acheter |
| Linkset pointant vers le flux catalogue, le sitemap et llms.txt |
| Le catalogue complet en RSS 2.0 avec prix et disponibilité |
| Profil Universal Commerce Protocol avec trois capacités : recherche catalogue, consultation catalogue et permalien |
| Corps JSON |
| Corps JSON |
| Répond 303 vers la page produit ; un identifiant arabe voyage sous la forme |
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
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épond429avecRetry-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 et de la connecter par le connecteur MCP.
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.