Ecco un README.md pulito e pronto per GitHub, pensato per la versione production con Flask + Gunicorn + Render.
# Web Title Scanner
Piccolo servizio web in Flask che legge una lista di URL da file e restituisce i titoli delle pagine in forma tabellare tramite interfaccia web.
Il progetto è pensato per essere:
- minimale
- deployabile su Render / VPS
- facilmente estendibile
- adatto a uso personale o monitoring leggero
---
## 🚀 Funzionalità
- Lettura automatica URL da `urls.txt`
- Fetch concorrente delle pagine web
- Estrazione del tag `<title>`
- Ordinamento risultati:
- prima siti con status `200`
- poi ordine alfabetico del dominio
- Frontend moderno con dashboard HTML
- Supporto produzione con Gunicorn
---
## 📁 Struttura progetto
project/ │ ├── app.py ├── urls.txt ├── requirements.txt │ ├── templates/ │ └── index.html │ └── static/ └── app.js
---
## 📄 urls.txt
Inserisci qui i siti da monitorare:
https://openai.com https://github.com https://google.com example.com
---
## ⚙️ Installazione locale
```bash
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
python app.pyOppure in modalità produzione locale:
gunicorn app:appFlask
gunicorn
requests
beautifulsoup4
gunicorn app:app
Browser
↓
Flask (Gunicorn)
↓
requests + BeautifulSoup
↓
urls.txt
urls.txt è un file statico:
- viene letto ad ogni richiesta
- non viene modificato dall’app
- aggiornamenti tramite Git o deploy
Usa sempre Gunicorn, NON Flask dev server.
- Python 3.9+
- Flask
- requests
- beautifulsoup4
- gunicorn