Laboratorio · da rifare a casa
Il radar delle
opportunità
Come costruirsi, da soli e gratis, un foglio che ogni lunedì mattina va a leggere i portali dei bandi, tiene solo quello che riguarda gli under 35 e prepara una mail di riepilogo. Dieci passi, tre quarti d'ora, nessuna riga di codice da scrivere.
Il foglio
Tutto il progetto vive dentro un solo Foglio Google. Non c'è nessun server, nessun sito da comprare, niente da installare sul computer: se un giorno vuoi buttare via tutto, butti via il foglio e non resta niente in giro.
- Apri questo indirizzo: Google ti mostra un solo pulsante, Crea una copia.
- La copia finisce sul tuo Drive, con dentro le tre linguette e il programma già scritto.
- Rinominala come vuoi, e salta al passo 2: i passi 3 e 4 non ti servono.
La chiave di chi te l'ha data, la sua sveglia, i suoi destinatari. È giusto così: da adesso il radar è tuo, gira sul tuo account e consuma la tua quota, non quella di un altro.
- Vai su sheets.new: nasce un foglio vuoto sul tuo Drive.
- In alto a sinistra, dove c'è scritto Foglio di lavoro senza titolo, clicca e scrivi Radar opportunità.
- Le tre linguette non le crei tu: le farà il programma al passo 4, con i nomi e le intestazioni giuste. È la parte in cui prima sbagliavano tutti.
Hai un Foglio Google aperto, sul tuo Drive, che si chiama Radar opportunità. Se hai fatto la copia, in basso vedi già tre linguette: FONTI, OPPORTUNITÀ, LOG.
La chiave di Gemini
Gemini è il modello che legge le pagine dei bandi e ne tira fuori le opportunità. Per farlo lavorare per te serve una chiave: una lunga sequenza di lettere e numeri che dice «questa richiesta arriva da me». È gratuita entro un certo numero di richieste al giorno — molte più di quante ne farà il radar.
- Vai su aistudio.google.com/apikey e accedi con lo stesso account Google del foglio.
- Premi Create API key (o Crea chiave API).
- Se ti chiede in quale progetto crearla, accetta quello che ti propone: va benissimo.
- Copia la chiave e tienila negli appunti. Fra due minuti la incolli e non ci pensi più.
Le chiavi nuove non somigliano a quelle vecchie: va bene lo stesso. Se invece ti compare una richiesta di carta di credito, sei finito sulla console a pagamento di Google Cloud: torna indietro e usa l'indirizzo qui sopra, che è quello di AI Studio.
Quella chiave è come la password del citofono: chi ce l'ha può fare richieste a tuo nome, e consumare la tua quota. Non incollarla in una chat, non mandarla per mail, non scriverla dentro il codice. Al passo 5 la metti in un posto dove resta al sicuro anche se il foglio lo dai a qualcun altro.
Il programma dentro il foglio
Salta questo passo se hai fatto la copia del foglio pronto: il programma ce l'hai già. Serve solo a chi è partito da un foglio vuoto.
Dentro ogni Foglio Google c'è un editor di programmi che quasi nessuno sa che esiste. Si chiama Apps Script, è gratis, ed è lì che vivrà il radar. Sono due copia-incolla.
- Dal foglio: Estensioni → Apps Script. Si apre l'editor in una scheda nuova.
- In alto a sinistra rinomina il progetto: Radar delle opportunità.
- Apri Codice.gs su GitHub, premi Copy raw file. Nell'editor: clicca nel codice, Ctrl+A, Canc, Ctrl+V.
- Nella colonna di sinistra, accanto a File, premi + → HTML. Chiamalo esattamente
Pannello(senza scrivere.html). - Apri Pannello.html, copia allo stesso modo, svuota il file nuovo e incolla.
- Salva con Ctrl+S.
Pannello, con la P maiuscola: è l'unico che il programma cerca per nome. Se lo chiami diversamente, il menu funziona ma le impostazioni non si aprono.
Nella colonna di sinistra vedi due file, Codice.gs e Pannello.html, e in alto non c'è più scritto «Modifiche non salvate». Nessuna conferma, nessun errore: il programma non è ancora partito, quindi non può dirti niente.
Il menu, e la schermata che spaventa
Da qui in poi non tocchi più il codice: tutto quello che serve sta in un menu, dentro il foglio.
- Torna sulla scheda del foglio e ricaricala (F5). Dopo qualche secondo, nella barra dei menu in alto, dopo Guida, compare 🛰️ Radar.
- Apri 🛰️ Radar → Prepara il foglio.
- Google chiede l'autorizzazione: Rivedi autorizzazioni → scegli il tuo account.
- Compare una schermata che dice «Google non ha verificato questa app». In basso a sinistra: Avanzate → Apri Radar delle opportunità (non sicura).
- Leggi l'elenco dei permessi e premi Consenti.
Google non ha revisionato questo programma — e non lo farà: la revisione serve alle app che si pubblicano per migliaia di sconosciuti. Questo è un programma che tu hai messo nel tuo account e che gira solo sul tuo foglio. Quel messaggio dice esattamente questo, con parole che sembrano peggiori di quello che sono.
Quello che invece vale la pena leggere è l'elenco dei permessi: scrivere in questo foglio, uscire in rete per leggere i portali, creare bozze in Gmail. Non c'è il permesso di inviare: la mail resta ferma finché non la mandi tu. Se un giorno accenderai l'invio automatico, Google ti chiederà un permesso in più — ed è giusto che te lo chieda.
Compare l'avviso «Foglio pronto» e in basso trovi le tre linguette FONTI, OPPORTUNITÀ, LOG, con le intestazioni blu, la prima riga bloccata e la tendina sì / no sulla colonna C.
Le impostazioni
Un pannello laterale con tutto quello che si può cambiare senza programmare. È anche il posto dove la chiave sta al sicuro: non finisce nel foglio, quindi non viaggia con le copie.
- 🛰️ Radar → Impostazioni…: si apre il pannello a destra.
- Incolla la chiave nel primo campo e premi Prova la chiave.
- Apri la tendina Modello: contiene quelli che la tua chiave può usare davvero. Scegli il primo dell'elenco.
- Guarda A chi guardiamo: 14 e 35 sono i valori di partenza, cambiali se il tuo ufficio ha un'altra fascia.
- Premi Salva.
Se invece dice che il modello non esiste, sceglilo dalla tendina — i nomi cambiano ogni pochi mesi e non sono gli stessi per tutte le chiavi. Se dice che la quota è esaurita, la chiave è buona: sta solo chiedendo di aspettare.
Regole aggiuntive è il posto in cui il radar diventa tuo: ci scrivi in italiano cosa tenere e cosa no — «tieni solo ciò che riguarda il Vallo di Diano», «scarta i corsi a pagamento». Una regola alla volta, e si riprova: due insieme non dicono quale ha funzionato. Le regole nate da un errore che hai visto valgono dieci volte quelle pensate a tavolino.
Le fonti, e chi riceve
È il passo che decide la qualità di tutto il resto. Il radar non gira per tutto internet: guarda solo le pagine che gli dai tu. È il suo limite più importante, e va detto ad alta voce ogni volta che lo mostri a qualcuno — se una fonte manca, non la vede.
- Vai nella linguetta
FONTI. Trovi già qualche riga d'esempio: tienile o cancellale. - Per ogni portale: A un nome che riconosci, B l'indirizzo, C
sìdalla tendina, D una nota per ricordarti perché l'hai messa. - Nella colonna E scrivi gli indirizzi email di chi riceverà il riepilogo, uno per riga.
Il radar legge la pagina così com'è: non esegue i programmi che il sito fa girare nel browser. Questo taglia fuori gran parte dei portali pubblici, che l'elenco dei bandi lo costruiscono proprio così — per il radar quelle pagine sono vuote, e infatti risponde, correttamente, che non c'è niente.
Due regole: mai le home (servono le pagine di elenco avvisi) e provare prima di fidarsi. Una fonte che non risponde lo scrive nel registro; una che risponde con soli menu sembra funzionare e non porta mai niente.
Provate il 2 agosto 2026 — funzionano
| Fonte | Indirizzo | Esito della prova |
|---|---|---|
| Giovani2030 | giovani2030.it/bandi-e-opportunita/ | 8 opportunità con scadenze vere |
| Politiche Giovanili | politichegiovanili.gov.it/comunicazione/avvisi-e-bandi/ | 1 bando, scadenza corretta |
| Agenzia Giovani | agenziagiovani.it | 8 fra corsi e call europee |
| Eurodesk | eurodesk.it/notizie | 8 voci |
| Cliclavoro | cliclavoro.gov.it | risponde bene |
Provate — non funzionano così come sono
| Indirizzo | Perché no |
|---|---|
| bandi.sviluppocampania.it | risponde «JavaScript non è abilitato»: senza browser la pagina non esiste |
| portale-giovani.regione.campania.it | poche centinaia di battute di soli menu |
| le home dei portali | sono vetrine: i contenuti stanno nelle pagine interne |
È la pagina avvisi del tuo Comune. Nessun portale nazionale la contiene, ed è esattamente il motivo per cui questo strumento ha senso in un ufficio piccolo: fa il lavoro che nessun altro sta facendo per il tuo territorio.
Il primo giro
Prima a secco, per sapere quanto costerebbe; poi davvero.
- 🛰️ Radar → Quanto costerebbe il prossimo giro. Legge le fonti, applica i filtri e ti dice quante richieste servirebbero — senza farne nemmeno una.
- 🛰️ Radar → Esegui adesso. Da dieci secondi a un minuto.
- Guarda la linguetta
OPPORTUNITÀ, poiLOG.
Se dice nessuna riga nuova, non è un guasto: nel registro c'è scritto perché. Spesso vuol dire che le pagine non sono cambiate dall'ultima volta — ed è una buona notizia, perché quel controllo è gratis.
Prima si scarta tutto quello che si può scartare gratis, e solo su quel che resta si spende: le pagine troppo corte o senza una sola parola da bando non arrivano al modello; le pagine identiche al giro precedente nemmeno — è il risparmio più grosso, perché un portale pubblica ogni due settimane e il radar passa ogni lunedì. Poi c'è un tetto duro di richieste per giro: quando si raggiunge, il giro si chiude in ordine e le fonti rimaste si leggeranno la volta dopo. Meglio un giro incompleto che una quota bruciata a metà.
Controllare alla fonte
È il passo che nessuno salta. Non serve a fidarsi del radar: serve a sapere quanto fidarsi, che è una cosa diversa e più utile.
- Prendi tre righe a caso in
OPPORTUNITÀe apri il Link in colonna G. - Controlla che il titolo corrisponda, e soprattutto la scadenza.
- Quando una riga è verificata, cambia la colonna Stato da
da verificarea quello che vuoi:ok,segnalata,scartata. Quella colonna la scrive sempre una persona, mai il programma. - Se trovi un errore, scrivilo nel
LOG, poi aggiungi una regola nel pannello (Regole aggiuntive) e rilancia.
Se un dato non è scritto per esteso nella pagina, la casella resta vuota. Non lo deduce, non lo stima, non lo ricava dal contesto. Una casella vuota si nota; una data sbagliata no.
Le pagine di elenco raccontano poco: spesso avrai titolo e scadenza, e il resto vuoto. È normale — il dettaglio sta nella pagina del singolo bando, che il radar per ora non apre.
Non entrano: se la data c'è ed è passata, la riga viene scartata e lo scarto finisce nel registro. Ma solo quando la data è scritta e leggibile: «prossimamente» o «fino a esaurimento fondi» vogliono dire non lo sappiamo, e allora la riga resta. Per togliere vale la stessa regola che vale per aggiungere: non si inventa niente.
La bozza, e chi la manda
Il radar prepara. Non spedisce. È la riga di codice che conta più di tutte le altre messe insieme.
- Apri Gmail → Bozze: trovi «Radar opportunità — N novità del …».
- Leggila. In testa c'è scritto che quelle righe non sono state verificate: è vero, e chi la riceve deve saperlo.
- Quando sei pronto: 🛰️ Radar → Invia il riepilogo che aspetta. Ti mostra oggetto e destinatari e chiede conferma.
Perché è ciò che rende questo strumento adottabile da un ufficio pubblico. Un agente che manda email da solo, di notte, con scadenze che nessuno ha controllato, è un problema nuovo — e la prima cosa che farebbe togliere di mano lo strumento. Nel pannello c'è un interruttore per l'invio automatico: è spento, e chi lo accende si prende quella responsabilità. Ogni invio automatico resta scritto nel registro.
La sveglia del lunedì
È questo passo a trasformare un programma in un agente: da qui in poi lavora quando tu non ci sei.
- Nel pannello Impostazioni scegli giorno e ora (lunedì alle 8 è il valore di partenza), e salva.
- 🛰️ Radar → Accendi la sveglia settimanale.
- Per fermarlo: Spegni il radar. Non cancella niente, smette solo di svegliarsi.
Compare «Da adesso parte da solo ogni lunedì verso le 8, anche a computer spento». Da 🛰️ Radar → Diagnostica vedi in ogni momento se la sveglia è accesa e com'è andato l'ultimo giro.
Quando si rompe
Prima cosa, sempre: 🛰️ Radar → Diagnostica. Controlla fogli, chiave, fonti, destinatari, sveglia e ultimo giro nell'ordine in cui le cose accadono, e dice a che punto si è rotto.
| Sintomo | Che cosa è successo |
|---|---|
| «Manca il foglio…» | una linguetta è stata rinominata: Prepara il foglio la rimette |
| «Manca la chiave di Gemini» | hai copiato il foglio da qualcun altro: la chiave non viaggia con le copie, mettine una tua |
| «chiave rifiutata» | chiave sbagliata o cancellata da AI Studio |
| «il modello non esiste» | scegli il modello dalla tendina: i nomi cambiano ogni pochi mesi e non sono uguali per tutte le chiavi |
| «quota esaurita» | finite le richieste gratuite di oggi: riprende al prossimo giro. Se capita spesso, scegli un modello lite |
| «risposta troncata» | alza lunghezza massima della risposta nelle impostazioni avanzate |
| «il portale ha risposto 403» | quel sito non si lascia leggere dai programmi: è un dato interessante, non un fallimento. Cerca un'altra pagina o toglila |
| nessuna riga, nessun errore | guarda il LOG: quasi sempre è «pagina identica al giro scorso». Per forzare: Fai rileggere tutte le pagine |
- I nomi delle tre linguette e l'ordine delle colonne di
OPPORTUNITÀ: il programma scrive contando le posizioni. - La colonna E di
FONTI: senza almeno un indirizzo, il riepilogo non può essere intestato a nessuno. - La chiave nel pannello: se la scrivi nel foglio, viaggia con ogni copia che ne fai.
- La bozza: si può accendere l'invio automatico, ma sappi che cosa stai spegnendo — la persona che legge prima di mandare.
Il codice, e dove vive
Tutto il programma è pubblico, con licenza MIT: si legge, si copia, si modifica, si porta nel proprio Comune. Sta qui — github.com/logika-studio/radar-opportunita.
Nel codice non c'è nessuna chiave e nessun indirizzo email, ed è giusto che resti così. La chiave sta nelle proprietà del progetto (ci va dal pannello, passo 5) e gli indirizzi nella colonna E del foglio FONTI (passo 6). Vuol dire che questo codice lo puoi dare a chiunque per intero, senza toglierne niente — ed è esattamente quello che stiamo facendo.
Per installarlo bastano due file — è la cartella installazione-rapida/, che li impacchetta —, ma il programma vero è diviso in sette, e la divisione non è tecnica: segue l'ordine in cui le cose accadono.
| File | Che cosa fa |
|---|---|
| 00-Configurazione | i valori di partenza — età, modello, tetto delle richieste, giorno della sveglia. Non si toccano dal codice: si cambiano dal pannello, e il codice resta com'è. |
| 01-Fonti | va a prendere le pagine e le riduce a testo. È il pezzo che dipende da cose che non controlli: quando un sito cambia veste, è qui che si rompe — e per questo ogni errore finisce nel LOG invece di fermare il giro. Qui stanno anche i due filtri che risparmiano. |
| 02-Gemini | il cuore: le istruzioni che il modello legge prima di ogni pagina, la forma della risposta, i ritentativi educati, lo scarto dei bandi già scaduti. È l'unico punto che spende. |
| 03-Foglio | scrive le righe e il registro. Poche righe, nessuna intelligenza: deve solo mettere le cose nella colonna giusta. |
| 04-Radar | il giro completo, la bozza, l'invio, la sveglia. Si legge dall'alto come uno schema. |
| 05-Menu | il menu 🛰️ Radar: è ciò che ha trasformato «apri l'editor ed esegui una funzione» in «scegli una voce». |
| 06-Preparazione | crea le tre linguette con le intestazioni giuste, e la diagnostica. |
| Pannello.html | il pannello delle impostazioni. |
I commenti sono in italiano, discorsivi, e spiegano perché una riga è fatta in quel modo — non cosa fa: quello si vede. È una scelta: questo programma nasce da un laboratorio pubblico, e il codice è parte di ciò che si insegna. Chi lo apre fra un anno, magari senza saper programmare, deve poterci capire qualcosa.
L'ordine dei controlli, nel giro, è la parte più importante di tutte: prima si scarta gratis tutto quello che si può scartare, e solo su quel che resta si spende una richiesta. Ogni riga che viene prima della chiamata al modello è una riga che fa risparmiare.
Fascia d'età, modello, giorno e ora della sveglia, tetto delle richieste, quanta parte di ogni pagina leggere, e soprattutto le regole aggiuntive — «tieni solo ciò che riguarda il Vallo di Diano», «scarta i corsi a pagamento». Tutto dal pannello. Nel codice si mette mano solo per cambiare come lavora, non cosa cerca.
In 04-Radar c'è createDraft: crea la bozza. Sostituirla con l'invio diretto fa partire email da sole, di notte, con scadenze che nessuno ha controllato. È la cosa che rende oggi questo strumento adottabile da un ufficio pubblico — e la prima che glielo farebbe togliere di mano.
Se lo migliori, le cose più utili da rimandare indietro sono tre: fonti che funzionano (pagine di elenco avvisi che rispondono senza JavaScript, soprattutto comunali), regole nate da un errore che hai visto davvero, e i casi in cui ha sbagliato — quelli valgono più di tutto: il registro di un radar acceso da mesi è un dato raro su quanto sono affidabili questi strumenti dentro un ufficio pubblico.