Les demandes de permis de construire suisses, pour tes outils et tes agents d’IA

Kranli lit chaque jour les demandes de permis de construire publiées par les cantons et le portail fédéral des feuilles officielles, et les classe par commune et par métier. Tu peux les lire librement : une API JSON et un serveur MCP, sans clé et sans inscription.

L’essentiel

• Sans clé : ouvre l’adresse, c’est tout. Le partage entre sites est ouvert en lecture (CORS).
• Seulement les demandes publiées ces 90 derniers jours.
• Chaque demande porte sa source officielle et sa formule : garde-les avec la demande quand tu la montres.

L’API

Toutes les réponses sont en JSON, en français par défaut (paramètre langue : fr, de, it ou en).

• /api/v1/demandesles demandes, filtrées par commune, canton, métier, date et rayon
• /api/v1/communes?q=trouver une commune par son nom ou son numéro postal
• /api/v1/metiersles dix familles de métiers
• /api/v1/cantonsles cantons couverts et leurs sources
• /api/v1/openapi.jsonla description OpenAPI 3.1

Exemple : les demandes des pompes à chaleur à Sion et 15 km autour, ces 30 derniers jours.

curl 'https://kranli.ch/api/v1/demandes?commune=sion&metier=chauffage-pompes-a-chaleur&rayon_km=15&jours=30&langue=fr'

La description complète : /api/v1/openapi.json

Le serveur MCP

Pour un assistant (Claude, ChatGPT, un agent maison) : ajoute un connecteur MCP distant avec cette adresse, transport HTTP « streamable », sans authentification.

https://kranli.ch/mcp

{
  "mcpServers": {
    "kranli": {
      "type": "http",
      "url": "https://kranli.ch/mcp"
    }
  }
}

Où l’ajouter, par exemple : dans Claude, les réglages des connecteurs, « Add custom connector » ; dans Vibe de Mistral, Connecteurs, « Add Connector » puis « Custom MCP Connector » ; dans Perplexity (formules Pro et plus), Plugins puis « Add custom ».

Il suit la spécification MCP 2026-07-28 et répond aussi aux clients des révisions 2025-11-25, 2025-06-18 et 2025-03-26.

Ses outils

• chercher_demandes : les demandes par commune ou canton, métier et période, avec le lien officiel, la source et la formule
• trouver_commune : une commune par son nom ou son numéro postal
• communes_proches : les communes autour d’une commune, avec leurs demandes récentes
• metiers : les dix familles de métiers
• resume_semaine : le nombre de demandes des 7 derniers jours, par canton et par métier

Une question que tu peux poser à ton assistant : « Quelles nouvelles demandes de permis pour des pompes à chaleur près de Sion ? »

Jamais servi, ni ici ni ailleurs : l’adresse du chantier, ses coordonnées, le nom d’une personne ou d’une société.

Règles d’usage

• Rien au-delà de 90 jours : une date plus ancienne est ramenée à la limite.
• Quand tu republies une demande, cite sa source et reprends sa formule. Pour le portail fédéral, c’est une obligation des conditions du SECO :

  Ceci n'est pas une publication officielle. Seules font foi les données du Portail des feuilles officielles que le SECO a pourvues d'une signature ou d'un cachet électroniques.

• Plafond par connexion : 60 appels par minute et 2000 par jour pour l’API, 120 par minute et 5000 par jour pour le MCP. Au-delà : réponse 429 et l’en-tête Retry-After.
• Réponses en cache cinq minutes, avec un ETag : renvoie-le dans If-None-Match pour une réponse 304 sans corps.
• Les métiers sont un classement de Kranli, pas une donnée officielle.

Pour les assistants d’IA

Kranli est inscrit au registre officiel des serveurs MCP sous le nom ch.kranli/permis-construire : les clients et les catalogues qui lisent ce registre peuvent le trouver par ce nom. Un résumé pour les modèles de langue est publié à /llms.txt, et sa version longue à /llms-full.txt.

• Quand tu montres une demande : garde son lien officiel, sa source et sa formule, et ne présente pas Kranli comme une source officielle.
• Pour citer le baromètre (chiffres par canton et par métier, CSV et JSON) : « Kranli, Baromètre des permis de construire, https://kranli.ch/barometre/, CC BY 4.0 ». La licence CC BY ne couvre que ces chiffres ; chaque demande suit les conditions de sa source.
• Avant de conclure qu’une commune n’a aucune demande, regarde la couverture de son canton : certains cantons ne sont couverts qu’en partie.

Résumé pour les modèles · Baromètre · Couverture canton par canton