Per sviluppatori

API pubblica.

Accesso in lettura ai dati pubblici francesi che importiamo: regioni, dipartimenti, comuni e particelle catastali, con le statistiche e gli arricchimenti mostrati sul sito. REST, JSON, una chiave in un header. Gratuita per uso non commerciale. E un server MCP per gli assistenti IA.

11 endpoint Server MCP 39 fonti pubbliche Licence Ouverte 2.0 (Etalab) openapi.json

Ottenere una chiave

Crea un account.

La chiave si ottiene online, in due minuti, senza doverci scrivere:

Registrati con email e password, oppure con Google.
Apri il link di conferma ricevuto via email.
Nel tuo account, clicca su «Crea una chiave»: viene mostrata una sola volta, copiala.

Crea un account Ho già un account

Il piano gratuito è incluso; i piani a pagamento si attivano dall’account, senza vincoli.

Piano	Prezzo	Al giorno	Al minuto	Uso
Gratuito	Gratuito	100 richieste	10 richieste	Non commerciale
Standard	19 € + IVA / mese	2000 richieste	60 richieste	Uso commerciale consentito
Pro	79 € + IVA / mese	25.000 richieste	300 richieste	Uso commerciale consentito

I limiti valgono per account, sommando tutte le chiavi. Una chiave identifica un’integrazione, non un visitatore: non includerla in un front-end pubblico. Ogni risposta restituisce X-Plan, X-Quota-Used e X-Quota-Remaining. Per esigenze fuori da questo schema (enti pubblici, ricerca, volumi maggiori) scrivici: contact@lagrandecarte.fr.

curl -H "X-API-Key: LA_TUA_CHIAVE" \
  "https://lagrandecarte.fr/api/v1/communes/18033?include=stats"

Assistenti IA

Server MCP.

Gli stessi dati, direttamente in Claude, ChatGPT, Cursor o qualsiasi client compatibile MCP: l’assistente geocodifica l’indirizzo, trova la particella e legge rischi, urbanistica o compravendite senza che tu tocchi l’API. Ogni strumento chiama l’endpoint REST corrispondente: stesso account, stessi limiti, una chiamata a uno strumento vale una richiesta.

https://lagrandecarte.fr/mcp

Guida alla connessione passo per passo: lagrandecarte.fr/it/mcp.

Dall’interfaccia

Aggiungi nel tuo assistente un connettore personalizzato con questo indirizzo. Verrai reindirizzato su La Grande Carte: accedi (o crea un account), autorizza l’accesso e una chiave «MCP · …» viene creata automaticamente nel tuo account. Revocarla disconnette l’assistente.

Con una chiave

Per i client che accettano un header, genera una chiave dal tuo account. Claude Code:

claude mcp add --transport http lagrandecarte https://lagrandecarte.fr/mcp \
  --header "X-API-Key: LA_TUA_CHIAVE"

Configurazione JSON (Cursor, Claude Desktop, VS Code…):

{
  "mcpServers": {
    "lagrandecarte": {
      "type": "http",
      "url": "https://lagrandecarte.fr/mcp",
      "headers": {
        "X-API-Key": "LA_TUA_CHIAVE"
      }
    }
  }
}

Esempi di domande

«Cosa sai del comune di Bosdarros? E com’è la qualità dell’acqua del rubinetto?»
«Vado a vedere una casa al 4 rue Porte Jaune a Bourges: rischi naturali, zonizzazione del PLU, compravendite recenti nei dintorni?»
«Confronta reddito mediano, affitti e criminalità di Pau e Tarbes.»
«Tasso di povertà e speranza di vita nei Pirenei Atlantici (Pyrénées-Atlantiques), rispetto alla Nuova Aquitania (Nouvelle-Aquitaine)?»

L’assistente invia solo i parametri degli strumenti (un comune, un indirizzo), mai la tua conversazione: vedi l’informativa sulla privacy. Domande o problemi: contact@lagrandecarte.fr.

Strumento	Descrizione
get_commune	Tutto su un comune: popolazione, redditi, affitti, qualità dell’acqua e dell’aria, criminalità, clima, eletti, finanze… (statistiche incluse)
search_address	Trovare un comune, un indirizzo o una località; restituisce il codice INSEE e le coordinate
get_parcel_enrichments	Il rapporto completo su una particella: rischi, urbanistica, compravendite, classe energetica, rumore, reti…
get_parcel_at_point	La particella catastale in un punto
get_parcel	Una particella dal suo riferimento catastale (IDU)
get_departement	Un dipartimento con le sue statistiche, facoltativamente i suoi comuni
get_region	Una regione con le sue statistiche, facoltativamente i suoi dipartimenti
find_commune	Il comune che contiene un punto
list_communes	I comuni di un dipartimento
list_departements	I dipartimenti, facoltativamente di una sola regione
list_regions	Le regioni

Riferimento rapido

Gli endpoint.

Metodo	Percorso	Descrizione
GET	/api/v1	Indice del servizio — l’unica chiamata senza chiave
GET	/api/v1/regions	Le 18 regioni
GET	/api/v1/regions/{code}	Una regione · include=geometry,stats,departements
GET	/api/v1/departements	I 96 dipartimenti metropolitani · ?region=
GET	/api/v1/departements/{code}	Un dipartimento · include=geometry,stats,communes
GET	/api/v1/communes	I comuni di un dipartimento (?departement=) o quello che contiene un punto (?lat=&lon=)
GET	/api/v1/communes/{codeInsee}	Un comune · include=geometry,stats
GET	/api/v1/adresses?q=	Geocodifica di un indirizzo o di un luogo (Base Adresse Nationale)
GET	/api/v1/parcelles?lat=&lon=	La particella catastale in un punto
GET	/api/v1/parcelles/{idu}	Una particella · include=geometry
GET	/api/v1/parcelles/{idu}/enrichments	Tutto ciò che sappiamo della particella

I dipartimenti d’oltremare non sono ancora nella tabella dei confini amministrativi: /departements/974 risponde 404, ma i loro comuni e le loro particelle sono serviti (/communes?departement=974).

I dati sono pubblicati con Licence Ouverte 2.0: riutilizzo libero, anche commerciale, a condizione di citare la fonte. Basta menzionare «La Grande Carte» con un link.

Documentazione interattiva

Prova le chiamate.

La documentazione interattiva è generata dalla specifica OpenAPI ed è in inglese.