Lighthouse
Uno strumento per il reparto web che esegue la CLI ufficiale di Lighthouse su intere sezioni di un sito — fino a 200 pagine per scansione, con un massimo di 8 test in parallelo — completo di import da sitemap Yoast, storico per utente e pannello admin.

La sfida che ho risolto
Fare un audit manuale di un sito da 20 pagine significa lanciare Lighthouse 40 volte (desktop + mobile per ogni pagina) e trascrivere i punteggi a mano: più di un'ora e mezza di lavoro ripetitivo. Con questo strumento incolli le URL — o importi la sitemap — e in una decina di minuti hai un report aggregato con i punteggi medi per dispositivo, grazie a 8 test in parallelo.
Perché è nato
Il programma è nato da una frase sentita in ufficio: un membro del reparto web si lamentava di quanto fosse tedioso analizzare i siti pagina per pagina per verificare SEO, performance e accessibilità. Ho deciso di dare loro una mano creando questo strumento, che esegue la CLI ufficiale di Lighthouse (lo stesso motore di Chrome DevTools) e permette di scansionare fino a 200 pagine in successione — limite configurabile — con un massimo di 8 test in parallelo. Il tetto alla concorrenza, insieme a un rate limiter interno, evita sia di saturare la macchina che esegue i test (ogni scansione avvia un’istanza di Chrome) sia di bombardare di richieste il sito analizzato. Le URL si possono inserire a mano, caricare da file o importare direttamente da una sitemap Yoast.
Screenshot
La schermata di accesso: l’app è protetta da autenticazione JWT.
Una scansione in esecuzione: barra di avanzamento e log in tempo reale della CLI di Lighthouse.
Il report riepilogativo: punteggi medi complessivi e per dispositivo (desktop e mobile), con la tabella dei report dettagliati.
Lo storico delle scansioni per singolo utente, con stato di ogni run e link al report.
Il pannello admin: creazione utenti, reset password e gestione dei ruoli.
Il risultato
Prendendo come esempio un sito da 20 pagine: a mano servono 40 esecuzioni di Lighthouse (desktop e mobile per ogni pagina), circa 2 minuti l’una tra test e trascrizione dei punteggi — oltre un’ora e mezza in totale, da rifare a ogni verifica. Con lo strumento la stessa scansione gira in circa 10 minuti senza supervisione, e il report riepilogativo con i punteggi medi per dispositivo è pronto da condividere. Per il reparto web significa passare da “lo facciamo quando c’è tempo” ad audit di routine.
Tecnologie usate
Il backend è in Python, il frontend in React. Python è stato scelto perché inizialmente bastava una semplice GUI desktop in tkinter; col tempo il progetto si è evoluto in una web app più completa: frontend in React, backend FastAPI con autenticazione JWT, gestione degli utenti con pannello admin e storico delle scansioni per singolo utente. Lighthouse si installa via npm e richiede Chrome sulla macchina che esegue i test; nella versione Docker per il deploy su server, invece, Chrome e Lighthouse sono già inclusi nell’immagine.