Dati elettorali siciliani da riga di comando — senza copiare tabelle HTML.
Il sito ufficiale della Regione Siciliana pubblica i risultati delle elezioni comunali solo in HTML e PDF. Questa CLI estrae affluenza, voti, candidati e risultati in JSON strutturato, con archivio dal 2009 e confronto storico tra anni.
Learn more at Elezioni Sicilia.
Created by @aborruso (aborruso).
Quick Start
# Tabella affluenza regionale aggiornata
elezioni-sicilia-pp-cli affluenza --json
# Comuni alle elezioni in provincia di Palermo
elezioni-sicilia-pp-cli comuni --provincia PA --json
# Voti per candidato sindaco ad Agrigento
elezioni-sicilia-pp-cli candidati Agrigento --json
# Confronto affluenza dal 2009 al 2026
elezioni-sicilia-pp-cli storico Agrigento --json
# Elezioni regionali (ARS) — Presidente 2022 con liste collegate
elezioni-sicilia-pp-cli regionali presidente --anno 2022 --json
Unique Features
These capabilities aren't available in any other tool for this API.
Analisi temporale
-
storico — Confronta affluenza, voti e candidati di uno stesso comune in tutti gli anni disponibili (2009-2026).
Permette analisi di trend elettorali pluridecennali su un singolo comune siciliano senza accesso a database.
elezioni-sicilia-pp-cli storico Agrigento --json
Analisi territoriale
-
riepilogo — Mostra affluenza e stato scrutini per tutte le 9 province siciliane in un unico output strutturato.
Snapshot immediato del quadro regionale durante la notte elettorale.
elezioni-sicilia-pp-cli riepilogo --json
Monitoraggio live
-
watch — Polling periodico dello stato scrutini per tutti i comuni, con alert su avanzamento.
Permette di monitorare l'avanzamento degli scrutini in tempo reale senza aggiornare manualmente il browser.
elezioni-sicilia-pp-cli watch --intervallo 5m --json
Usage
Run elezioni-sicilia-pp-cli --help for the full command reference and flag list.
Commands
affluenza
Dati sull'affluenza alle urne per tutti i comuni siciliani in più rilevamenti orari.
elezioni-sicilia-pp-cli affluenza tabella - Tabella regionale completa dell'affluenza con tutti i rilevamenti orari e confronto con elezioni precedenti.
candidati
Voti per candidato sindaco per comune.
elezioni-sicilia-pp-cli candidati get - Voti per ogni candidato sindaco in un comune specifico.
comuni
Elenco dei comuni che partecipano alle elezioni per una data provincia e anno.
elezioni-sicilia-pp-cli comuni list - Lista comuni con dropdown per navigazione, con codici interni del sito.
liste
Voti per lista elettorale collegata a ogni candidato sindaco.
elezioni-sicilia-pp-cli liste get - Voti per lista collegata a ciascun candidato sindaco in un comune.
risultati
Risultati finali delle elezioni per comune (disponibile a scrutinio completato).
elezioni-sicilia-pp-cli risultati get - Risultato finale del comune: sindaco eletto, sezioni, votanti, seggi per lista.
seggi
Ripartizione dei seggi consiliari per lista.
elezioni-sicilia-pp-cli seggi get - Ripartizione seggi in Consiglio Comunale per ogni lista.
regionali
Dati delle elezioni regionali siciliane (Assemblea Regionale Siciliana — ARS). Anni supportati: 2017 e 2022.
elezioni-sicilia-pp-cli regionali presidente [--anno 2022] - Voti per ciascun candidato Presidente della Regione, con lista regionale e liste provinciali collegate (voti, %, seggi).
elezioni-sicilia-pp-cli regionali affluenza [--anno 2022] - Affluenza per ogni provincia con 3 rilevamenti orari (12:00, 19:00, 22-23:00) e confronto con la tornata precedente.
elezioni-sicilia-pp-cli regionali seggi [--anno 2022] - Riparto seggi per lista provinciale: matrice 9 colonne provincia + totale regionale.
elezioni-sicilia-pp-cli regionali listino [--anno 2022] - Candidati del listino regionale per ciascuna lista (il capolista è il candidato Presidente).
elezioni-sicilia-pp-cli regionali candidati --provincia CT [--anno 2022] - Voti di preferenza dei candidati ARS in una provincia, raggruppati per lista provinciale.
# Voti dei candidati Presidente alle regionali 2022
elezioni-sicilia-pp-cli regionali presidente --anno 2022 --json
# Affluenza regionale 2017 con confronto
elezioni-sicilia-pp-cli regionali affluenza --anno 2017
# Voti preferenza ARS a Catania nel 2022
elezioni-sicilia-pp-cli regionali candidati --provincia CT --anno 2022 --json
Output Formats
# Human-readable table (default in terminal, JSON when piped)
elezioni-sicilia-pp-cli candidati Agrigento --provincia AG
# JSON for scripting and agents
elezioni-sicilia-pp-cli candidati Agrigento --provincia AG --json
# Filter to specific fields
elezioni-sicilia-pp-cli candidati Agrigento --provincia AG --json --select id,name,status
# Dry run — show the request without sending
elezioni-sicilia-pp-cli candidati Agrigento --provincia AG --dry-run
# Agent mode — JSON + compact + no prompts in one flag
elezioni-sicilia-pp-cli candidati Agrigento --provincia AG --agent
Agent Usage
This CLI is designed for AI agent consumption:
- Non-interactive - never prompts, every input is a flag
- Pipeable -
--json output to stdout, errors to stderr
- Filterable -
--select id,name returns only fields you need
- Previewable -
--dry-run shows the request without sending
- Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
- Offline-friendly - sync/search commands can use the local SQLite store when available
- Agent-safe by default - no colors or formatting unless
--human-friendly is set
Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.
Health Check
elezioni-sicilia-pp-cli doctor
Verifies configuration and connectivity to the API.
Configuration
Config file: ~/.config/elezioni-sicilia-pp-cli/config.toml
Static request headers can be configured under headers; per-command header overrides take precedence.
Troubleshooting
Not found errors (exit code 3)
- Check the resource ID is correct
- Run the
list command to see available items
API-specific
- Errore TLS certificate — Il sito usa TLS self-signed — il CLI usa Surf automaticamente, non serve azione
- Dati non disponibili per il comune — Gli scrutini potrebbero essere ancora in corso — usa 'stato ' per verificare
- Regionali non accessibili — Il server della Regione Siciliana non espone i dati regionali via URL diretti
HTTP Transport
This CLI uses standard HTTP transport with HTTP/2 disabled for browser-facing endpoints. It does not require a resident browser process for normal API calls.
Sources & Inspiration
This CLI was built by studying these projects and resources:
Generated by CLI Printing Press