📚 Documentazione – Italian SEO Validator

Questa guida sintetizza le best practice SEO di Google e suggerimenti operativi per scrivere contenuti utili, affidabili e facili da leggere. Il Validator è uno strumento di supporto: non rivela né utilizza formule segrete, e non espone dettagli del calcolo interno dello score.

Colori e soglie (UI)

• Verde (≥ 80): ottimo
• Blu (70–79): buono
• Giallo (60–69): sufficiente
• Rosso (< 60): da migliorare

Come usare il Validator

• Scrivi per le persone, non per i motori di ricerca. Usa il Validator per evidenziare aree migliorabili.
• Segui i suggerimenti come checklist di qualità, non come regole rigide.
• Rivedi i contenuti con occhio umano: coerenza, accuratezza, utilità concreta per il tuo pubblico.
• Supporto Pages: Il validator funziona sia su Post che Pages. Seleziona l'intent appropriato (es. Pillar E-E-A-T per landing page).
• Modalità Flessibile: Per contenuti fuori standard (landing, pagine prodotto), attiva la checkbox "Modalità flessibile" sotto il selettore Intent per allentare le penalità di KD e wordcount (~20% più tollerante).

Linee guida Google (sintesi pratica)

Indicazioni tratte da Google Search Central: contenuti people‑first, esperienza di pagina, dati strutturati quando opportuni e rispetto delle politiche anti‑spam.

• People‑first content: offri informazioni originali, complete e affidabili; titolo chiaro e non sensazionalistico; il lettore deve uscire soddisfatto (Guida “helpful content”).
• Who/How/Why: indica autore e profilo, spiega come hai creato il contenuto (anche se AI‑assisted) e perché esiste; la finalità deve essere aiutare l’utente.
• Page experience: buoni Core Web Vitals, HTTPS, mobile friendly, niente interstitial invasivi, layout chiaro (Page experience).
• Dati strutturati: usa JSON‑LD quando rilevante (articoli, FAQ, prodotti…), compila proprietà richieste e valida con Rich Results Test (Structured data).
• Evitare pratiche vietate: niente keyword stuffing, scraping/riuso senza valore, link spam, creazione in scala di pagine senza utilità (Spam policies).
• Contenuti generati con AI: focalizzati su accuratezza, qualità e rilevanza; spiega l’uso dell’automazione quando sensato; rispetta le policy (AI guidance).

Suggerimenti operativi per le 6 metriche

1) Leggibilità (Gulpease)

• Frasi generalmente brevi e chiare; prediligi forma attiva e lessico concreto.
• Paragrafi snelli e ben separati; sottotitoli descrittivi che anticipano il contenuto.
• Evita gergo non necessario; spiega i termini tecnici al primo uso.
• Rileggi ad alta voce: fluidità e naturalezza sono un buon segnale.

Novità v3.5.1: Gulpease Benchmark (STANDARD/PRO)

📊 Confronta la tua leggibilità con le tue medie personali
Il nuovo Gulpease Benchmark ti mostra come il tuo articolo attuale si posiziona rispetto alle tue medie degli ultimi 30 e 90 giorni. Non più confronti con "top 10% blogger" generici, ma progresso personale reale:

• Verde (In miglioramento): +5 punti o più rispetto alla tua media 30gg
• Blu (Nella tua media): Pari o sopra alla tua media recente
• Giallo (Sotto la tua media): -5 punti rispetto alla media
• Rosso (Da migliorare): Calo significativo rispetto ai tuoi standard

💡 Suggerimento: Il benchmark si arricchisce nel tempo. Più articoli validi, più accurate diventano le tue medie personali. Usa il pulsante "🔄 Ricontrolla" dopo modifiche al testo per aggiornare il confronto.

Analisi Frasi Lunghe (FREE/STANDARD/PRO)

Il plugin rileva automaticamente le prime 3 frasi più lunghe (oltre 25 parole) e fornisce suggerimenti specifici:

• >35 parole → "Dividi in 2-3 frasi separate"
• 30-35 parole → "Dividi in 2 frasi"
• 25-29 parole → "Accorcia rimuovendo incisi o subordinate"

📝 Target ideale: 15-20 parole per frase per contenuti web. Frasi oltre 25 parole riducono la leggibilità e possono abbassare il punteggio Gulpease.

Scala Gulpease Dettagliata (6 livelli)

Range	Livello	Descrizione
80–100	Eccellente	Molto scorrevole, ideale per blog generalisti e contenuti divulgativi
70–79	Facile	Buon equilibrio tra chiarezza e profondità professionale
60–69	Standard web	Ottimale per la maggior parte dei blog e articoli SEO
50–59	Medio-difficile	Accettabile per contenuto professionale, semplifica frasi lunghe se possibile
40–49	Difficile	Adatto a pubblico specializzato, per pubblico generale dividi frasi e usa esempi
0–39	Molto difficile	Accademico/specialistico, per migliorare: frasi <20 parole, lessico quotidiano

Gulpease vs Flesch Reading Ease: quale usare per l'italiano?

Italian SEO Validator usa Gulpease perché è calibrato sulla lingua italiana. Flesch Reading Ease è nato per l'inglese e sovrastima la difficoltà dei testi italiani (che hanno parole più lunghe e più sillabe). Ecco le differenze principali:

Caratteristica	Gulpease (Italiano)	Flesch Reading Ease (Inglese)
Lingua di origine	🇮🇹 Italia (Università "La Sapienza", 1988)	🇺🇸 USA (Rudolf Flesch, 1948)
Formula base	89 + (300 × frasi – 10 × lettere) / parole	206.835 – (1.015 × parole/frasi) – (84.6 × sillabe/parole)
Unità di misura	Numero di lettere e frasi	Numero di sillabe e parole
Scala di punteggio	0–100 → più alto = più leggibile	0–100 → più alto = più leggibile
Intervalli tipici	80–100 = facile 60–80 = media 40–60 = difficile	90–100 = molto facile 60–70 = standard 0–30 = molto difficile
Target di riferimento	Adulti italiani medi (scuola secondaria)	Lettori madrelingua inglese
Sensibilità linguistica	Adatta alla morfologia e lunghezza delle parole italiane	Non adatta per lingue con parole più lunghe e più sillabe come l'italiano
Punti di forza	✅ Preciso per testi italiani ✅ Usa lettere e frasi (più affidabile per l'italiano) ✅ Meno falsi negativi in testi lunghi	✅ Diffuso nei tool SEO internazionali ✅ Confrontabile tra lingue anglofone
Limiti	❌ Non adatto per inglese o lingue sintetiche ❌ Non standardizzato in software internazionali	❌ Sovrastima la "difficoltà" dei testi italiani ❌ Penalizza parole lunghe tipiche dell'italiano
Uso ideale	Contenuti italiani, articoli SEO, blog, guide	Contenuti in inglese, manuali tecnici o accademici
Range SEO consigliato (in italiano)	60–80 (facile da leggere, buon equilibrio SEO)	Non affidabile per testi italiani

Conclusione: Se scrivi in italiano, Gulpease è più accurato e evita falsi allarmi. Flesch va bene per l'inglese, ma per contenuti italiani rischia di segnalare come "difficili" testi perfettamente leggibili.

2) Struttura (H2/H3, scannabilità)

• Ogni H2 copre un sotto‑tema utile all’intento; apri la sezione con una mini‑answer (2 frasi che rispondono subito).
• Usa elenchi puntati/num. per passi, requisiti, pro/contro; evidenzia con <strong> solo ciò che aiuta la scansione.
• Mantieni gerarchie coerenti (H2 → H3) e titoli auto‑esplicativi.
• Chiudi le sezioni con un breve takeaway o prossimo passo.

3) Rilevanza semantica

• Scrivi in modo naturale attorno alla keyword principale, senza ripetizioni forzate.
• Integra varianti, sinonimi e concetti correlati per coprire le query degli utenti.
• Rispondi alle domande tipiche: cosa, come, quando, pro/contro, alternative.
• Evita tecniche artificiali (liste di città, keyword ripetute in blocco, ecc.).

4) Segnali di linguaggio artificiale (AI‑proxy)

• Varia ritmo e struttura: alterna frasi brevi e medie, evita pattern ripetitivi.
• Inserisci dettagli specifici, esempi e riferimenti concreti; elimina frasi vuote.
• Rivedi manualmente testi generati con AI per tono, precisione e aderenza al brand.

5) E‑E‑A‑T (Esperienza, Competenza, Autorevolezza, Affidabilità)

• Mostra autore, profilo/bio e data di ultimo aggiornamento quando pertinente.
• Cita fonti verificabili; collega in uscita a risorse autorevoli quando utile.
• Costruisci internal linking tematico verso contenuti correlati e rilevanti.

6) Qualità del contenuto

• Offri valore reale: dati, esempi pratici, checklist, tabelle o immagini esplicative.
• CTA chiare e contestuali; evita titoli clickbait e promesse non mantenute.
• Chiudi con un riepilogo dei punti chiave o una decisione consigliata.

Per LLM e AI Overviews (estrazione risposte)

• Mini‑answer in apertura di articolo e di ogni H2: risposta breve e diretta.
• Takeaway alla fine delle sezioni: 1–2 frasi con “cosa fare ora”.
• Usa elenchi, tabelle e sottotitoli espliciti per favorire l’estrazione.
• Includi fatti verificabili, cifre e fonti attendibili.
• Evita riempitivi e frasi generiche; privilegia specificità e chiarezza.

Strumenti utili

• SEO Starter Guide
• Helpful, reliable, people‑first content
• Page Experience
• Structured Data (intro) · Rich Results Test
• Spam Policies
• Uso di contenuti generati con AI
• PageSpeed Insights · Search Console

FAQ

• Perché 79 è blu? Per coerenza visiva usiamo soglie discrete: blu 70–79.
• Perché non pubblicate la formula dello score? Per evitare copie della logica e perché i criteri evolvono: puntiamo a suggerimenti pratici, non a svelare il modello.
• Dove vedo l'utilizzo? In WordPress: Bacheca → Italian SEO Validator → Il Mio Utilizzo.
• Come attivo la licenza STANDARD? Vai in Settings → Licenza e Piano, inserisci la chiave ricevuta da Gumroad e clicca "Attiva licenza".
• Cosa include il tier STANDARD? 50 validazioni/mese, Link Suggestions da sitemap, Cannibalization Detection e supporto prioritario.
• Ho ricevuto solo l'Order ID, non la chiave. Cosa faccio? L'Order ID non è una license key. Assicurati che il prodotto Gumroad sia configurato con Generate license keys. In alternativa, crea un prodotto con licenza e ripeti l'acquisto (anche con coupon 100%). Dopo l'acquisto riceverai una license key alfanumerica da incollare nelle impostazioni del plugin.

🔐 Come Attivare la Licenza STANDARD

1. Acquista su Gumroad: Vai su https://pannonius.gumroad.com/l/Italian-seo-validator e completa l'acquisto (mensile €6.90 o annuale €49).
2. Ricevi la chiave via email: Gumroad ti invierà automaticamente la license key dopo il pagamento.
3. Attiva in WordPress: Vai in Bacheca → Italian SEO Validator → Settings, scorri alla sezione "Licenza e Piano", incolla la chiave e clicca "Attiva licenza".
4. Verifica tier: Se l'attivazione ha successo, vedrai Tier: STANDARD con data di scadenza (se abbonamento) o nessuna scadenza (se lifetime).
5. Usa le nuove funzionalità:
   • Link Suggestions: Nella metabox vedrai una nuova sezione "Link Interni Suggeriti" con articoli correlati da linkare. Il sistema analizza gli ultimi ~200 contenuti pubblicati per suggerire collegamenti pertinenti.
   • Cannibalization Detection: Inserisci la Main Keyword e clicca "Ricontrolla" per verificare se altri articoli competono per la stessa query.

Grace Period e Rinnovo

Se l'abbonamento scade, hai 7 giorni di grace period per rinnovare senza perdere l'accesso. Dopo il grace period, torni automaticamente al tier FREE (3 validazioni/mese).

🔍 Cannibalization Detection (STANDARD/PRO)

La funzionalità di rilevamento cannibalizzazione identifica articoli del tuo sito che competono per la stessa query di ricerca, aiutandoti a evitare conflitti interni che possono danneggiare il ranking SEO.

Come Funziona

1. Confronto Slug-based (60% peso): Compara gli slug (URL) degli articoli usando Jaccard similarity + stemming italiano. Esempio: "consigli-auto-elettriche-inverno" vs "accessori-auto-elettriche-in-inverno-2025" → 50% similarità.
2. Confronto Keyword (40% peso): Se hai salvato la Main Keyword in entrambi gli articoli, il plugin confronta anche le keyword per maggiore precisione.
3. Soglia 45%: Gli articoli con similarità finale ≥45% vengono segnalati come potenziali conflitti.
4. Badge KEYWORD/TITOLO: Ogni conflitto mostra un badge che indica se il confronto è basato su keyword salvata (🎯 verde, più preciso) o titolo come fallback (⚠️ arancione, meno affidabile).

Ambienti Supportati

• Locale (*.local, localhost, 127.0.0.1): Usa database WordPress diretto per evitare timeout su richieste HTTP interne (loopback). Recupera automaticamente fino a 500 post recenti.
• Produzione: Parsa la sitemap XML configurata (o wp-sitemap.xml di default) con fallback automatico al database in caso di errori. Supporta sitemap index WordPress (wp-sitemap.xml → wp-sitemap-posts-post-X.xml).

Configurazione Sitemap

Vai in Bacheca → Italian SEO Validator → Settings e inserisci l'URL della tua sitemap nella sezione "Sitemap URL". Se lasci vuoto, il plugin usa automaticamente /wp-sitemap.xml (WordPress 5.5+).

WordPress Nativo (senza plugin SEO)

• Consigliata: https://tuosito.it/wp-sitemap.xml (sitemap index generata automaticamente da WordPress 5.5+)
• Diretta post: https://tuosito.it/wp-sitemap-posts-post-1.xml (più veloce, ma solo se non usi Custom Post Types per articoli)

Yoast SEO

• Consigliata: https://tuosito.it/post-sitemap.xml (sitemap dedicata ai post, parsing veloce)
• Alternativa: https://tuosito.it/sitemap_index.xml (index completo, utile se usi Custom Post Types)
• ⚠️ Non usare: wp-sitemap.xml (Yoast disabilita la sitemap nativa di WordPress)

Rank Math SEO

• Consigliata: https://tuosito.it/post-sitemap.xml (sitemap dedicata ai post)
• Alternativa: https://tuosito.it/sitemap_index.xml (index completo)
• ⚠️ Non usare: wp-sitemap.xml (Rank Math disabilita la sitemap nativa di WordPress)

SEOPress

• Consigliata: https://tuosito.it/post-sitemap.xml (sitemap dedicata ai post)
• Alternativa: https://tuosito.it/sitemaps.xml (index completo, naming varia per versione)

💡 Tip: Se non sai quale sitemap usare, visita https://tuosito.it/robots.txt per vedere quale sitemap è dichiarata. In alternativa, lascia vuoto e il plugin tenterà automaticamente /wp-sitemap.xml con fallback al database.

Prestazioni su Siti Grandi (500+ Articoli)

Il plugin è ottimizzato per blog con centinaia di articoli:

• Cache 5 minuti: Dopo il primo check, i post vengono cachati per evitare fetch ripetuti.
• Limite 500 post: Confronta i 500 articoli più recenti per bilanciare coverage e velocità.
• Jaccard similarity: Algoritmo O(n) molto veloce anche con 500 confronti.
• Zero configurazione: Funziona immediatamente anche se non hai mai validato articoli (usa titoli come fallback).

Interpretazione Risultati

Similarità	Severità	Azione Consigliata
≥70%	🔴 Critico	Cannibalizzazione grave - consolida contenuti o differenzia keyword
55-69%	🟠 Elevato	Sovrapposizione significativa - rivedi intento di ricerca
45-54%	🟡 Moderato	Possibile conflitto - verifica manualmente se articoli sono complementari
<45%	✅ OK	Nessun conflitto rilevato

Best Practice

• Usa Main Keyword sempre: Più articoli validi con keyword salvate = confronti più precisi (badge 🎯 verde).
• Non eliminare subito: Articoli con 45-55% similarità potrebbero essere complementari (es: "consigli inverno" vs "accessori inverno").
• Consolida contenuti simili: Se due articoli hanno ≥70% similarità, considera di unirli in un unico contenuto completo con redirect 301.
• Differenzia intento: Articoli simili possono coesistere se rispondono a intenti diversi (guida vs recensione vs confronto).

Limitazioni Note

• Confronto slug-based: Articoli con slug generici ("guida-2025", "migliori-prodotti") possono generare falsi positivi. Verifica manualmente.
• Solo 500 post più recenti: Blog con 1000+ articoli potrebbero avere vecchi contenuti non analizzati. La cache permette comunque di confrontare efficacemente il catalogo attivo.
• Stemming basico: Gestisce varianti morfologiche comuni (elettrica/elettriche/elettrico) ma non sinonimi (auto/macchina).