Le domande di costruzione svizzere, per i tuoi strumenti e i tuoi agenti di IA

Kranli legge ogni giorno le domande di costruzione pubblicate dai cantoni e dal portale federale dei fogli ufficiali, e le ordina per comune e per mestiere. Puoi leggerle liberamente: un’API JSON e un server MCP, senza chiave e senza registrazione.

L’essenziale

• Senza chiave: apri l’indirizzo, e basta. L’accesso tra siti è aperto in lettura (CORS).
• Solo le domande pubblicate negli ultimi 90 giorni.
• Ogni domanda porta la sua fonte ufficiale e la sua formula: tienile sempre insieme alla domanda.

L’API

Tutte le risposte sono in JSON, in francese per impostazione predefinita (parametro langue: fr, de, it o en).

• /api/v1/demandesle domande, filtrate per comune, cantone, mestiere, data e raggio
• /api/v1/communes?q=trovare un comune per nome o numero postale
• /api/v1/metiersle dieci famiglie di mestieri
• /api/v1/cantonsi cantoni coperti e le loro fonti
• /api/v1/openapi.jsonla descrizione OpenAPI 3.1

Esempio: le domande per pompe di calore a Sion e 15 km intorno, negli ultimi 30 giorni.

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

La descrizione completa: /api/v1/openapi.json

Il server MCP

Per un assistente (Claude, ChatGPT, un agente tuo): aggiungi un connettore MCP remoto con questo indirizzo, trasporto HTTP «streamable», senza autenticazione.

https://kranli.ch/mcp

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

Dove aggiungerlo, per esempio: in Claude, nelle impostazioni dei connettori, «Add custom connector»; in Vibe di Mistral, Connectors, «Add Connector» e poi «Custom MCP Connector»; in Perplexity (da Pro in su), Plugins e poi «Add custom».

Segue la specifica MCP 2026-07-28 e risponde anche ai client delle revisioni 2025-11-25, 2025-06-18 e 2025-03-26.

I suoi strumenti

• chercher_demandes: le domande per comune o cantone, mestiere e periodo, con il link ufficiale, la fonte e la formula
• trouver_commune: un comune per nome o numero postale
• communes_proches: i comuni intorno a un comune, con le loro domande recenti
• metiers: le dieci famiglie di mestieri
• resume_semaine: il numero di domande degli ultimi 7 giorni, per cantone e per mestiere

Una domanda per il tuo assistente: «Quali nuove domande di costruzione per pompe di calore ci sono vicino a Sion?»

Mai fornito, né qui né altrove: l’indirizzo del cantiere, le sue coordinate, il nome di una persona o di una società.

Regole d’uso

• Nulla oltre 90 giorni: una data più vecchia è portata al limite.
• Quando ripubblichi una domanda, cita la fonte e riprendi la formula. Per il portale federale lo esigono le condizioni della 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.

• Limite per connessione: 60 chiamate al minuto e 2000 al giorno per l’API, 120 al minuto e 5000 al giorno per il MCP. Oltre: risposta 429 con l’intestazione Retry-After.
• Risposte in cache cinque minuti, con un ETag: rimandalo in If-None-Match per una risposta 304 senza contenuto.
• I mestieri sono una classificazione di Kranli, non un dato ufficiale.

Per gli assistenti di IA

Kranli è iscritto al registro ufficiale dei server MCP con il nome ch.kranli/permis-construire: i client e i cataloghi che leggono questo registro possono trovarlo con questo nome. Un riassunto per i modelli linguistici è pubblicato su /llms.txt, la versione lunga su /llms-full.txt.

• Quando mostri una domanda: conserva il link ufficiale, la fonte e la formula, e non presentare Kranli come una fonte ufficiale.
• Per citare il barometro (cifre per cantone e per mestiere, CSV e JSON): «Kranli, Barometro delle domande di costruzione, https://kranli.ch/it/barometre/, CC BY 4.0». La licenza CC BY copre solo queste cifre; ogni domanda segue le condizioni della sua fonte.
• Prima di concludere che un comune non ha domande, guarda la copertura del suo cantone: alcuni cantoni sono coperti solo in parte.

Riassunto per i modelli linguistici · Barometro · Copertura cantone per cantone