Pour un agent qui lit ce site,
voici par où commencer.

Le manifeste à /ai/manifest.json est le point d'entrée recommandé. Il liste les endpoints, leurs formats, la licence des données, la version du schéma, et les coordonnées de l'éditeur. Un seul appel — vous savez tout ce qu'il y a à savoir avant de parser quoi que ce soit.

1. Un fichier JSON à la racine. /ai/manifest.json — schema_version, name, description, publisher, endpoints typés, formats, verticales, licence, date de mise à jour. Lisible en un seul appel HTTP.
2. Une seule source de vérité. Tout endpoint cité ailleurs (HTML, llms.txt, JSON-LD) y est listé. Si un agent veut ne lire qu'un fichier pour comprendre la surface, c'est celui-là.
3. Versionné, pas de breaking change silencieux. Aujourd'hui schema_version: v1. Toute évolution incompatible incrémente la version et conserve l'ancien manifeste pendant la transition.

Tous les endpoints sont publics, servis depuis l'edge Cloudflare avec Access-Control-Allow-Origin: * et X-Robots-Tag: all. Cache CDN : 24 h en général, 7 jours sur les .jsonld.

1. Index synthétique du site. /llms.txt — Markdown hashé selon la convention llmstxt.org. Recense les communes publiées, les articles, les points d'entrée. Sert de carte du site pour un agent qui démarre.
2. Index links-only. /llms-full.txt — variante plate, ~20 Ko, sans expansion inline. Adaptée à un crawler qui veut récupérer la liste exhaustive des URLs sans télécharger le contenu.
3. Catalogue centralisé. /atlas/index.json — JSON aplati cross-département. Permet de filtrer / agréger sur plusieurs communes en un appel — utile pour un agent qui répond à une question régionale.
4. Contrat OpenAPI 3.1. /ai/openapi.yaml — description machine-lisible des endpoints au format OpenAPI. Consommée par les Custom GPT Actions et l'OpenAI Apps SDK pour câbler le service comme outil dans un agent — sans rien coder côté client.
5. Fiches typées Schema.org. /communes/{insee}-{slug}/schema/*.jsonld — JSON-LD par commune : destination.jsonld (fiche TouristDestination), knowledge-graph.jsonld (graphe de connaissances). Cross-origin, cache 7 jours.
6. Base SQLite interrogeable. /communes/{insee}-{slug}/data.sqlite — une base par commune, téléchargeable. Permet à un agent qui sait écrire du SQL de filtrer sur n'importe quelle dimension sans parser le JSON-LD.

Trois conventions ouvertes, toutes documentées publiquement. Aucune surcouche propriétaire. Un agent qui sait lire https://schema.org et la convention llmstxt.org sait lire ce site.

1. Schema.org pour le typage. @context: https://schema.org. Types employés : Organization, WebSite, WebAPI, DataCatalog, Dataset, Place, TouristDestination, LocalBusiness, FAQPage.
2. JSON-LD pour la sérialisation graphe. Chaque page expose un @graph. Identifiants @id stables — utilisables comme clés de déduplication entre pages.
3. llms.txt pour l'index Markdown. Convention llmstxt.org — Markdown hashé, liens vers les ressources structurées détaillées. Servi avec Content-Type: text/markdown; charset=utf-8.
4. Provenance pour la traçabilité. Chaque entité référence ses sources (DATATourisme, INSEE, IGN, SIRENE, Google Places, crawl OT) et un synced_at ISO 8601. Pas d'affirmation orpheline.

Tout est interrogeable en curl. Pas de clé d'API, pas de token, pas de rate-limit applicatif — l'edge Cloudflare absorbe la charge.

# manifeste service
$ curl -sL https://web-mcp.fr/ai/manifest.json | jq .

# index global du site
$ curl -sL https://web-mcp.fr/llms.txt

# fiche commune typée Schema.org
$ curl -sL https://web-mcp.fr/communes/06016-beuil/schema/destination.jsonld | jq .

# graphe de connaissances commune
$ curl -sL https://web-mcp.fr/communes/06016-beuil/schema/knowledge-graph.jsonld | jq .

# liste exhaustive des communes publiées
$ curl -sL https://web-mcp.fr/atlas/index.json | jq '.communes[].insee'

# instructions verbeuses Markdown
$ curl -sL https://web-mcp.fr/llms-instructions.md

Le service est lecture seule aujourd'hui. Périmètre publié, sources documentées, jalons à venir explicites — pas de promesse sans badge.

1. 163 communes des Alpes-Maritimes. Premier département publié en intégralité. Couverture par INSEE + slug dans /communes/{insee}-{slug}/. Liste exhaustive dans /atlas/index.json.
2. 8 sources croisées. DATATourisme + INSEE + IGN + SIRENE + data.gouv.fr + INAO + ARS + Google Places. Chaque entité publiée porte sa provenance — l'agent peut filtrer par source de confiance.
3. Extension par département en cours. Calendrier sur la feuille de route publique. Pas de promesse opaque — seuls les jalons engagés y figurent. à venir
4. Couche dynamique en préparation. WebMCP statique T3 2026, exécution agent + OAuth 2.1 T4 2026. Aujourd'hui, le service est lecture seule — pas de mutation, pas d'authentification, pas de rate-limit applicatif. T3 2026