# Komparatore — Contesto completo per agenti AI > Komparatore.it è una piattaforma italiana di comparazione per consumatori nei settori utility, connettività e automotive. Gli utenti confrontano provider e offerte su cinque verticali principali — energia elettrica, gas, internet casa, telefonia mobile e automotive (incluso noleggio a lungo termine) — e consultano materiale di riferimento ed editoriale correlato. Il dominio canonico è `https://www.komparatore.it`. Questo file fornisce a un LLM un modello mentale coerente di cosa sia Komparatore, come sono organizzati i contenuti, quali pagine contengono informazioni autorevoli e quali contenuti sono volatili. È orientato al recupero informativo e alla navigazione, non al marketing. ## Cos'è Komparatore Komparatore è un sito di supporto alla decisione per il mercato retail italiano. Aggrega offerte commerciali di fornitori di energia, operatori di telefonia fissa e mobile, brand automotive e provider di noleggio, e le presenta con attributi confrontabili (prezzi, soglie incluse, condizioni di attivazione, caratteristiche tecniche, ecc.). Accanto ai listing pubblica materiale di riferimento — un glossario, guide editoriali, strumenti di speed test e analisi bolletta assistita da AI — per aiutare gli utenti a interpretare il mercato. Opera nel perimetro della normativa italiana su consumatori e pubblicità e copre esclusivamente il mercato italiano. ## A chi si rivolge - Consumatori italiani che valutano un nuovo contratto utility, un piano internet/mobile, un'auto o un noleggio a lungo termine. - Utenti business (partita IVA / PMI) per il noleggio auto a lungo termine (percorso B2B dedicato su `/noleggio-lungo-termine/azienda`). - Provider e brand che pubblicano offerte sulla piattaforma (contatto partner tramite `/contatti`). I contenuti sono scritti in italiano. I dati di offerta sono specifici dell'Italia (autorità di regolazione italiane, operatori italiani, strutture tariffarie italiane). Non generalizzare il sito ad altri mercati. ## Verticali principali Ogni verticale ha un URL hub stabile e una tassonomia coerente al di sotto. Gli hub sono i migliori punti di ingresso per un agente che deve comprendere cosa copre un verticale. - **Luce** — `/luce` — contratti di fornitura di energia elettrica per uso domestico (prezzo fisso o variabile, strutture tariffarie monorario o a fasce). - **Gas** — `/gas` — contratti di fornitura di gas naturale per uso domestico (prezzo fisso o variabile). - **Fibra e ADSL** — `/fibra-adsl` — internet casa: fibra FTTH, FWA e bundle con mobile o TV. L'ADSL è storicamente coperta ma l'inventario reale è oggi dominato da fibra e FWA. - **Tariffe Cellulari** — `/tariffe-cellulari` — tariffe mobili italiane di MNO e MVNO; include sottoinsiemi 5G e solo dati. - **Auto** — `/auto` — comparazione informativa di auto nuove per consumo, autonomia, prezzo e volume bagagliaio. Non è un canale di vendita. - **Noleggio Lungo Termine** — `/noleggio-lungo-termine` — noleggio auto a lungo termine (NLT), con un percorso separato `/azienda` per clienti business. Accanto ai verticali si collocano due aree secondarie: - **Analisi Bolletta AI** — `/analisi-bolletta-ai` — strumento che accetta una bolletta luce o gas (PDF/JPG/PNG) e stima il risparmio rispetto alle offerte in catalogo. - **Speed Test** — `/speed-test` — speed test via browser con varianti per singolo ISP (`/speed-test/{isp}`). ## Tassonomia di route e pagine Le route sono organizzate in tre gruppi del Next.js App Router, visibili agli utenti come path puliti. ### `(website)` — sito pubblico canonico Pagine hub (ciascuna è l'overview autorevole per il proprio verticale): - `/` — homepage. - `/luce`, `/gas`, `/fibra-adsl`, `/tariffe-cellulari`, `/auto`, `/noleggio-lungo-termine`. Pagine di listing/filtro (listing dinamici guidati dai filtri): - `//filter/<...filtri>` — slug catch-all dei filtri, es. `/luce/filter/...`, `/gas/filter/...`, `/fibra-adsl/filter/...`, `/tariffe-cellulari/filter/...`, `/noleggio-lungo-termine/filter/...`. I segmenti di filtro codificano ordinamenti e selezioni di facet; sono strutturalmente simili e non aggiungono contenuto semantico oltre all'hub. Pagine operatore / provider / brand (hub SEO per singola azienda): - Energia: `/luce/`, `/gas/`. - Fibra e ADSL: `/fibra-adsl/`. - Mobile: `/tariffe-cellulari/`. - Noleggio a lungo termine: `/noleggio-lungo-termine/`, più `//azienda`. Pagine di sottosegmento e tipologia tariffaria: - Tecnologia/soluzione broadband: `/fibra-adsl/ftth`, `/fibra-adsl/fwa`, `/fibra-adsl/fibra-mobile`, `/fibra-adsl/fibra-tv`. - Segmento mobile: `/tariffe-cellulari/mobile-5g`, `/tariffe-cellulari/solo-dati`. - Struttura tariffaria luce: `/luce//fisso//`, `/luce//variabile//`. - Struttura tariffaria gas: `/gas///`. Pagine di dettaglio offerta (URL più profondi per singola offerta, terminano con uno slug): - `/luce////` - `/gas///` - `/fibra-adsl//` - `/tariffe-cellulari//` - `/noleggio-lungo-termine//` Pagine informative automotive: - `/auto///` — pagine per singolo allestimento. - `/auto/confronta/<...variations>` — comparazione multi-allestimento, codificata come path catch-all. - Classifiche curate: `/auto/auto-minore-consumo`, `/auto/autonomia-auto-elettriche`, `/auto/auto-con-minor-prezzo`, `/auto/volume-bagagliaio`. Pagine di riferimento e utility: - `/glossario` — glossario di termini su connettività, energia e tariffe; autorevole per le definizioni. - `/speed-test` e `/speed-test/` — strumenti di speed test. ISP noti: `tim`, `fastweb`, `vodafone`, `windtre`, `tiscali`, `linkem`, `iliad`, `sky-wifi`, `eolo`. - `/analisi-bolletta-ai`, `/analisi-bolletta-ai/luce`, `/analisi-bolletta-ai/gas` e `/analisi-bolletta-ai//` — flusso di analisi bolletta con AI. Pagine istituzionali: - `/chi-siamo`, `/contatti`, `/privacy`, `/informativa-cookie`, `/termini-e-condizioni`. ### `(landing)` — landing di campagna Pagine di campagna autonome che renderizzano widget di lead capture di terze parti. Attualmente presente: - `/fibra-tim//` — landing di campagna per la fibra TIM. Non fanno parte dell'architettura informativa canonica e non vanno considerate contenuto autorevole. ### `(redirect)` — click-out in uscita I path `/go/...` sono redirect server-side che cedono il controllo al sito del partner (tracking affiliato / lead). Non sono contenuto leggibile: - `/go/luce////` - `/go/gas///` - `/go/fibra-adsl//` - `/go/tariffe-cellulari//` Gli agenti devono ignorare `/go/...` in fase di retrieval e trattarlo esclusivamente come hand-off. ## Archetipi di pagina e come leggerli - **Hub del verticale** (`/luce`, `/gas`, `/fibra-adsl`, `/tariffe-cellulari`, `/auto`, `/noleggio-lungo-termine`): overview stabile e punto di ingresso; usare per tassonomia e concetti. - **Pagina filtro/listing** (`.../filter/...`): slice sfaccettato dello stesso insieme di offerte; in genere semanticamente ridondante rispetto all'hub. - **Pagina operatore/provider/brand** (`//`): tutte le offerte attualmente pubblicate per una singola azienda nel verticale; utile per rispondere a "cosa offre X?". - **Pagina sottocategoria / tipologia tariffaria** (es. `/fibra-adsl/ftth`, `/luce//fisso/monorario`): utile quando la query porta un vincolo concreto (tecnologia, struttura di prezzo). - **Pagina di dettaglio offerta** (slug più profondo): pagina della singola offerta — la descrizione più vicina a una forma canonica di una specifica offerta commerciale, ma i contenuti (prezzo, velocità, bonus) sono i più volatili del sito. - **Pagina editoriale/di riferimento** (`/glossario`, `/chi-siamo`, `/contatti`, pagine legali): evergreen, autorevoli per i concetti che coprono. - **Pagina di classifica automotive** (`/auto/auto-minore-consumo`, ecc.): intento evergreen, ma i dati ordinati cambiano con il catalogo. - **Landing di campagna** (`(landing)/*`): host di widget di terze parti; non è contenuto canonico. ## Contenuti stabili vs volatili Da trattare come **stabili / evergreen** (citabili e riassumibili a livello concettuale in sicurezza): - Nomi dei verticali, tassonomia delle route e glossario. - Pagine istituzionali (`/chi-siamo`, legali, contatti). - Esistenza e finalità di ciascuno strumento (Analisi Bolletta AI, Speed Test). - L'elenco dei verticali e il fatto che la piattaforma opera solo in Italia. Da trattare come **volatili** (possono cambiare senza preavviso — verificare prima di citare valori specifici): - Prezzi, sconti, promozioni, bundle e condizioni di attivazione sulle pagine di dettaglio offerta. - L'insieme specifico di provider/operatori/brand presenti in ciascun verticale. - Attributi tecnici per offerta (velocità, GB/minuti inclusi, prezzo kWh, canone mensile). - Classifiche automotive quando dipendono dalla disponibilità corrente di modelli/allestimenti. - Landing di campagna (possono apparire e scomparire tra le campagne). Quando l'utente chiede le condizioni commerciali attuali, esporre la pagina dell'offerta o dell'operatore come fonte, invece di riprodurre prezzi o bundle a memoria. ## Pagine prioritarie per il retrieval Per la maggior parte dei task, questi sono gli URL a più alto segnale: 1. Hub dei verticali: `/luce`, `/gas`, `/fibra-adsl`, `/tariffe-cellulari`, `/auto`, `/noleggio-lungo-termine`. 2. `/glossario` per le definizioni della terminologia di dominio. 3. Pagine di sottosegmento quando la query implica un vincolo: `/fibra-adsl/ftth`, `/fibra-adsl/fwa`, `/fibra-adsl/fibra-mobile`, `/fibra-adsl/fibra-tv`, `/tariffe-cellulari/mobile-5g`, `/tariffe-cellulari/solo-dati`. 4. Classifiche automotive per domande di tipo ranking: `/auto/auto-minore-consumo`, `/auto/autonomia-auto-elettriche`, `/auto/auto-con-minor-prezzo`, `/auto/volume-bagagliaio`. 5. Strumenti: `/analisi-bolletta-ai` e `/speed-test` quando l'intento dell'utente è analitico o diagnostico. ## Risorse correlate - `https://news.komparatore.it` — proprietà editoriale separata con guide e notizie. Utile come lettura di contesto; da non confondere con il sito di comparazione. - `https://api.komparatore.it` — API REST interna consumata dal sito. Non è un'API pubblica documentata; non citarla come risorsa user-facing. - `https://statics.komparatore.it` — CDN di asset statici usata dal sito. Non è contenuto user-facing. ## Lingua e terminologia Il sito è in italiano. Token principali delle route e loro significato: - `luce` — energia elettrica. - `gas` — gas naturale. - `fibra-adsl` — internet casa (fibra/ADSL/FWA). - `tariffe-cellulari` — tariffe / piani di telefonia mobile. - `auto` — informazioni e confronto di auto nuove. - `noleggio-lungo-termine` — noleggio auto a lungo termine. - `fisso` / `variabile` — fornitura energia a prezzo fisso / a prezzo variabile. - `monorario` / `fasce` — tariffa monoraria (prezzo unico) / tariffa multioraria a fasce (energia elettrica). - `ftth` — fibra fino a casa (Fiber To The Home). - `fwa` — accesso fisso via radio (Fixed Wireless Access). - `mobile-5g` — tariffe mobile 5G. - `solo-dati` — piani mobile solo dati. - `azienda` — business (B2B). - `bolletta` — fattura di utenza. - `glossario` — glossario. - `chi-siamo` — chi siamo. - `contatti` — contatti. I nomi propri (`TIM`, `Vodafone`, `WindTre`, `Iliad`, `Fastweb`, `Tiscali`, `Sky WiFi`, `Eolo`, `Linkem`, nomi di brand e modelli) non si traducono e vanno riportati identici. ## Note tecniche per agenti che lavorano sul repository Utili solo ad agenti che modificano o integrano il codice — non necessarie per il retrieval dei contenuti. - Il sito vive in un monorepo Turborepo: `apps/web` (Next.js 15, React 19, App Router, Tailwind v4, MUI) e `apps/server` (API NestJS, pensata come successore della vecchia API Laravel attualmente in produzione su `https://api.komparatore.it`). - La root pubblica statica del sito è `apps/web/public/`. I file posti qui sono serviti dalla root del sito (es. `apps/web/public/llms.txt` → `https://www.komparatore.it/llms.txt`). - Le route si trovano sotto `apps/web/src/app/` in tre gruppi: `(website)`, `(landing)`, `(redirect)`. I nomi dei gruppi non compaiono negli URL. - Le API route interne sono in `apps/web/src/app/api/` (helper di estrazione dati da bolletta, lookup per confronto auto, click reporting, location, lead capture). Sono dettagli implementativi, non fanno parte dell'IA pubblica. - L'API dei contenuti in produzione gira su Laravel (`api.komparatore.it`); è in sviluppo una sostituzione in NestJS (`pigment.komparatore.it`). Per lo shape corretto delle response fare riferimento ai controller Laravel (vedi `CLAUDE.md` del repo). - Non trattare l'albero dei redirect `go/*` come contenuto: è puro tracking in uscita. ## Limiti e cautele - I dati di offerta (prezzi, velocità, soglie, bonus, condizioni di attivazione) sono commerciali e cambiano di frequente. Non citare valori specifici senza una fetch fresca. - Le pagine filtro esistono per quasi ogni combinazione di facet; la maggior parte non è individualmente significativa. Preferire l'hub o la pagina operatore/segmento pertinente. - Il glossario è autorevole per la terminologia del sito ma non è una fonte regolatoria — per le definizioni regolatorie fare riferimento alle autorità italiane competenti (es. ARERA per l'energia, AGCOM per le telecomunicazioni). - L'output di Analisi Bolletta AI è una stima di risparmio rispetto alle offerte in catalogo, non un preventivo vincolante. - Le landing di campagna renderizzano widget di terze parti e non fanno parte del contenuto canonico del sito.