italian-parliament-cli

name	italian-parliament-cli
description	Query Italian Parliament open data from the command line (italianparliament CLI). Use when the user wants to run shell pipelines, export CSV/JSONL, or script analysis over deputies, senators, bills, votes, speeches, and groups.
compatibility	Requires the @aborruso/italianparliament-mcp npm package installed globally (provides the `italianparliament` command)
metadata	{"author":"aborruso","version":"1.4"}

Italian Parliament CLI Skill

Use the italianparliament CLI to query Camera dei Deputati and Senato della Repubblica open data from the shell.

Installation

npm install -g @aborruso/italianparliament-mcp
# provides the `italianparliament` command

Discovery (orchestration)

italianparliament guide                  # typical workflow (discover → URI → detail)
italianparliament which "testo ddl"      # capability → command (exit 0 match, 2 no-match); add --json for ranked output
italianparliament <command> --help       # options + examples

General syntax

italianparliament <resource> <action> [--option value ...]

Default output: CSV (for spreadsheets, duckdb, mlr). Add --format jsonl for jq/streaming.

Default legislature

Current legislature is 19. Most commands default to 19 when --legislature is omitted.

Command reference

See full command reference.

Common patterns

Count deputies in a legislature

italianparliament deputies list --legislature 19 --format csv | wc -l

Export all bills as CSV

italianparliament bills list --legislature 19 --format csv > bills-19.csv

Find an MP by name

italianparliament search find --name meloni

Top 20 MPs by interrogations (AIC)

italianparliament rank list --rank-by aic-primo-firmatario --legislature 19 --limit 20

Who voted against in a vote

italianparliament vote-detail show --vote-uri <vote-uri> --format jsonl | \
  jq 'select(.vote=="Contrario")'

Dissidenti, e altri obiettivi giornalistici derivabili senza tool dedicato Vedi obiettivi giornalistici: ricette pronte (es. i "ribelli" che votano contro la linea di gruppo) combinando i tool esistenti.

A person's full career (legislatures + government)

italianparliament person-career show --uri http://dati.camera.it/ocd/deputato.rdf/d302103_19

Government members filtered by name

italianparliament gov-members list --name draghi

Group ranking by AIC, also per member

italianparliament group-rank list --rank-by aic --legislature 19   # colonna count_per_member già calcolata

Iter completo di una legge (Camera → Senato → pubblicazione) Non generare la timeline a memoria: costruiscila dai tool, passo per passo. bill-progress è la spina dorsale.

# 1. individua l'atto Camera
italianparliament bills list --keyword "salario giusto" --legislature 19        # → URI atto, es. ac19_2911
# 2. iter Camera con le date reali di ogni fase (assegnazione, esame, approvazione/trasmissione, legge)
italianparliament bill-progress list --uri http://dati.camera.it/ocd/attocamera.rdf/ac19_2911
# 3. aggancia il DDL Senato per NUMERO, mai per keyword (evita di pescare un DDL omonimo diverso)
italianparliament bill-progress list --number 1933 --branch S --legislature 19  # → ddl_uri, es. dati.senato.it/ddl/60201
# 4. voti Senato sul DDL corretto (+ caveat fiducia più sotto)
italianparliament senato-votes list --ddl-uri http://dati.senato.it/ddl/60201
# 5. contenuto: il testo NON è nei metadati; se non lo scarichi, non descrivere il contenuto
italianparliament bill-text links --uri http://dati.camera.it/ocd/attocamera.rdf/ac19_2911
italianparliament bill-text fetch --did 60201 --out testo.md

Nota voti Camera: se --keyword/numero non trova il voto finale o la fiducia, filtra per intervallo di date attorno alla data di trasmissione (votes list --date-from … --date-to …) e leggi il dettaglio con vote-detail, invece di dedurre o inventare il conteggio.

Ricerca testuale (--keyword)

--keyword (su bills, aic, committee-sessions, ecc.) è un match letterale sul titolo formale dell'atto, non una ricerca semantica: cerca la stringa così com'è nel testo ufficiale. Il lessico giornalistico spesso non coincide con quello normativo, quindi un risultato vuoto è quasi sempre un mismatch di parole, non un dato assente.

Regole d'oro:

• Usa il termine normativo, non quello giornalistico. Es. elezione (non elettorale), disabilità/portatori di handicap, sostegno (non fuorisede/fuori sede). In dubbio, prova entrambi.
• Prova più sinonimi e radici di parola prima di concludere. Preferisci la radice breve che copre più forme: elett → elettorale/elettori/elezione; ambient → ambiente/ambientale. Se il tool matcha a confini di parola (es. aic --keyword), usa più keyword separate.
• Vuoto ≠ assente. Se non trovi nulla, riformula con un sinonimo o una radice prima di dire all'utente che il dato non c'è. Solo dopo 2-3 varianti fallite l'assenza è credibile.
• Sindacato ispettivo (Senato) non è ricercabile per argomento: sindacato-ispettivo --keyword non filtra sull'oggetto perché il LOD Senato non espone l'oggetto/testo dell'atto (solo tipo, numero, data, firmatari). Il testo vive solo nella pagina HTML esterna. Non promettere ricerche tematiche su questo tool.

Grounding (non inventare)

Quando ricostruisci iter, voti o schede, il rischio è la confabulazione su scheletro reale: partire da un dato giusto e riempire i buchi con valori plausibili ma falsi (voti, date, firmatari, contenuti). Regole:

• Riporta solo ciò che un comando ha restituito. Se un voto, un firmatario, una data o un contenuto non è nell'output, scrivi "non disponibile" — non completare con numeri o nomi verosimili.
• Aggancia gli atti per identificatore, non per keyword. Il DDL Senato di un atto Camera va risolto per numero (bill-progress --number … --branch S), così non si confondono atti omonimi.
• Distingui "Dato" (da tool) da "Sintesi/interpretazione" (tua). Le deduzioni (es. data di entrata in vigore calcolata, sigle di gruppo espanse) vanno dichiarate come tali.
• Cita per riga: l'URL della votazione/atto/scheda accanto al dato, non un'unica fonte cumulativa in fondo.

Tips

• Pipe CSV into duckdb -c "SELECT ... FROM read_csv_auto('/dev/stdin')" for SQL analysis
• Use --limit to cap results during exploration
• URIs from list commands can be passed to show commands
• Senato confidence votes have empty ddl_uri at the source, but senato-votes list --ddl-uri <uri> now returns the fiducia anyway (it resolves the DDL's seduta dates and re-links the confidence vote of that day). Still check ddl_uri on any "final" vote found by date: it may belong to a different act (unified text). --ddl-uri derives the legislature from the DDL, so a historical DDL (e.g. leg.18 http://dati.senato.it/ddl/52988) works without passing --legislature.
• Senato — quando c'è il voto individuale: senato-vote-detail dà il sì/no del singolo senatore solo per i voti di merito (type = elettronica, nominale con appello, controprova). Per segreta (voto segreto) e verifica numero legale (conteggio del quorum) restituisce solo le presenze (Presente non votante, In congedo/missione), mai una scelta espressa (né Favorevole, né Contrario, né Astenuto): la scelta non è nel dato. Non dedurre il voto individuale su queste due modalità.
• Question time Camera per sede: le interrogazioni a risposta immediata hanno la sede nel label in modo regolare, e aic --type matcha anche sul label. Quindi la sede è già filtrabile senza campo dedicato: aic list --type "immediata in assemblea" = question time in Aula, aic list --type "immediata in commissione" = in commissione (combinabile con --keyword <tema>).