← Tutte le skill
Attivo ottobre 2026

Calendario Raccolta Rifiuti → Alexa

Un sistema che trasforma i calendari PDF della raccolta differenziata in promemoria vocali su Alexa — "cosa butto domani?" e un avviso ogni sera prima della raccolta.

Invocazione: “Alexa, apri calendario rifiuti”

PythonAlexaAWS LambdaNode.jsCloudflare WorkersPDF

Il problema

Ricordarsi ogni sera quale bidone portare fuori è un classico. I calendari del gestore (SERIT) sono PDF: comodi da guardare, inutili da interrogare a voce. Volevo poter chiedere ad Alexa “cosa butto domani?” e, meglio ancora, ricevere un promemoria automatico la sera prima.

Architettura a tre strati

  1. Ingestione (offline) — scarica i PDF SERIT e li converte in JSON strutturato e validato. È l’unico strato legato al layout del PDF.
  2. Dati normalizzati — un file per comune/zona/anno più un catalog.json indice. Aggiungere un comune significa aggiungere file, senza toccare la skill.
  3. Skill Alexa (Node / AWS Lambda) — risponde a voce e programma i promemoria serali.

Il parser PDF (la parte più interessante)

I PDF SERIT hanno una particolarità insidiosa: i numeri dei giorni sono grafica vettoriale, non testo. Il parser ricostruisce quindi la data dalla sequenza dei giorni della settimana (che invece sono testo) più mese e anno, e la valida confrontandola con il giorno-settimana atteso. Se qualcosa non torna, il programma esce con un codice d’errore: è il segnale che il layout del PDF è cambiato e il parser va rivisto. Sui file di prova: zero incongruenze.

La skill Alexa

Il vincolo che ha ribaltato il progetto

La prima architettura creava i promemoria fuori sessione: una catena EventBridge → Lambda → Messaging API doveva svegliare la skill ogni sera e programmare l’avviso. Non funziona. Alexa vieta di creare promemoria fuori da una sessione con l’utente e risponde NOT_IN_SESSION, anche quando la skill è invocata tramite il canale di messaggistica. Un assunto sbagliato, smentito dai log.

La soluzione è un promemoria “a orizzonte”: quando apri la skill (o dici “attiva i promemoria”), la skill programma in un colpo solo tutte le raccolte delle successive ~6 settimane, ognuna come avviso vocale la sera prima. A ogni apertura fa un top-up e riempie le settimane mancanti. Il compromesso è dichiarato: è automatico per circa sei settimane, poi basta riaprire la skill per rinnovare l’orizzonte.

Da un comune a 52

Nata per il mio comune soltanto, l’ho estesa a 52 comuni e 79 calendari SERIT: il parser ora costruisce un intero catalogo invece di un singolo file, in modo incrementale — controlla se i PDF sono cambiati prima di riscaricarli, e se uno di loro non si riesce più a leggere tiene l’ultima versione buona invece di lasciare il comune senza dati. Il modello di interazione della skill (i nomi di comuni e zone che Alexa riconosce a voce) è generato automaticamente dal catalogo, non scritto a mano.

Aggiungere i comuni cambia anche una piccola regola pratica: non tutti espongono i bidoni la sera prima. Alcuni indicano il giorno stesso, di mattina o di pomeriggio — quindi l’orario del promemoria non è più fisso alle 20:00, ma calcolato in base a come e quando quel comune specifico richiede l’esposizione.

La stessa architettura di un’altra mia skill

Per tenere il catalogo aggiornato senza un server sempre acceso, ho riusato l’impostazione della mia skill Almanacco del Giorno: un Worker Cloudflare programmato controlla se l’indice SERIT è cambiato (bastano poche richieste, il piano gratuito ne basta e avanza) e, solo in quel caso, avvia una GitHub Action che ricostruisce davvero il catalogo e lo pubblica. La skill legge i dati dal Worker, con una copia locale di riserva se qualcosa non risponde. Un piccolo allarme su Telegram avvisa quando l’elenco dei calendari cambia.

Stato

Tutte le fasi core sono completate, promemoria verificati end-to-end (compaiono davvero nell’app Alexa) e la skill multi-comune è distribuita. Il primo aggiornamento automatico reale del catalogo è andato a buon fine: il Worker ha girato a orario, l’avviso su Telegram è arrivato e il controllo di stato ha riportato data dell’ultimo controllo e impronta dell’indice. Il ciclo Worker → GitHub Action → archivio → skill è chiuso.

Ora la skill è anche pubblicata sullo Store di Alexa, con descrizione multi-comune e con la privacy policy e i termini d’uso di questa sezione. Il progetto è concluso: da qui in avanti resta la manutenzione, per esempio adattare il parser se SERIT cambiasse il formato dei PDF.

Stack

Python (parser) · Node.js / Alexa ASK SDK · AWS Lambda · DynamoDB · Alexa Reminders API · Cloudflare Workers · GitHub Actions