Kranli

New Swiss building permit applications by municipality and trade, each linked to its official publication. Read-only.

Смотреть на kranli.ch

Документация

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/demandes les 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/metiers les dix familles de métiers
  • /api/v1/cantons les cantons couverts et leurs sources
  • /api/v1/openapi.json la 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? »

Ce qui est servi

  • la commune et le canton
  • la date de dépôt ou de publication
  • le type de procédure et le statut
  • la description officielle, telle que publiée
  • la fin du délai d’opposition
  • les métiers concernés (classement de Kranli)
  • le lien vers la publication officielle, la source et la formule

Ce qui reste réservé aux abonnés

  • l’alerte du matin, les jours où il y a du nouveau
  • ce que disent les registres publics du bâtiment
  • le suivi du statut de chaque dossier
  • la fiche privée de chaque chantier

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

Pour aller plus loin

Kranli sur abonnement: les matins où il y a du nouveau, les demandes de ton métier autour de ta commune, avec ce qu’en disent les registres publics du bâtiment, le suivi du statut et une fiche privée pour chaque chantier; 19 CHF par mois ou 190 CHF par an, 7 jours d’essai.

Découvrir l’abonnement