italian-parliament-cli
GitHub通过CLI查询意大利议会开放数据，支持议员、法案、投票等分析。适用于Shell管道处理、CSV/JSONL导出及脚本化数据分析。
触发场景
安装
npx skills add NeverSight/learn-skills.dev --skill italian-parliament-cli -g -y
SKILL.md
Frontmatter
{
"name": "italian-parliament-cli",
"metadata": {
"author": "aborruso",
"version": "1.4"
},
"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)"
}
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
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(nonelettorale),disabilità/portatori di handicap,sostegno(nonfuorisede/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 --keywordnon 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
--limitto cap results during exploration - URIs from
listcommands can be passed toshowcommands - Senato confidence votes have empty
ddl_uri:senato-votes list --ddl-uri <uri>won't return a fiducia — the bill link is only in thelabeltext. Filter by seduta date (--date-from/--date-to), then match the DDL vialabel. Also checkddl_urion any "final" vote found by date: it may belong to a different act (unified text).
版本历史
- c3c0a1e 当前 2026-07-23 09:11
