Normattiva Open Data: cos’è e come usarlo con Claude Code o Codex
Normattiva Open Data espone la normativa statale con API pubbliche. Claude Code e Codex possono usarle attraverso una skill che guida ogni passaggio.
Accesso: il servizio non richiede account, chiave API, email, cookie o SPID. L’agente invia le richieste direttamente.
Che cos’è Normattiva Open Data
È il servizio di dati aperti collegato a Normattiva, la banca dati pubblica della normativa statale. Documentazione e specifiche sono su dati.normattiva.it.
Il servizio offre ricerche, esportazioni di singoli atti e collezioni preconfezionate. Ogni esportazione indica la modalità: originale, vigente o multivigente.
Come funziona una esportazione
Lo scaricamento di un atto segue un flusso asincrono in più passaggi:
- una ricerca avanzata individua l’atto con tipo, data e numero;
- l’agente controlla che il risultato sia proprio l’atto richiesto;
- una nuova ricerca asincrona chiede l’esportazione nel formato scelto;
- una conferma avvia la preparazione del file;
- l’agente controlla lo stato fino al file pronto e scarica lo ZIP.
La risposta finale può arrivare come reindirizzamento con l’indirizzo del file. Per questo la skill legge ogni risposta senza seguire i reindirizzamenti in automatico.
Claude Code e Codex
Claude Code e Codex lavorano sul tuo computer e possono inviare richieste HTTP. La skill LeLeggi spiega all’agente il flusso e i controlli da eseguire.
Claude Code legge le skill personali da ~/.claude/skills/. Codex le legge da ~/.agents/skills/.
Python resta facoltativo. Serve per il programma alternativo della skill e per le copie in Markdown, se già installato.
I controlli sui file
- verifica del certificato TLS, sempre attiva;
- controllo di identità dell’atto prima dell’esportazione;
- apertura e verifica di ogni archivio ZIP;
- impronta SHA-256 dei file, quando lo strumento è disponibile;
- manifest con data richiesta, data di acquisizione ed esito.
Uno ZIP vuoto non conta come successo. La skill conserva lo stato e riprende la stessa richiesta.
Come iniziare
La pagina della skill LeLeggi contiene il messaggio da incollare nell’agente. L’agente legge le istruzioni, verifica il file e lo installa dopo la tua conferma.
Gli esempi di richieste sono nell’articolo Come scaricare tutte le leggi italiane con l’IA.
Scarica la skill LeLeggi
LeLeggi è un progetto di IAperAvvocati.it. Il download è libero e non richiede registrazione. La pagina contiene il messaggio da incollare nell’agente e le condizioni d’uso.
Altri articoli su LeLeggi
Vuoi creare skill come questa?
Nel Workshop e nel Master parti da un’esigenza dello studio e scrivi le istruzioni per l’agente.