Opensituas Demo
Caso d'uso sul Comune di Messina

opensituas interroga il SITUAS (ISTAT) — l'anagrafe ufficiale di tutti i comuni, province e regioni italiani dall'Unità d'Italia a oggi. Con pochi comandi ottieni codici ufficiali, storia delle variazioni e dati demografici, pronti per Excel, Google Sheets, DataWrapper o Flourish.

$ uv tool install opensituas README Tutorial giornalisti
Usi Claude Code? Installa la skill situas-explorer e interroga il SITUAS in linguaggio naturale.

Storie che puoi raccontare

Il SITUAS è la fonte autoritativa ISTAT per la geografia amministrativa italiana dal 1861 a oggi. Tre situazioni concrete in cui opensituas risolve un problema giornalistico reale.

"Il comune che seguo si è fuso con un altro. Quando? Con chi? Quale legge lo ha deciso?"

Il comando storia ricostruisce ogni variazione con data, descrizione e riferimento normativo (Regio Decreto, legge regionale...). Esiste per tutti i 7.894 comuni italiani.

"Ho dati elettorali per comune ma i codici non combaciano con quelli ISTAT. Come li allineo?"

opensituas fornisce il codice ISTAT (PRO_COM_T) e il codice catastale (COD_CATASTO) — le due chiavi più usate nei dataset PA italiani. Esporta in CSV e unisci in Excel o Google Sheets.

"Quante fusioni di comuni ci sono state nella mia regione nell'ultimo decennio?"

Il report variazioni dal 1991 elenca ogni evento (fusione, scorporo, cambio nome) con tipo e norma di riferimento. Una query ti dà il conteggio per anno e provincia.

1 Trova il report

74 microservizi nel catalogo. Cerca per parola chiave.

opensituas catalog "comuni"
opensituas which "popolazione"
2 Capisci le colonne

Leggi descrizione e schema prima di scaricare.

opensituas info 74
3 Scarica in CSV

Snapshot, serie storica o query su una singola unità. Output diretto in CSV.

opensituas -o csv get 74 --out dati.csv
opensituas storia comune Messina

Esploriamo Messina passo dopo passo

Ogni scheda mostra prima il perché è utile, poi il dato elaborato, poi (collassato) il comando esatto usato per ottenerlo.

Codice ISTAT del Comune cerca-codice · pfun 61
Perché ti serve
Stai incrociando dataset di fonti diverse (ISTAT, Ministero dell'Interno, open data PA)? Il codice ISTAT a 6 caratteri (PRO_COM_T) è la chiave universale. Il report pfun 61 include anche il codice catastale — l'altro identificatore comune nei dati fiscali e elettorali italiani.
083048
Codice alfanumerico ISTAT
Valido dal 17/03/1861 Ancora attivo

Messina ha il codice 083048 — stabile dall'Unità d'Italia. Il codice catastale è F158.

Esempio di output CSV (pfun 61, prime colonne):

PRO_COM_T COMUNE COD_CATASTO DEN_UTS DEN_REG
083048MessinaF158MessinaSicilia
083001AcquedolciA042MessinaSicilia
083002AliA194MessinaSicilia
Il CSV completo contiene tutti i 7.894 comuni con gerarchia territoriale completa.
$ opensituas cerca-codice comune Messina
┌──────────────┬───────────────┬─────────────┬───────────┐
│ Codice Istat │ Denominazione │ Data inizio │ Data fine │
│ 083048 │ Messina │ 17/03/1861 │ │
└──────────────┴───────────────┴─────────────┴───────────┘
$ opensituas -o csv get 61 --out comuni.csv # tutti i comuni: PRO_COM_T, COMUNE, COD_CATASTO, gerarchia
Dimensione e caratteristiche del territorio pfun 73 + pfun 74
Perché ti serve
Messina perde abitanti da 40 anni: da oltre 260.000 negli anni '80 a 217.000 oggi. Con pfun 74 puoi costruire la stessa traiettoria per ogni comune italiano e trovare i casi più eclatanti di spopolamento o crescita — pronti per un grafico in DataWrapper.
Popolazione residente
217.033
Stima 2024
Popolazione legale
221.246
Censimento 2021
Superficie
213 km²
Aggiornamento 2026
Altitudine municipio
12 m
s.l.m.
città della Sicilia
dopo Palermo (~630k) e Catania (~300k)
−17%
di popolazione in 40 anni
Dal picco anni '80 a oggi: una storia di spopolamento
Litoraneo Città densa Montagna litoranea Zona costiera
$ opensituas -o csv get 74 --out comuni_dimensione.csv # tutti i comuni → POP_LEG, POP_RES, AREA_KMQ
$ opensituas -o csv get 73 --out comuni_caratteristiche.csv # COM_LIT (litoraneo), ZONA_ALT, DEGURBA_2021
Classificazioni di policy e geografiche pfun 75 · pfun 408 · pfun 444 · pfun 76
Perché ti serve
Aree interne: la classificazione A→F misura la distanza dai servizi essenziali. Con pfun 75 trovi tutti i comuni italiani classificati F (oltre 67 minuti da un ospedale) — la mappa del divario territoriale italiano.
Sistema Locale del Lavoro: identifica la vocazione economica reale del territorio, indipendentemente dai confini comunali. Utile per confrontare aree economicamente simili.
Aree interne 2020
A — Polo di attrazione

Messina eroga servizi essenziali per tutta la provincia: ospedali, scuole superiori, stazione ferroviaria.

La scala:
A-Polo B-Polo intercom. C-Cintura D-Intermedio E-Periferico F-Ultra (>67 min)
Sistema Locale del Lavoro
SLL 1920 — Messina

Messina è il capoluogo del proprio SLL (bacino di pendolarismo del Censimento 2021).

Specializzazione produttiva
Sistemi locali portuali
e dei cantieri navali
Lo Stretto, il porto traghetti, i cantieri storici: l'economia reale emerge da questo dato.
Codice NUTS3 europeo
ITG13 — Messina

Stabile dal 2006 al 2024. Serve per confrontare Messina con altre province europee su dati EUROSTAT (PIL pro capite, disoccupazione, ecc.).

ITG13 stabile 2006–2024
$ opensituas -o csv get 75 --out aree_interne.csv # tutti i comuni con classificazione A→F
$ opensituas -o json get 75 | jq '[.[] | select(.AREE_INT_2020 == "F-Ultraperiferico")] | length'
$ opensituas -o csv get 408 --out sll.csv # comuni → SLL di appartenenza
$ opensituas -o csv get 444 --out sll_specializzazione.csv # SLL con specializzazione produttiva
Storia delle variazioni territoriali storia --dettaglio
Perché ti serve
Stai scrivendo di un comune nato da fusione? Il comando storia --dettaglio ti dà il testo della legge, le date esatte e i comuni coinvolti — fonte primaria citabile. Il riferimento normativo (R.D., L.R., D.P.R.) ti permette di risalire al provvedimento originale. Funziona per tutti i 7.894 comuni italiani, dal 1861 a oggi.

Messina ha subito 5 variazioni territoriali documentate in 165 anni. L'ultima risale al 1986: da allora i confini comunali non sono cambiati.

17 marzo 1861
PV Prima validità nel sistema
Prima registrazione — data dell'Unità d'Italia.
12 febbraio 1866
AQ Acquisizione territorio da Calvaruso
Aggregata la frazione Nunzio Bicchieri, staccata da Calvaruso (cod. 083802).
R.D. N. 2743 del 30/12/1865 · G.U. N. 28 del 28/01/1866
17 aprile 1928
AQES Incorporazione di Santo Stefano di Briga
Soppresso il Comune di Santo Stefano di Briga (cod. 083807), territorio aggregato a Messina.
R.D. N. 546 dell'11/03/1928 · G.U. N. 78 del 02/04/1928
2 giugno 1929
CECS Cessione per costituzione di Villafranca Tirrena
Le frazioni Divieto e Serro staccate da Messina per formare il nuovo Comune di Villafranca Tirrena (cod. 083105).
R.D. N. 727 del 28/03/1929 · G.U. N. 116 del 18/05/1929
9 marzo 1986
CE Cessione contrada Divieto a Scaletta Zanclea
Ultima variazione di confine: la contrada Divieto aggregata a Scaletta Zanclea (cod. 083094).
L.R. N. 5 del 18/02/1986 · G.U.R. N. 9 del 22/02/1986
$ opensituas storia comune Messina --dettaglio
# Restituisce: tipo variazione, data, descrizione,
# provvedimento (tipo, estremi, G.U.) e comuni coinvolti
$ opensituas -o csv get 129 --out variazioni_1991.csv # tutte le variazioni italiane dal 1991 con testo del provvedimento

I comuni italiani dal 1948 a oggi

Dal picco di 8.100 comuni nel 1991–2001, oltre 200 unità sono scomparse per fusione — soprattutto dal 2010 in poi, quando le politiche di spending review hanno incentivato le unioni. Prima del 1971, invece, i comuni aumentavano: nuovi centri abitati venivano riconosciuti formalmente.

Nota: la variazione è di circa ±2,5% su 8.000 comuni. L'asse parte da 7.400 per rendere visibile il trend.

Picco storico (1991–2001)
8.100
Comuni oggi (2026)
7.894
Riduzione post-2001
−206
Accelerazione post-2010 (spending review)
opensituas -o json count 61
  --date 01/01/1991

Cosa puoi chiedere a opensituas

La colonna Con la Skill AI mostra come porre la domanda in linguaggio naturale a Claude Code con la skill situas-explorer.

Domanda di esempio Comando base Con la Skill AI
Qual è il codice ISTAT del mio comune? E il codice catastale? opensituas cerca-codice comune "Messina"
CSV completo → opensituas -o csv get 61 --out comuni.csv
"Trova il codice ISTAT e catastale di Messina"
Il mio comune si è fuso con un altro? Quando e con quale legge? opensituas storia comune "Messina" --dettaglio "Raccontami la storia del comune di Messina"
Quanti abitanti ha? La popolazione sta crescendo o calando? opensituas -o csv get 74 --out pop.csv "Popolazione e superficie di Messina"
È un polo di servizi o un'area periferica? Quanto dista dai servizi essenziali? opensituas -o csv get 75 --out aree_interne.csv "Messina è un'area interna o un polo?"
Qual è la vocazione economica del territorio? (turismo, porto, manifattura...) opensituas -o csv get 444 --out sll.csv "Qual è la specializzazione del SLL di Messina?"
Quante fusioni di comuni ci sono state nella mia regione negli ultimi 10 anni? opensituas -o csv get 129 --out variazioni.csv
Filtra per provincia → … | jq '[.[] | select(.ANNO >= "2015" and .COD_UTS == "083")]'
"Fusioni di comuni in Sicilia dal 2015"
Quali comuni della mia provincia hanno cambiato denominazione? opensituas -o csv get 104 --from 17/03/1861 --to 02/06/2026 --out cambi_nome.csv "Comuni della provincia di Messina che hanno cambiato nome"
Quanti comuni aveva l'Italia in un anno preciso? opensituas count 61 --date 01/01/2001 "Quanti comuni aveva l'Italia nel 2001?"
Ho dati del 2001 e del 2021: i codici ISTAT sono cambiati? opensituas -o csv get 99 --from 21/10/2001 --to 31/12/2021 --out mapping.csv "Mappami i codici comuni cambiati tra 2001 e 2021"
Installazione

Richiede Python 3.10+ e un terminale.

$
uv tool install opensituas
# oppure:
pip install opensituas
PyPI Tutorial completo
Skill per agenti AI

Installa la skill per Claude Code e interroga il SITUAS in linguaggio naturale, senza ricordare i numeri dei report.

$
npx skills add ondata/opensituas
Documentazione Skill
Copiato negli appunti!