Claude Code per la SEO: Come Ho Automatizzato l'Ottimizzazione di un Intero Sito

LCP da 5.5 secondi a 1.4 secondi. Performance score da 67 a 97. 21 blog post con zero link interni fixati in un pomeriggio. Questo è quello che Claude Code ha fatto per la SEO di giovanniliguori.it in 3 settimane. Non è teoria — è il caso studio del sito che stai leggendo.

Se lavori sulla SEO di un sito e stai ancora ottimizzando tutto a mano — schema markup, internal linking, meta tag, structured data — questo articolo ti mostra un approccio diverso. Claude Code non sostituisce la strategia SEO. La esegue alla velocità che un essere umano non può raggiungere.

Cos'è Claude Code e perché cambia il gioco per la SEO

Claude Code è lo strumento a riga di comando di Anthropic che permette di delegare task di sviluppo direttamente al terminale. Non è un chatbot: è un agente che legge il tuo codebase, capisce la struttura del progetto, scrive codice, lo testa e lo committa. Per la SEO tecnica, questo significa che puoi descrivere un problema ("il mio LCP è 5.5 secondi su mobile") e Claude Code analizza il codice, identifica il bottleneck e implementa la fix.

La differenza rispetto a un consulente SEO tradizionale è la velocità di esecuzione. Un audit tecnico SEO con 15 fix da implementare richiede tipicamente 2-4 settimane di lavoro developer. Con Claude Code, lo stesso lavoro viene completato in 2-3 giorni. Non perché l'AI sia "magica", ma perché elimina il ciclo audit → ticket → sviluppo → review → deploy. Claude Code fa tutto in sequenza, nel tuo repo, con commit verificabili.

Per una guida completa alle funzionalità di Claude Code, ho scritto una guida dettagliata per developer e automatori che copre setup, comandi e workflow avanzati.

Il caso studio: come Claude Code ha ottimizzato la SEO di giovanniliguori.it

A marzo 2026, giovanniliguori.it aveva un problema serio: 540 impressioni totali in 3 mesi su Google Search Console, 25 click totali, e un solo articolo che generava il 70% del traffico. L'audit tecnico ha rivelato una lista di problemi: LCP 5.5s su mobile, H1 mancanti su 2 pagine chiave, zero schema FAQPage sui blog post, 55% degli articoli senza link interni, zero link esterni sui top 5 post, e meta robots non ottimizzato per Google.

Il sito è costruito su Next.js 15 + Sanity v3, hostato su Vercel. Lo stack tecnico era già solido — il problema era nell'ottimizzazione SEO del codice e dei contenuti. Ho deciso di usare Claude Code per eseguire tutti i fix tecnici sul codebase e Claude Cowork (con il Sanity MCP) per i fix sui contenuti.

Fix 1: LCP da 5.5s a 1.4s

Il Largest Contentful Paint era il P0 assoluto. Google usa il LCP come Core Web Vital per il ranking mobile, e 5.5 secondi è nella zona rossa. Claude Code ha analizzato il componente Hero della homepage, identificato che l'immagine non aveva priority né fetchpriority="high", le animazioni GPU (glow orbs) consumavano risorse, e il CSS non era ottimizzato per il critical path. In 3 iterazioni ha: aggiunto priority + preload sull'immagine LCP, rimosso gli effetti GPU non necessari, convertito le immagini in WebP con dimensioni esatte, e implementato il lazy loading su tutto il below-the-fold. Risultato: LCP 1.4s, Performance score 97 su PageSpeed Insights.

Fix 2: Schema markup completo (FAQPage, Product, HowTo)

Claude Code ha creato un sistema di schema markup dinamico in structured-data.ts con 5 builder: buildFaqSchema (estrae FAQ dal body Sanity), buildProductSchema (per /claude-mastery con prezzi dinamici), buildHowToSchema (per tutorial step-by-step), buildBreadcrumbSchema, e un entity graph completo con Person + ProfessionalService + WebSite. Il sistema è completamente automatico: se un blog post ha un H2 "Domande Frequenti" con H3 sotto, lo schema FAQPage viene generato senza intervento. Se un post ha heading "Step N:", viene generato lo schema HowTo.

Fix 3: Internal linking batch su 21 post

Questo fix è stato eseguito con Claude Cowork + Sanity MCP, non con Claude Code sul repo. Il 55% dei blog post (21 su 38) aveva zero link interni — un segnale molto negativo per la topical authority. In un pomeriggio, ho usato Cowork per aggiungere a ogni post 2 link: 1 al pillar article del cluster di appartenenza e 1 a una pagina di conversione (/claude-mastery o /prenota). Il lavoro che avrebbe richiesto 4-5 ore manuali su Sanity Studio è stato completato in circa 90 minuti.

Fix 4: Meta robots, sitemap e GEO compliance

Claude Code ha implementato in batch: googleBot meta con max-image-preview:large (critico per AI Overview e Featured Snippets), sitemap con priorità ricalibrate (servizi 0.9, case study 0.8, blog 0.7, legal 0.3), robots.txt con blocco di 9 AI crawler (GPTBot, PerplexityBot, etc.), citation meta tag su tutti i blog post, e endpoint /llms.txt + /llms-full.txt per la Generative Engine Optimization. Il tutto verificato con 22 checkpoint GEO soddisfatti.

Come usare Claude Code per la SEO: guida step-by-step

Ecco il processo esatto che ho seguito. Puoi replicarlo sul tuo sito Next.js, Nuxt, Astro o qualsiasi framework moderno.

Step 1: Esegui un audit SEO tecnico come baseline

Prima di toccare il codice, misura tutto. PageSpeed Insights per Core Web Vitals (LCP, FID, CLS), Google Search Console per impressioni, click e posizioni, e un crawl con Screaming Frog o simile per trovare H1 mancanti, link rotti, pagine thin. Salva tutti i numeri: sono il tuo baseline. Senza baseline, non puoi dimostrare che Claude Code ha fatto la differenza.

Step 2: Crea un file CLAUDE.md con le istruzioni SEO

Claude Code legge il file CLAUDE.md nella root del progetto come contesto. Inserisci: lo stato attuale del sito (numeri da GSC), i fix da implementare in ordine di priorità, i file chiave da modificare, e le regole da rispettare (non toccare X, non rimuovere Y). Più il brief è specifico, migliore è l'output. Il mio CLAUDE.md per la SEO era lungo circa 200 righe e includeva ogni fix con criteri di accettazione.

Step 3: Lancia Claude Code con task atomici

Non chiedere a Claude Code di "ottimizzare la SEO del sito". È troppo vago. Dai task specifici: "Riduci il LCP della homepage sotto 2.5s ottimizzando il componente Hero in src/components/sections/", oppure "Aggiungi schema FAQPage dinamico ai blog post in src/app/(site)/blog/[slug]/page.tsx, estraendo le FAQ dal body Sanity". Un task alla volta, verificando il risultato prima di passare al successivo. Claude Code fa commit per ogni fix — puoi fare revert se qualcosa non funziona.

Step 4: Verifica ogni fix con strumenti reali

Dopo ogni deploy, verifica: PageSpeed Insights per i Core Web Vitals, Google Rich Results Test per gli schema markup, e un'ispezione manuale del network tab per verificare che le risorse si carichino nell'ordine corretto. Claude Code è bravo ma non infallibile — la verifica umana resta essenziale, soprattutto per i structured data dove un errore di sintassi invalida l'intero schema.

Step 5: Monitora i risultati su GSC per 4 settimane

Google impiega 2-4 settimane per recrawlare e riindicizzare le pagine modificate. Non aspettarti risultati immediati. Il mio calendario di monitoraggio: check settimanale su impressioni e click (GSC), check bisettimanale su posizioni keyword, e check mensile su Core Web Vitals e referring domains. Se dopo 4 settimane non vedi miglioramenti, il problema probabilmente non è tecnico ma di authority (backlink) o contenuto.

Risultati misurati: prima e dopo Claude Code SEO

Ecco i numeri reali [misurato su giovanniliguori.it, periodo: 24 marzo - 5 aprile 2026, fonte: PageSpeed Insights + Google Search Console].

Performance: LCP da 5.5s a 1.4s (-75%), Performance score da 67 a 97, FCP da 2.8s a 1.1s, CLS da 0.12 a 0. SEO tecnica: Lighthouse SEO score stabile a 100, schema markup attivi su tutti i post (Article, FAQ, HowTo, Breadcrumb), H1 presente su tutte le pagine, sitemap con lastmod reali e priorità calibrate.

Contenuti: 21 post con link interni aggiunti (da 0 a 2 ciascuno), 5 top post con link esterni autorevoli (McKinsey, Gartner, Anthropic, n8n, Zapier), 1 post espanso da 1.678 a 3.000+ parole. Il pillar article ha avuto un refresh completo il 1 aprile — i risultati sul ranking sono attesi per metà aprile.

Avvertenza epistemica: i fix tecnici (LCP, schema, meta) hanno effetto misurabile entro 2-4 settimane. I fix di contenuto (link interni, espansione post) richiedono 4-8 settimane per mostrare impatto sulle posizioni. I numeri completi di impatto SEO saranno disponibili a fine aprile 2026. Aggiornerò questo articolo con i dati definitivi.

Claude Code SEO vs ottimizzazione manuale: quando conviene

Claude Code non è la soluzione per tutto. È eccellente per fix tecnici ripetitivi e strutturali: schema markup, meta tag, performance optimization, heading hierarchy, sitemap, robots.txt. Sono task dove il pattern è chiaro, il codice è nel repo, e i criteri di successo sono oggettivi.

Non è (ancora) lo strumento giusto per: keyword research strategica, analisi dell'intento di ricerca, decisioni editoriali su quale contenuto creare, e valutazione della qualità E-E-A-T. Queste richiedono giudizio umano, conoscenza del mercato e comprensione del pubblico. Il mio approccio: strategia e decisioni le faccio io, esecuzione tecnica la delego a Claude Code. Il risultato è che in 3 settimane ho completato un audit tecnico che normalmente avrebbe richiesto 2-3 mesi.

Se vuoi capire come Claude AI si integra in un workflow completo di business automation, la guida completa a Claude AI per freelancer e PMI copre tutti gli aspetti — dalla SEO al CRM, dalla gestione clienti alla produzione di contenuti.

Per vedere il contesto completo dell'ecosistema di automazioni che ha generato questi risultati, ho documentato l'intero percorso nel case study delle 21 automazioni Claude.

Strumenti e risorse per Claude Code SEO

Per replicare questo approccio, servono: Claude Code (disponibile con il piano Pro o Max di Anthropic), un sito su framework moderno (Next.js, Nuxt, Astro), accesso a Google Search Console, e PageSpeed Insights per la verifica. Per i fix sui contenuti via CMS, Claude Cowork con MCP Server è il complemento ideale. La documentazione Google Search Central resta il riferimento definitivo per i criteri tecnici SEO.

Domande Frequenti su Claude Code e SEO

Claude Code può fare keyword research?

No, non direttamente. Claude Code opera sul codebase, non ha accesso a tool di keyword research come Ahrefs o SEMrush. Può però implementare ottimizzazioni on-page una volta che hai definito le keyword target. Il mio workflow: faccio keyword research manualmente con GSC e tool dedicati, poi delego l'implementazione tecnica a Claude Code.

Funziona solo con Next.js o con qualsiasi framework?

Claude Code funziona con qualsiasi codebase: Next.js, Nuxt, Astro, WordPress (con accesso al codice PHP/tema), siti statici, e qualsiasi altro framework. La qualità dell'output dipende dalla chiarezza delle istruzioni, non dal framework. Per CMS headless come Sanity, Contentful o Strapi, il fix tecnico va sul codice frontend mentre i fix di contenuto passano dalle API del CMS.

Quanto tempo serve per vedere i risultati SEO dopo i fix con Claude Code?

I fix tecnici (Core Web Vitals, schema markup) vengono recepiti da Google in 2-4 settimane. I fix di contenuto (internal linking, espansione articoli) richiedono 4-8 settimane. I backlink hanno un impatto che si misura in 2-3 mesi. Nel mio caso, il miglioramento su PageSpeed è stato immediato (verificabile al deploy), mentre l'impatto sul ranking è in corso di misurazione.

Claude Code può danneggiare il mio sito o la mia SEO?

Come qualsiasi tool che modifica il codice, il rischio esiste se non verifichi l'output. Claude Code fa commit su git — puoi sempre fare revert. Il mio consiglio: lavora sempre su un branch separato, verifica ogni fix con PageSpeed e Rich Results Test prima di mergiare, e fai deploy su preview prima di andare in produzione. In 35+ iterazioni sul mio sito, ho dovuto fare revert solo 2 volte, entrambe per conflitti CSS minori.

Serve sapere programmare per usare Claude Code per la SEO?

Serve una comprensione base di come funziona un progetto web: cos'è un repo git, come fare deploy, come leggere un file di configurazione. Non serve saper scrivere codice — quello lo fa Claude Code. Ma serve capire cosa stai chiedendo e come verificare che il risultato sia corretto. Se non hai esperienza tecnica, il percorso migliore è partire dalla Claude Mastery che include workflow guidati per non-developer.