AI SEO Pilot

AI SEO Pilot è un plugin WordPress costruito per l’AI Engine Optimization (AEO) — chiamata anche Generative Engine Optimization (GEO). Mentre la SEO tradizionale punta ai dieci link blu di Google, l’AEO punta al modo in cui i large language model recuperano, citano e riassumono i tuoi contenuti dentro ChatGPT, Perplexity, Claude, Gemini e la nuova generazione di esperienze di ricerca basate su AI.

Il plugin include tutto il necessario per rendere un sito WordPress leggibile dalle macchine e degno di citazione: un generatore di llms.txt, output JSON-LD secondo Schema.org, scoring di qualità del contenuto su scala 0–100, tracking delle focus keyword, sitemap ottimizzate per l’AI e un pannello di analytics in tempo reale che monitora GPTBot, ClaudeBot, PerplexityBot, GoogleOther e qualunque crawler custom tu voglia tracciare.

Punti di forza

• Generazione di llms.txt — file machine-readable, auto-generato o scritto a mano, che dice ai crawler AI di cosa parla il tuo sito e quali contenuti privilegiare.
• JSON-LD Schema.org — markup Organization, Breadcrumb e WebSite con link sameAs ai profili social, così i sistemi AI risolvono la tua brand entity.
• Scoring di qualità del contenuto — ogni post e pagina viene valutato su scala 0–100 attraverso dieci check configurabili, tarati sul retrieval AI.
• Tracking & analytics dei bot AI — dashboard a 30 giorni che monitora GPTBot, ClaudeBot, PerplexityBot, GoogleOther e bot custom, con medie giornaliere e score di salute del crawl.
• Gestione focus keyword — traccia le keyword target nella libreria, rileva la cannibalizzazione tra post in competizione e suggerisce come risolverla.
• Multi-provider AI — backend pluggable che supporta OpenAI, Anthropic, Google Gemini, DeepSeek e Ollama (self-hosted).
• Sitemap ottimizzate per l’AI — sitemap XML costruite ad hoc per esporre agli LLM le pagine che vale la pena crawlare.
• UI multilingua — traduzioni in italiano, inglese, spagnolo, tedesco e francese incluse nel plugin.

Requisiti

La chiave di licenza serve per attivare le feature di analisi, ottimizzazione e tracking. L’output strutturale (llms.txt, JSON-LD, sitemap) si configura anche senza un provider AI, ma scoring del contenuto e suggerimenti di riscrittura dipendono da un backend LLM.

Installazione

1. Scarica il file ZIP di AI SEO Pilot dal tuo account Slotix.
2. In WordPress, vai su Plugin → Aggiungi nuovo → Carica plugin.
3. Seleziona il file ZIP e clicca Installa ora.
4. Clicca Attiva plugin al termine dell’upload.
5. Un nuovo menu top-level, AI SEO Pilot, compare nella sidebar admin.
6. Apri AI SEO Pilot → Impostazioni → Generale e incolla la chiave di licenza.
7. Abilita i moduli che vuoi usare: markup Schema.org, Content Analyzer, AI Visibility tracking e AI Sitemap.
8. Passa alla tab AI Providers, scegli un provider, incolla l’API key, seleziona un modello e clicca Test Connection.

Al primo salvataggio il plugin crea un endpoint virtuale /llms.txt e la sitemap XML, entrambi raggiungibili dal frontend senza configurare il web server.

Configurazione

Tutta la configurazione è sotto AI SEO Pilot → Impostazioni, organizzata in sei tab.

Generale

La tab Generale contiene i master switch. Attivando la licenza si sbloccano i moduli di analisi e tracking; ogni feature è togglabile in modo indipendente, così puoi distribuire il plugin gradualmente su un sito esistente.

• Chiave di licenza — valida l’installazione e abilita le feature online.
• Markup Schema.org — attiva o disattiva l’iniezione JSON-LD su tutto il sito.
• Content Analyzer — abilita la meta box di scoring sui singoli post.
• AI Visibility tracking — inizia a loggare gli hit dei bot AI.
• AI Sitemap generation — espone la sitemap ottimizzata per l’AI.

AI Providers

Scegli il backend LLM usato dal Content Analyzer e dall’assistente di riscrittura.

Ogni provider richiede la sua API key (o un endpoint URL locale per Ollama). Il pulsante Test Connection valida le credenziali e elenca i modelli disponibili sull’account.

Content Analysis

La tab Content Analysis è dove definisci cosa significa “pronto per l’AI” sul tuo sito.

• AI-Ready Threshold — score complessivo minimo (0–100%) per considerare un post pronto al consumo AI. I post sotto soglia vengono segnalati nella dashboard.
• Dieci check configurabili — ogni check ha il proprio toggle, peso (0–20) e soglia:
  1. Direct Answers — il post contiene risposte concise nei primi paragrafi?
  2. Q&A Structure — coppie domanda/risposta esplicite, che gli AI engine amano citare.
  3. Definitions — definizioni in una sola frase, chiare, per le entità chiave.
  4. Paragraph Length — paragrafi brevi e scansionabili.
  5. Lists — presenza di liste puntate o numerate.
  6. Entity Density — named entity per 100 parole.
  7. Citable Statistics — dati quantitativi con fonte.
  8. Semantic Completeness — copertura dei sottotopic attesi per la focus keyword.
  9. Snippet Optimization — formattazione che mappa sui pattern dei featured snippet.
  10. Freshness Signals — marker di attualità e timestamp di aggiornamento.
• Tono di default — Autorevole, Conversazionale, Tecnico o Semplificato. Il tono guida i suggerimenti di riscrittura AI.

llms.txt

Sono supportate due modalità.

• Auto-generate — il plugin assembla llms.txt partendo da metadata del sito, pagine top-level, tassonomie chiave e i post più citati. Viene ricostruito a ogni modifica del contenuto.
• Manual — una sola textarea in cui incollare un file scritto a mano. Utile quando ti serve controllo editoriale totale o quando syndicate contenuto da un’altra piattaforma.

L’endpoint è servito a https://<tuo-sito>/llms.txt indipendentemente dalla struttura dei permalink.

Schema Markup

Abilita individualmente:

• Organization — logo, ragione sociale, contatto e URL social sameAs (Twitter/X, LinkedIn, YouTube, GitHub, Facebook, Instagram, Mastodon, ecc.).
• Breadcrumb — BreadcrumbList automatica derivata dalla gerarchia del sito.
• WebSite — entità root WebSite con SearchAction per la ricerca sitelinks.

Tutto il JSON-LD viene iniettato nel <head> della pagina e supera il Rich Results Test di Google e il validatore ufficiale Schema.org.

AI Bots Tracking

• Retention — conserva gli hit grezzi da 7 a 365 giorni. I totali giornalieri aggregati sono conservati a tempo indeterminato.
• Bot integrati — GPTBot, ChatGPT-User, ClaudeBot, anthropic-ai, PerplexityBot, Perplexity-User, Google-Extended, GoogleOther, Applebot-Extended, Bytespider, CCBot, OAI-SearchBot e altri.
• Bot custom — aggiungi un qualsiasi frammento di User-Agent, dagli un nome visibile e raggruppalo sotto un servizio (per esempio “Internal QA crawler”).

Utilizzo

Una volta configurato il plugin, l’uso quotidiano ruota attorno a tre superfici: la Dashboard, la schermata Content Quality e la meta box nell’editor dei post.

Dashboard

La Dashboard è la landing page in AI SEO Pilot → Dashboard. Riassume la prontezza AI complessiva del sito, l’ultima attività dei bot AI e i post sotto l’AI-Ready Threshold.

Usala per la review settimanale:

• individua cali della qualità media del contenuto;
• controlla che GPTBot, ClaudeBot e PerplexityBot stiano ancora crawlando ai ritmi attesi;
• salta diretto nella coda di post da migliorare.

Content Quality

La schermata Content Quality esegue una scansione batch su ogni post e pagina e li elenca ordinati per score.

Da questa lista puoi:

• filtrare per tipo di post, stato, soglia o check fallito;
• lanciare l’analyzer in bulk sugli elementi selezionati;
• cliccare su una riga per vedere il dettaglio per check e i suggerimenti di riscrittura generati dall’AI.

Pagina SEO Check

AI SEO Pilot → SEO Check esegue un audit sito-wide e dà un voto da A a F, con quattro contatori KPI (Passed, Failed, Warnings, Total checks) e una lista per sezione di check raggruppati sotto Content, Content Optimization, Technical e AI SEO.

Ogni riga stampa un titolo, una spiegazione di una riga e un badge di stato. Le righe in fail espongono azioni contestuali di fix (apri il post coinvolto, ri-analizza con l’AI, genera un’entità mancante come llms.txt o la AI sitemap), così un passaggio tipico nel report risolve gran parte dei problemi senza uscire dalla pagina. Gli stessi indicatori e contatori sono replicati nel widget della dashboard di WordPress.

Content Optimization (feature AI per i contenuti)

La tab Content Optimization di AI SEO Pilot → Impostazioni raggruppa le cinque feature AI sui contenuti e il tono globale:

Tutte e cinque le feature richiedono un AI provider configurato sotto AI SEO Pilot → Impostazioni → AI Providers. I risultati sono in cache e si rigenerano solo al salvataggio del contenuto o quando premi esplicitamente il pulsante di ri-analisi — il banner di avviso in fondo alla tab lo ricorda.

Focus keyword

Le focus keyword si assegnano dalla meta box. Il plugin le traccia poi nella libreria e fa emergere i conflitti dove più post competono per lo stesso termine.

Per ogni conflitto di cannibalizzazione hai:

• l’elenco degli URL in competizione;
• una raccomandazione: unire, redirezionare o differenziare;
• l’opzione di marcare il conflitto come risolto una volta agito.

LLMS (pagina llms.txt)

AI SEO Pilot → LLMS apre un editor a pagina singola per llms.txt. Espone il toggle Auto-generate / Manual, un’anteprima live del file corrente e l’URL pubblico su cui è servito (https://<tuo-sito>/llms.txt).

In modalità auto il plugin ricostruisce il file a ogni modifica del contenuto; in modalità manual la textarea che vedi è esattamente ciò che l’endpoint serve. Lo stesso file è referenziato dalla sezione AI SEO del report SEO Check ed è uno dei check che il widget della Dashboard etichetta come llms.txt.

Tab AI Bots

Apri AI SEO Pilot → AI Bots per esaminare l’attività dei crawler nella finestra di retention. Pattern utili da osservare:

• Un nuovo bot che appare — l’ecosistema AI cresce di mese in mese.
• Un calo di GPTBot o ClaudeBot — di solito significa che llms.txt o robots.txt li sta bloccando, oppure che il sito ha restituito errori 5xx.
• Un’impennata di ChatGPT-User o Perplexity-User — sono fetch innescati dall’utente, un indicatore anticipato di essere citati nelle risposte.

FAQ

Qual è la differenza tra SEO e AEO?

La SEO tradizionale serve a posizionarsi in una lista di dieci link blu su una pagina di risultati. L’AEO — AI Engine Optimization, chiamata anche GEO, Generative Engine Optimization — serve a essere citati dentro la risposta generata da un large language model. Condividono i fondamentali (HTML pulito, markup semantico, pagine veloci) ma l’AEO dà più peso a structured data, pattern Q&A espliciti, statistiche citabili e un indice machine-readable del sito (llms.txt).

AI SEO Pilot va in conflitto con Yoast SEO, Rank Math o All in One SEO?

No. AI SEO Pilot è focalizzato sul lato AEO e non tocca meta title, meta description o URL canonici. Puoi tenere il tuo plugin SEO tradizionale. Se il tuo plugin SEO emette già JSON-LD Organization o WebSite, puoi disabilitare quei tipi in AI SEO Pilot per evitare duplicazioni.

Devo portare la mia API key?

Sì. AI SEO Pilot è BYOK (bring-your-own-key) così controlli costi e data residency. Va bene qualunque provider supportato — OpenAI, Anthropic, Google Gemini, DeepSeek o una istanza Ollama locale.

Il plugin manda il mio contenuto a terze parti?

Solo quando lanci esplicitamente l’analyzer o l’optimizer, e solo verso il provider AI che hai configurato. Bot tracking, generazione JSON-LD, llms.txt e AI sitemap sono al 100% locali. Se ti serve operatività completamente on-premise, usa il provider Ollama.

Dove trovo il mio file llms.txt?

Alla root del tuo dominio: https://<tuo-sito>/llms.txt. Il plugin lo serve via route virtuale, quindi funziona con qualsiasi struttura di permalink e su installazioni multisite.

Perché il mio score di qualità del contenuto cala dopo aver editato un post?

Lo score è ricalcolato al salvataggio. Nuovi paragrafi possono aver abbassato la densità di entità o rimosso una lista che contribuiva al check Lists. Apri la meta box AI SEO Check e guarda il breakdown per check per vedere quale segnale è regredito.

Posso tracciare bot AI custom?

Sì. La tab AI Bots Tracking accetta frammenti custom di User-Agent. Fornisci il frammento, un nome visibile e un raggruppamento per servizio; le richieste corrispondenti vengono registrate da quel momento in poi.

Per quanto tempo vengono conservati i dati di tracking?

Gli hit grezzi rispettano la retention impostata (7–365 giorni). I contatori giornalieri aggregati sono conservati a tempo indeterminato, così la dashboard ha sempre contesto storico.

Il plugin è GDPR-compliant?

Il modulo di tracking logga solo hit di bot server-side, mai PII di visitatori. Niente cookie, niente localStorage, niente fingerprinting. Quando chiami un AI provider esterno valgono i suoi termini di trattamento dati.

Funziona con WPML o Polylang?

Sì. Ogni traduzione di un post è trattata come contenuto indipendente e valutata rispetto alla soglia. Il JSON-LD viene emesso per lingua. llms.txt, quando auto-generato, include tutti i locale.

Troubleshooting

La chiave di licenza dice “invalid”

• Assicurati che non ci siano spazi all’inizio o alla fine della chiave.
• Verifica che l’URL del sito coincida con quello registrato sul tuo account Slotix.
• Se hai spostato il sito, disattiva prima la licenza sul vecchio dominio.

”Test Connection” fallisce nella tab AI Providers

• Verifica che l’API key sia attiva e che ci sia credito di billing.
• Controlla se il tuo host blocca l’HTTPS in uscita verso api.openai.com, api.anthropic.com, ecc. Metti il dominio del provider in whitelist.
• Per Ollama, conferma che l’endpoint sia raggiungibile dal server WordPress stesso (non solo dal tuo laptop).

llms.txt restituisce 404

• Vai su Impostazioni → Permalink e clicca Salva modifiche per fare il flush delle rewrite rule.
• Se un security plugin blocca path root sconosciuti, aggiungi /llms.txt alla sua allowlist.

Il JSON-LD non appare nel sorgente

• Conferma che il master switch Schema.org sia abilitato in Generale.
• Verifica che nessun plugin di caching stia rimuovendo i blocchi <script type="application/ld+json">.
• Alcuni plugin di ottimizzazione spostano gli script nel footer; AI SEO Pilot si aspetta il JSON-LD nel <head>.

Nessun bot appare nelle analytics

• Il modulo AI Visibility deve essere abilitato in Generale.
• Gli hit dei bot si accumulano nel tempo; aspettati 24 ore tranquille su siti a basso traffico.
• Un reverse proxy o una CDN possono riscrivere lo User-Agent. Configura la CDN per inoltrare lo header UA originale.

L’analisi del contenuto è lenta

• Le scansioni batch grandi sono paginate e girano via WP-Cron. Se WP-Cron è disabilitato sull’host, fallo partire da fuori con un cron di sistema che colpisca wp-cron.php.
• Passa a un modello più piccolo e veloce (per esempio GPT-4o-mini o Claude Haiku) per lo scoring di routine; tieni i modelli grandi per l’optimizer.

Un post resta bloccato sotto l’AI-Ready Threshold

• Apri il breakdown per check per vedere quale segnale sta fallendo.
• Usa Optimize with AI per generare una riscrittura mirata solo sui check falliti.
• Se uno specifico check non è strutturalmente applicabile al tuo contenuto (per esempio Lists su una poesia), abbassa il suo peso in Content Analysis invece di riscrivere il post.