Audit SEO completo direttamente nel terminale con il plugin Claude SEO
Un tipico audit SEO di solito si trasforma in una seccatura. Apri Ahrefs o Screaming Frog, esporti gigabyte di tabelle CSV, poi passi molto tempo a cercare di capire quali dei cinquecento errori trovati influenzano effettivamente il traffico e quali sono solo rumore. Dopodiché, devi trasferire manualmente i task nel backlog degli sviluppatori.
Recentemente mi sono imbattuto in un progetto open-source claude-seo. È un'estensione per lo strumento CLI di Claude Code che gestisce tutto il lavoro di analisi SEO di routine e fornisce una roadmap pronta all'uso direttamente nella console.
Cosa rende interessante questo strumento
Il progetto risolve il problema principale della maggior parte dei servizi SEO: non si limita a generare una montagna di metriche, ma costruisce la verifica attorno alla falsificabilità. Ogni raccomandazione nel report ha quattro campi obbligatori:
- Osservazione dalla fonte (su cosa si basa la conclusione)
- Connessione con altri task nel grafico delle dipendenze
- Criteri di verifica chiari ("come capire se l'ipotesi non ha funzionato")
- Indicatore anticipato per il monitoraggio dei risultati
All'interno del plugin lavorano 25 sottomoduli e 18 agenti specializzati. Quando esegui un audit del sito, il sistema attiva fino a 15 processi paralleli. Analizzano simultaneamente il lato tecnico, la validità dei microdati Schema.org, la qualità dei contenuti secondo le linee guida E-E-A-T e la preparazione delle pagine per le risposte AI dei motori di ricerca (GEO).
Focus sul nuovo tipo di risultati di ricerca
Lo sviluppatore del progetto si è orientato verso le linee guida attuali di Google sull'ottimizzazione AI. Lo strumento valuta la citabilità dei blocchi di testo (lo snippet ideale è tra 134 e 167 parole con una risposta completa alla domanda), la densità di attribuzione dei fatti e la presenza del brand su piattaforme esterne come Reddit, YouTube e LinkedIn.
Allo stesso tempo, l'autore sfata apertamente i miti popolari. Basandosi sulle fonti primarie, il plugin tiene conto del fatto che il file robots.txt attualmente non influenza le citazioni Google, non è richiesta la suddivisione artificiale dei contenuti in chunk e riscrivere i testi per keyword AI è inutile — i motori di ricerca comprendono bene i sinonimi.
Cosa sa fare il plugin in pratica
Lo strumento aggiunge 32 comandi all'interfaccia di Claude Code. Ecco le aree principali di lavoro:
Audit rapido e analisi tecnica
Il comando /seo audit https://example.com esegue un controllo parallelo dell'intero sito. Se hai bisogno di un'analisi di una singola pagina, il comando /seo page ti fornisce una sezione esatta di heading, meta tag e struttura. Le metriche tecniche vengono verificate tramite /seo technical — traccia i Core Web Vitals (LCP, INP, CLS) senza parametri obsoleti come FID.
Validazione Schema.org
Usando /seo schema, puoi trovare i blocchi JSON-LD esistenti, verificarne la correttezza e generare immediatamente il markup mancante. Il plugin è a conoscenza della deprecazione dei rich results per FAQ e HowTo, quindi non suggerirà di sprecare tempo su tipi di schema obsoleti.
SEO locale e marketplace
I comandi /seo local e /seo maps analizzano i segnali del Google Business Profile, la consistenza di indirizzo e numero di telefono (NAP) tra le directory e il sentiment delle recensioni. Per proteggere i siti dalle penalità per doorway page, il plugin ha limiti integrati sul numero di pagine geo.
Come installare ed eseguire
Lo strumento richiede Claude Code CLI e Python 3.10 o versione successiva. Il plugin viene installato con un singolo comando all'interno di Claude Code:
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup
Il comando /seo setup crea un ambiente Python isolato nella cartella del plugin e scarica Chromium per Playwright. I pacchetti globali non vengono installati nel sistema.
Se preferisci uno script bash normale:
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh
Dopo l'installazione, puoi chiamare immediatamente i comandi:
# Запустить аудит сайта
/seo audit https://mysite.com
# Проверить разметку Schema
/seo schema https://mysite.com/product/123
# Оценить готовность контента к AI-выдаче
/seo geo https://mysite.com/blog/article
Lavorare con API ed estensioni
La funzionalità di base del plugin funziona localmente e gratuitamente. Non servono chiavi API per parsare le pagine e costruire i report. Ma se colleghi le chiavi Google, si aprono possibilità aggiuntive:
- Al livello base (chiave API), vengono recuperati i dati reali di PageSpeed Insights e le tendenze CrUX su 25 settimane.
- Collegando OAuth o un service account, si aggiunge l'integrazione con Google Search Console e Indexing API.
- Collegare GA4 fornisce analisi del traffico organico e delle landing page.
- Per gli sviluppatori, è disponibile la connessione all'API di Google Ads per stimare il volume della domanda di ricerca.
Inoltre, sono supportati server MCP esterni: Ahrefs, DataForSEO, Firecrawl, Unlighthouse e SE Ranking.
Dove lo strumento tornerà utile
- Team di sviluppo interno e SEO. Comodo da eseguire
/seo auditun giorno prima dello sprint o prima di un rilascio per catturare canonical rotti, problemi di hydration su Next.js o markup errato. - Freelancer. Durante una chiamata con il cliente, puoi assemblare un report Markdown completo con punteggi da 0 a 100 e una lista chiara di correzioni in 10 minuti.
- Agenzie. Invece di compilare manualmente report trimestrali, puoi configurare un'esecuzione settimanale dello script e tracciare le regressioni usando il modulo
/seo drift.
Limitazioni e punti deboli
Lo strumento non è perfetto. Su pagine con Client-Side Rendering (CSR) pesante o hydration complicata che dipende dallo scroll dell'utente, il renderer headless a volte perde contenuto, creando falsi positivi. In questi casi, l'autore consiglia di eseguire il sub-agente seo-visual e confrontare il suo snapshot con il render HTML grezzo.
Il secondo punto — senza API esterne a pagamento (Ahrefs o DataForSEO), non otterrai un'analisi completa dei backlink dei competitor. Il plugin eccelle negli audit On-Page e tecnici, ma i dati Off-Page sono limitati a fonti gratuite come Bing o Common Crawl.
claude-seo è un buon esempio di come gli agenti LLM possano semplificare l'analisi di routine. Il progetto è distribuito sotto licenza MIT, il codice è completamente aperto e il plugin non invia i tuoi dati a server di terze parti. Se usi Claude Code nel tuo lavoro quotidiano e ti occupi di sviluppo web in qualsiasi modo, installare e testare questo strumento vale sicuramente la pena.
Progetti correlati