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)

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)

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.

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
/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

• 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 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.