Comuni italiani

Presentazione

Comuni ITA è un’API Node.js costruita con Fastify che dà accesso a comuni, province e regioni d’Italia. I dati provengono dagli archivi ISTAT, integrati con Wikidata; i comuni cessati arrivano dall’archivio storico dei comuni dell’ANPR, pubblicato dal Ministero dell’Interno.

Gli endpoint versionati (/v5/comuni, /v5/province, /v5/regioni, /v5/comuni/cessati) accettano filtri (codice ISTAT, codice catastale, prefisso telefonico, CAP, ricerca per nome), ordinamento, scelta dei campi, paginazione e formato di risposta. Il README indica un’istanza pubblica gratuita e la possibilità di ospitare l’API in proprio con Docker o Node.js. La documentazione è pubblicata anche su readme.io e la specifica OpenAPI da cui deriva si trova nel repository.

Punti di forza

• Endpoint per comuni, province, regioni e comuni cessati, con filtri per codice ISTAT, codice catastale, prefisso telefonico, CAP e nome.
• L’endpoint /v5/comuni/cessati permette di risalire al comune attuale partendo da un codice catastale, come quello presente in un codice fiscale.
• Risposte in JSON (predefinito), XML o CSV, con ordinamento, selezione dei campi e paginazione.
• Rotte versionate (v4 e v5); la v5 gestisce più CAP per comune.
• Utilizzabile tramite l’istanza pubblica del progetto o distribuibile con Docker Compose o Node.js; la raccolta dei dati è in un repository separato (Comuni-ITA-updater).

Per chi

Per gli sviluppatori che hanno bisogno di elenchi di comuni, province e regioni italiane (moduli di indirizzo, riconciliazione di codici, ricerca di un comune cessato) senza mantenere in proprio questi dati.

Installazione

Non serve alcuna installazione per interrogare l’istanza pubblica indicata nel README. Per ospitare l’API in proprio: Docker Compose (porta 8080) oppure Node.js con npm install e poi npm start.

git clone https://github.com/Samurai016/Comuni-ITA

npm install

npm start

Leggete il README su GitHub

Punti di attenzione

• Per i comuni soppressi la fonte non dice in quale comune sia confluito il territorio: in quel caso comuneAttuale resta null.
• Alcuni comuni cessati non hanno nome di provincia né regione (territori ceduti dopo la guerra) oppure non hanno codice catastale (casi molto antichi).
• Le rotte storiche non versionate rispondono con l’header Deprecation: true; il README indica le rotte versionate come riferimento.

Utilizzabile da un agente?

API REST (Fastify), non un server MCP. Nessun SKILL.md, AGENTS.md, CLAUDE.md né regola Cursor trovato alla radice. Il README cita una specifica OpenAPI in docs/comuni-ita.yaml.