Almanacco del Giorno
Una skill Alexa che ogni giorno racconta santo e onomastici, alba e tramonto, fase lunare, un fatto storico e una barzelletta — tutto precalcolato, senza chiamate a servizi esterni in tempo reale.
Invocazione: “Alexa, apri almanacco del giorno”
L’idea
Un piccolo sommario quotidiano da ascoltare al mattino: chi festeggia l’onomastico oggi, a che ora sorge e tramonta il sole, che fase ha la luna, cosa è successo in questo giorno nella storia, e una barzelletta per iniziare bene. Il canale naturale è il Notiziario flash (Flash Briefing) di Alexa — quello che si sente dicendo “Alexa, buongiorno” — affiancato da una skill “on demand” per chiederlo a voce quando si vuole.
Cloudflare-first, contenuto precalcolato
Niente server sempre acceso: un Worker schedulato gira ogni notte, compone l’almanacco del giorno e lo scrive in un piccolo database chiave-valore. Un secondo Worker si limita a servire quel contenuto già pronto quando Alexa (o chiunque altro) lo richiede. Il vincolo che guida tutto è che la Flash Briefing API di Amazon non ha contesto utente: è un file statico, uguale per tutti, che Alexa ripesca ogni ~15 minuti — quindi deve essere sempre “corretto per oggi”, con la data ricalcolata nel fuso dell’Italia.
Il costo previsto è zero euro: tutto rientra comodamente nel piano gratuito di Cloudflare Workers.
I vincoli nascosti della Flash Briefing API
Il formato che Alexa accetta ha regole precise, scoperte leggendo la documentazione (e
verificandole): il testo è solo testo semplice, niente SSML, HTML o markup — quindi
la “prosodia” di lettura si ottiene solo con la punteggiatura, scrivendo date e numeri
come si leggerebbero a voce (“nel 1940”, non “1940”). Il testo totale non può superare
4.500 caratteri, e gli elementi più vecchi di 7 giorni vengono ignorati: l’uid
e la data dell’elemento vanno quindi rigenerati ogni giorno, non basta scrivere il
contenuto una volta.
Alba, tramonto e luna: calcolati in locale
Sole e luna non vengono presi da un servizio esterno: sono calcolati localmente, con un’equazione solare semplificata e un algoritmo lunare troncato, per una posizione fissa configurabile. Portare questi calcoli a un livello di precisione affidabile ha richiesto un piccolo lavoro di validazione: un bug sul Julian Day (va passato come numero intero riferito a mezzogiorno, non a mezzanotte) scambiava alba e tramonto di mezza giornata, e calcolare la durata del giorno sottraendo gli orari locali invece che quelli UTC sbagliava di un’ora nei giorni di cambio ora legale. Confrontando il risultato con una libreria astronomica di riferimento su un anno intero: errore medio di circa un minuto su alba e tramonto, entro un punto percentuale sulla fase lunare.
Curare 366 giorni di dati, non solo generarli
Santi, onomastici e fatti storici partono da un dataset pubblico (Wikipedia in italiano), ma generare i file non basta: serve un controllo riga per riga. Uno spot-check manuale su tutte le 366 giornate ha trovato sei bug reali che un test automatico non avrebbe intercettato — per esempio “San Marino” (lo Stato) scambiato per un santo per il prefisso “San”, parole collettive come “Apostoli” o “Maccabei” scambiate per nomi propri, e festività dell’antica Roma che condividono una parola con quelle cristiane moderne (“Natale di Minerva” confuso con il Natale). Le barzellette, invece, arrivano da un dataset curato a mano — niente testo generato al volo — con rotazione deterministica per non ripetersi.
Dal codice alla skill vera
Testare in locale non basta: creando davvero la skill custom, la console aveva
provisionato per errore un runtime Python invece del Node.js previsto —
scoperto e corretto ricreandola da zero prima di pubblicare codice. Una volta online,
altri due dettagli sono emersi solo con la skill reale: il runtime non aveva fetch
disponibile di default, e Alexa a volte restituisce il nome pronunciato tutto in
minuscolo (“vincenzo” invece di “Vincenzo”), quindi va ricapitalizzato prima di
usarlo nella risposta.
Osservabilità
Un controllo automatico segnala su Telegram se la composizione notturna fallisce o produce un risultato degradato, con una deduplica per non mandare lo stesso allarme due volte nello stesso giorno. Verificato end-to-end: bot creato, connessione provata con un messaggio reale, e un build forzato “pulito” per confermare che l’allarme non scatta quando tutto va bene.
Il primo vero incidente in produzione
Il giorno dopo il deploy dell’osservabilità è arrivato il primo allarme Telegram reale: “Almanacco di oggi degradato — Wikipedia non disponibile”. Non un test, un guasto vero, seppur transitorio (l’endpoint è tornato su da solo pochi minuti dopo). La risposta è stata aggiungere un secondo tentativo automatico 15 minuti dopo la composizione principale: se il giorno è già a posto non fa nulla, altrimenti ricostruisce da capo e, se nel frattempo Wikipedia è tornata disponibile, aggiorna il contenuto senza generare un secondo allarme ridondante.
Distribuire quel secondo tentativo ha fatto scoprire un limite non ovvio del piano
gratuito di Cloudflare: 5 cron trigger per account in totale, non per singolo Worker.
Registrare 4 orari separati per questo solo Worker ha fatto fallire il deploy a metà (il
codice era caricato, i trigger no). La soluzione è una sola voce cron con una sintassi
a liste (10,25 1,4 * * *, quattro orari in un’unica riga) invece di quattro voci
distinte — con l’effetto collaterale che il gestore non può più distinguere build
principale e ritentativo dal pattern cron ricevuto, e lo fa invece leggendo l’orario
esatto di innesco.
Le barzellette, versione due
Il primo dataset di 132 barzellette, scritte da me, ha ricevuto un giudizio netto: “pessime, non fanno ridere”. Sostituite con 141 battute della tradizione orale italiana — Pierino, colmi, indovinelli, scenette dal dottore o dal cameriere — raccontate con parole mie ma approvate una per una, in più tornate, secondo un gusto preciso: battute classiche a botta e risposta sì, nulla che scherzi su sordi o anziani fragili. Cambiare gli identificativi ha evitato collisioni con lo storico già scritto nel database: con 141 voci invece di 132, una simulazione su quattro anni conferma che nessuna barzelletta si ripete prima di 141 giorni.
Stato
Tutte le fasi previste (dataset, feed live, skill on-demand, osservabilità con autoripristino) sono completate, distribuite e verificate, con un primo incidente reale già superato senza intervento manuale. Entrambe le skill — Flash Briefing e custom — sono state sottomesse alla certificazione di Amazon il 2026-09-27 e il 6 ottobre 2026 sono state pubblicate sullo Store di Alexa, con distribuzione limitata all’Italia. Il progetto è concluso: il contenuto del feed e dell’API cambia senza bisogno di ricertificare, perché lo serve il Worker, mentre una modifica al codice della skill vocale richiederebbe una nuova certificazione. La Fase 3 (audio MP3, pagina web dedicata) resta facoltativa e non pianificata. La stessa API che alimenta la skill fa girare anche il piccolo widget “Almanacco del giorno” in home page di questo sito, ora perfettamente funzionante dopo aver aperto l’API in lettura al browser (CORS).
Stack
TypeScript (Cloudflare Workers, KV) · Python (generazione e validazione dataset) · Alexa Flash Briefing API · Alexa Skills Kit