Communes italiennes

Présentation

Comuni ITA est une API Node.js construite avec Fastify qui donne accès aux communes, provinces et régions d’Italie. Les données viennent des archives de l’ISTAT, complétées par Wikidata ; les communes supprimées proviennent de l’archive historique des communes de l’ANPR, publiée par le ministère de l’Intérieur.

Les routes versionnées (/v5/comuni, /v5/province, /v5/regioni, /v5/comuni/cessati) acceptent des filtres (code ISTAT, code cadastral, indicatif téléphonique, CAP, recherche par nom), un tri, le choix des champs, la pagination et un format de sortie. Le README indique une instance publique gratuite, et la possibilité d’héberger l’API soi-même avec Docker ou Node.js. La documentation est aussi publiée sur readme.io, et la spécification OpenAPI dont elle est issue se trouve dans le dépôt.

Points forts

• Endpoints pour les communes, provinces, régions et communes cessées, avec filtres par code ISTAT, code cadastral, préfixe téléphonique, CAP et nom.
• Le endpoint /v5/comuni/cessati permet de retrouver la commune actuelle à partir d’un code cadastral, comme celui qui figure dans un codice fiscale.
• Réponses en JSON (par défaut), XML ou CSV, avec tri, sélection des champs et pagination.
• Routes versionnées (v4 et v5) ; la v5 gère plusieurs CAP par commune.
• Utilisable via l’instance publique du projet ou déployable avec Docker Compose ou Node.js ; la collecte des données est dans un dépôt séparé (Comuni-ITA-updater).

Pour qui

Pour les développeurs qui ont besoin de listes de communes, provinces et régions italiennes (formulaires d’adresse, rapprochement de codes, retrouver une commune supprimée) sans maintenir eux-mêmes ces données.

Installation

Aucune installation n’est nécessaire pour interroger l’instance publique indiquée dans le README. Pour héberger l’API soi-même : Docker Compose (port 8080) ou Node.js avec npm install puis npm start.

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

npm install

npm start

Lire le README sur GitHub

Points d’attention

• Pour les communes supprimées, la source n’indique pas dans quelle commune le territoire a été fusionné : comuneAttuale reste null dans ce cas.
• Certaines communes supprimées n’ont pas de nom de province ni de région (territoires cédés après la guerre), ou pas de code cadastral (cas très anciens).
• Les routes historiques non versionnées répondent avec l’en-tête Deprecation: true ; le README recommande les routes versionnées.

Utilisable par un agent ?

API REST (Fastify), pas un serveur MCP. Aucun SKILL.md, AGENTS.md, CLAUDE.md ni règle Cursor trouvé à la racine. Le README mentionne une spécification OpenAPI dans docs/comuni-ita.yaml.