# Skill Agente Audit SEO > Uno strumento leggero di audit SEO per agenti AI come Claude Code, OpenClaw e Codex. Esegue audit SEO rapidi su singole pagine, verifica i principali problemi on-page e a livello di sito e genera un report SEO strutturato con interventi correttivi attuabili. - Canonical: https://nanoskill.ai/it/skills/seo-audit - Markdown: https://nanoskill.ai/it/skills/seo-audit.md - Author: JeffLi1993 - Published: 2026-05-11T01:05:35.771Z - Updated: 2026-07-25T04:34:17.896Z - Language: it - Source type: github - Popularity signal: 382 ## Sources - https://github.com/JeffLi1993/seo-audit-skill ## Install ```shell npx skills add JeffLi1993/seo-audit-skill ``` ## About SEO Audit è una skill agente di audit SEO leggera per agenti di codifica AI come Claude Code, OpenClaw e Codex. Aiuta un agente a ispezionare un singolo URL, verificare i principali problemi SEO e generare un report di audit strutturato con prove, impatto e correzioni consigliate. La skill si concentra su controlli SEO di primo passaggio, inclusi tag title, meta description, tag H1, tag canonical, testo alternativo delle immagini, posizionamento delle parole chiave, robots.txt, sitemap.xml, gestione degli errori 404, canonicalizzazione degli URL, pagine di fiducia E-E-A-T e convalida dello schema JSON-LD. Usala quando hai bisogno di un rapido controllo dello stato SEO prima di pubblicare una pagina, rivedere una landing page, diagnosticare problemi di posizionamento di base o decidere se è necessario un audit SEO tecnico più approfondito. ## Key features - **Audit SEO Rapido per Singola Pagina**: Esegui un audit SEO veloce per qualsiasi URL e ottieni una prima visione dello stato di salute SEO della pagina senza dover configurare un crawler completo o un flusso di lavoro analitico. - **Controlli SEO On-Page di Base**: Controlla title tag, meta description, tag H1, tag canonical, testo alternativo delle immagini, struttura delle intestazioni, posizionamento delle parole chiave, link interni e conteggio delle parole. - **Fondamenti SEO a Livello di Sito**: Esamina i segnali SEO fondamentali come robots.txt, sitemap.xml, gestione 404, canonicalizzazione URL, i18n / hreflang e pagine di fiducia E-E-A-T. - **Validazione Schema JSON-LD**: Rileva se la pagina ha i dati strutturati corretti, convalida i tipi di schema comuni e segnala campi JSON-LD mancanti o incompleti. - **Report di Audit SEO Strutturato**: Genera un report di audit SEO pulito con stati superato, avviso e non superato, oltre a prove, impatto e correzioni specifiche per ogni problema importante. ## Use cases - **Auditare una Landing Page Prima della Pubblicazione**: Usa questa skill prima di lanciare una homepage, una pagina prodotto, una pagina strumento o una landing page SEO per individuare tempestivamente i problemi SEO di base. - **Esegui un Controllo Rapido dello Stato di Salute SEO**: Controlla se una pagina ha il titolo, la meta description, l'H1, il tag canonical, lo schema, i link interni e altri segnali SEO di base corretti. - **Revisiona Pagine Esistenti con Problemi di Posizionamento**: Usalo quando una pagina è indicizzata ma non si posiziona bene, o quando vuoi identificare rapidamente problemi evidenti on-page e a livello di sito. ## Result preview Vedi un risultato reale di audit SEO generato da questa Skill Agente. ![seo-audit-demo](https://file.nanoskill.ai/seo-audit-demo-1.png) ![seo-audit-demo-2](https://file.nanoskill.ai/seo-audit-demo-2.png) ![seo-audit-demo-3](https://file.nanoskill.ai/seo-audit-demo-3.png) ## Result walkthrough ### Passaggio 1：Installa Aggiungi la skill al tuo agente ![seo-audit-step-1](https://file.nanoskill.ai/seo-audit-step-1.png) ### Passaggio 2：Attività di Audit Usa un URL e richiedi un audit prioritario. ![seo-audit-step-2](https://file.nanoskill.ai/seo-audit-step-2.png) ### Passaggio 3：Rivedi il risultato Ottieni correzioni SEO prioritarie su cui puoi intervenire immediatamente. ![seo-audit-step-3](https://file.nanoskill.ai/seo-audit-step-3.png) ## Skill definition # seo-audit — Audit SEO di base Una skill SEO leggera progettata per audit rapidi e predefiniti di singole pagine. Basata su OpenClaw. Adatta per controlli iniziali di una pagina o quando è necessaria una valutazione rapida senza approfondimento tecnico completo. --- ## Quando utilizzare questa skill Usare `seo-audit` quando: - L'utente dice: "fai l'audit di questa pagina", "controlla la SEO", "analizza il mio URL", "controllo SEO rapido", "cosa c'è che non va nella mia pagina" - Non viene richiesta una profondità specifica — questo è il punto di ingresso predefinito - L'utente ha bisogno di un riepilogo veloce e leggibile piuttosto che di un'analisi tecnica completa Se l'utente desidera maggiore approfondimento, passare a `seo-audit-full`: > **Suggerimento:** Per audit tecnici approfonditi, SEO on-page avanzata o report completi, usa la skill `seo-audit-full`. --- ## Input previsti | Input | Richiesto | Note | |-------|----------|-------| | URL della pagina | Sì | La pagina da sottoporre ad audit | | HTML grezzo o contenuto della pagina | Opzionale | Consente un'analisi on-page più accurata | | Dati GSC / analytics | Opzionale | Non richiesti per l'audit di base | Se viene fornito solo un URL e non sono disponibili codice sorgente o dati del crawler, dichiarare chiaramente: > **Limitazione:** Questo audit si basa solo sul contenuto visibile della pagina e su segnali disponibili pubblicamente. Codice sorgente, dati GSC, log di crawl e metriche di performance non sono disponibili per questo audit. --- ## Risultato Produrre un **Report di Audit SEO di base** compilando il template in [assets/report-template.html](assets/report-template.html), quindi **salvarlo in un file — non stampare mai l'HTML grezzo sul terminale**. **Denominazione del file:** `reports/--audit.html` ``` https://example.com/blog/best-tools → reports/example-com-blog-best-tools-audit.html https://example.com/ → reports/example-com-audit.html ``` **Dopo il salvataggio, comunicare all'utente:** ``` ✅ Report salvato → reports/example-com-audit.html Aprirlo adesso? (sì / no) ``` Se sì → eseguire: `open reports/example-com-audit.html` --- **Segnaposto del template** — compilare ciascuno indipendentemente: | Segnaposto | Contenuto | |---|---| | `{{summary_verdict}}` | Una frase: controlli totali eseguiti, quanti non superati/in avviso/superati | | `{{summary_critical_html}}` | `
  • ` per ogni elemento critico (non superato), oppure `
  • Nessuno
    • ` | | `{{summary_warnings_html}}` | `
  • ` per ogni elemento in avviso, oppure `
  • Nessuno
    • ` | | `{{summary_passing_html}}` | `
  • ` per ogni controllo superato, oppure `
  • Nessuno
    • ` | --- ## Script Eseguire questi script prima di scrivere qualsiasi risultato. Producono JSON strutturato — utilizzare il JSON direttamente come evidenza; non recuperare nuovamente gli stessi URL manualmente. **Dipendenze:** `pip install requests` (il parsing HTML usa la libreria standard di Python) ```bash # Step 1: site-level checks (robots.txt + sitemap.xml) python scripts/check-site.py https://example.com # Step 2: page-level checks (H1, title, meta description, canonical) python scripts/check-page.py https://example.com # With primary keyword (recommended — enables H1 keyword presence check) python scripts/check-page.py https://example.com --keyword "running shoes" # Optional: fetch raw page HTML for further inspection python scripts/fetch-page.py https://example.com --output page.html # Step 3: JSON-LD schema validation python scripts/check-schema.py https://example.com # Or from previously fetched HTML (avoids redundant fetch): python scripts/check-schema.py --file page.html ``` Ogni script termina con codice `0` (tutti superati/avvisi) o `1` (qualsiasi errore/non superato). **AMBITO RIGOROSO — non aggiungere alcuna verifica non elencata di seguito. Nessuna eccezione.** Controlli a livello di sito consentiti (in `{{site_checks_html}}`): - robots.txt · sitemap.xml · Gestione 404 · Canonicalizzazione degli URL · i18n / hreflang Controlli E-E-A-T consentiti (in `{{eeat_checks_html}}`): - Chi siamo · Contatti · Privacy Policy · Termini di servizio · Media/Partner (solo se presenti) Controlli a livello di pagina consentiti (in `{{page_checks_html}}`), produrre in questo ordine esatto: URL Slug · Tag Title · Meta Description · Tag H1 · Tag Canonical · Testo alternativo immagini · Conteggio parole · Posizionamento parole chiave · Struttura delle intestazioni · Link interni · Schema (JSON-LD) Logica per il Testo alternativo immagini: - Analizzare i tag dall'HTML statico - Superato: tutte le immagini hanno attributo alt non vuoto (le immagini decorative con alt="" sono OK) - Avviso: qualsiasi immagine di contenuto manca dell'attributo alt - Non verificato (stato-info): 0 immagini trovate nell'HTML statico → probabile rendering JS, impossibile verificare ⛔ REGOLA FERREA — Produrre SOLO le righe di controllo definite in report-template.html. Se un controllo non è negli elenchi consentiti sopra, NON produrlo — nemmeno se si riscontrano problemi. Nessuna eccezione. Nessun controllo "bonus". Nessuna improvvisazione. Il template è l'unica fonte di verità. Trattarlo come una whitelist rigorosa. Ancora VIETATI (appartengono a seo-audit-full): tag OG · Twitter Card · Social tags · Peso della pagina · Core Web Vitals · Robots Meta **Come utilizzare l'output JSON:** - Mappare lo `status` di ogni campo → `pass` / `warn` / `fail` / `error` direttamente nella tabella dei controlli del report - Utilizzare la stringa `detail` di ogni campo come punto di partenza per la riga Evidenza nei risultati - Non contraddire l'output dello script a meno che non si abbiano ulteriori evidenze osservabili - Separare i gruppi di controllo con `
    Etichetta
    ` all'interno di `{{site_checks_html}}`: `Crawlabilità` · `Canonicalizzazione degli URL` · `i18n / hreflang` · `Schema (JSON-LD)` e `
    Pagine di fiducia E-E-A-T
    ` prima di `{{eeat_checks_html}}` **Revisione LLM — obbligatoria quando `llm_review_required: true`:** Lo script segnala i campi che richiedono un giudizio semantico o qualitativo che non può eseguire. Non lasciare mai `llm_review_required: true` irrisolto — esprimere sempre un giudizio esplicito. **H1 — attivato quando `keyword_match == "partial"`:** ``` h1_text : (da h1.values[0]) keyword : (il --keyword passato allo script) Giudicare: Questo H1 copre semanticamente l'intento di ricerca della parola chiave? - Considerare sinonimi, varianti naturali, copertura dell'argomento - sì → declassare a "pass", annotare la variante - no → mantenere "warn" o aggiornare a "fail", spiegare la lacuna ``` **Title — attivato quando `keyword_match == "partial"` OPPURE `keyword_position != "start"`:** ``` title : (da title.value) keyword : (il --keyword passato) Giudicare: 1. Il title copre semanticamente l'intento di ricerca della parola chiave? 2. Il title è grammaticalmente corretto e naturalmente leggibile? 3. Posizione della parola chiave — applicare standard diversi per tipo di pagina: - Homepage : Brand + parola chiave principale è corretto (es. "Acme | AI Workflow Automation") NON segnalare brand-first come problema. - Pagine interne: La parola chiave principale dovrebbe essere in testa (es. "AI Workflow Automation for Teams — Acme") Segnalare se la parola chiave è sepolta a metà title senza un buon motivo. IMPORTANTE — NON segnalare come negativi: - Anni (es. "2026") → segnalano freschezza, aumentano il CTR — trattare come positivo a meno che la pagina non sia contenuto esplicitamente evergreen dove la datazione danneggerebbe la longevità. - Numeri (es. "5 best", "Top 10", "3 steps") → impostano aspettative chiare, superano costantemente i title non numerici in CTR — trattare sempre come un plus. - Qualificatori specifici ("Open-Source", "Self-Hosted", "Free") → restringono l'intento e attraggono click di qualità superiore — non penalizzare. ``` **URL Slug — attivato quando `keyword_match != "full"` o `is_homepage == false`:** ``` slug : (da url_slug.slug) keyword : (il --keyword passato) Giudicare: 1. Lo slug contiene la parola chiave primaria o una variante naturale? 2. La gerarchia del percorso è logica? (/categoria/parola-chiave è l'ideale) 3. È conciso e leggibile dall'uomo? Homepage (is_homepage: true): saltare — nessun giudizio necessario. ``` **Meta Description — sempre attivata quando il contenuto è presente:** ``` meta_description : (da meta_description.value) keyword : (il --keyword passato) Giudicare tutti e quattro: 1. Frasi complete? (1-2 frasi, senza frammenti) 2. Menziona un risultato concreto — non vuota genericità? Buono: "Riduci i tempi di progettazione del 60% con template AI" Cattivo: "Il miglior strumento per tutte le tue esigenze di design" 3. Parola chiave o sinonimo naturale usato una volta — non ripetuto in modo innaturale? 4. Più specifico di quanto scriverebbe un tipico concorrente? IMPORTANTE — NON segnalare come negativi: - Anni (es. "2026") → segnalano freschezza, migliorano il CTR per query sensibili al tempo. Notare l'anno solo se la pagina è contenuto esplicitamente evergreen dove la datazione danneggia. - Numeri (es. "5 best", "3 steps") → specificità concreta, forte segnale di CTR. - "e molto altro." finale → al massimo una nota stilistica minore, mai un Avviso o Non superato. ``` --- ## Flusso di lavoro consigliato Seguire questi passaggi in ordine: 1. **Riconoscere l'ambito** — confermare che si tratta di un audit di base; annotare eventuali dati mancanti 2. **Dedurre la parola chiave primaria** — recuperare la pagina con `fetch-page.py`, quindi determinare la parola chiave primaria: - Se l'utente ha fornito esplicitamente una parola chiave → usarla direttamente - Altrimenti → leggere l'H1, il title e il primo paragrafo della pagina, quindi dedurre la singola frase chiave target più probabile (cosa digiterebbe un utente per trovare questa pagina?) - Dichiarare la parola chiave dedotta esplicitamente prima di eseguire i controlli: > "Parola chiave primaria dedotta: **alternative open source a Claude**" 3. **Eseguire `check-site.py`** — analizzare l'output JSON per robots, sitemap, gestione 404 e canonicalizzazione degli URL **Controllo 404:** recuperare `/this-page-definitely-does-not-exist-seo-audit-check` - Restituisce 404 → Superato · Restituisce 200 (soft 404) → Non superato · Restituisce 301 alla homepage → Avviso **Controlli di canonicalizzazione degli URL** (ciascuno è un sotto-controllo separato): - **HTTP→HTTPS:** recuperare `http://` — deve restituire 301 a `https://`. Restituisce 200 → Non superato. - **Coerenza www:** recuperare sia `https://www.` che `https://` — uno deve restituire 301 all'altro. Entrambi restituiscono 200 → Avviso. - **Slash finale:** confrontare l'URL effettivamente servito con il tag canonical sulla pagina. Discrepanza → Avviso. - **Corrispondenza canonical:** l'href del tag canonical deve corrispondere esattamente all'URL finale dopo tutti i redirect. Discrepanza → Avviso. 4. **Controllo infrastruttura E-E-A-T** — per ogni pagina di fiducia sotto, verificare due livelli: - **Livello 1 — Esiste:** recuperare l'URL, controllare lo stato HTTP (200 = esiste, 404/redirect = mancante) - **Livello 2 — Raggiungibile:** recuperare l'HTML della homepage, controllare se il footer o la navigazione contengono un link a questa pagina | Pagina | Richiesto | |---|---| | Chi siamo | Sì | | Contatti | Sì | | Privacy Policy | Sì | | Termini di servizio | Sì | | Media / Partner | No — includere solo se presenti | Regole di stato: - Pagina mancante (non 200) → **Non superato** - Pagina esiste ma non linkata in footer/nav → **Avviso** - Pagina esiste e linkata in footer/nav → **Superato** - Pagina opzionale mancante → saltare, non includere la riga 5. **Eseguire `check-page.py --keyword ""`** — analizzare l'output JSON per H1, title, meta description, canonical e URL slug 6. **Controllo i18n / hreflang** — eseguire solo se la pagina contiene tag hreflang o `` suggerisce multi-lingua: - **Saltare completamente (N/D)** se non vengono trovati tag hreflang e il sito appare monolingua - Se sono presenti tag hreflang, controllare: - **Simmetria reciproca**: ogni URL referenziato deve linkare indietro a tutte le altre varianti — qualsiasi link interrotto = Non superato - **Codici lingua**: devono essere BCP 47 validi (es. `zh-CN` non `zh`, `en-US` non `en-us`) — codice errato = Avviso - **x-default**: dovrebbe essere presente per pagine di selezione lingua o fallback — mancante = Avviso - **Attributo html[lang]**: deve corrispondere all'hreflang primario della pagina — discrepanza = Avviso - **Struttura URL**: schema raccomandato — lingua predefinita (solitamente `en`) alla radice senza prefisso, altre lingue in sottopercorsi (`/zh/`, `/es/`). - `/page` (en) + `/zh/page` + `/es/page` → Superato - `/en/page` + `/zh/page` → Avviso (il prefisso en è ridondante, spreca profondità di crawl) - Segnalare solo se lo schema è chiaramente inconsistente o en è prefissato inutilmente 7. **Eseguire `check-schema.py`** — analizzare l'output JSON per tipi di schema e validazione dei campi ```bash python scripts/check-schema.py https://example.com # O da HTML precedentemente recuperato: python scripts/check-schema.py --file page.html ``` Lo script estrae blocchi JSON-LD, valida `@type` e campi obbligatori secondo le specifiche di Schema.org. `llm_review_required: true` è sempre impostato — confermare che `inferred_page_type` corrisponda al contenuto effettivo della pagina. Tipo di pagina → `@type` previsto: | Tipo di pagina | @type previsto | Campi minimi richiesti | |---|---|---| | Homepage | WebSite + Organization | name, url, logo | | Blog / Articolo | Article o BlogPosting | headline, datePublished, author, image | | Prodotto | Product | name, image, offers (price, priceCurrency) | | FAQ | FAQPage | mainEntity[].name, acceptedAnswer.text | | How-to | HowTo | name, step[].text | | Attività locale | LocalBusiness | name, address, telephone | | Landing page generica | — | N/D — saltare, nessun tipo ampiamente supportato | - Superato: @type corretto presente, tutti i campi obbligatori validi, nessun conflitto - Avviso: @type presente ma campi raccomandati mancanti - Non superato: @type previsto completamente mancante - N/D: landing page generica — non penalizzare 8. **Riassumere i risultati** — ogni risultato deve seguire il formato Evidenza / Impatto / Correzione 9. **Azioni prioritarie** — elencare le prime 3 correzioni a più alto impatto 10. **Generare il report** — salvare in `reports/--audit.html`, quindi chiedere all'utente di aprirlo 11. **Suggerimento di upgrade** — se vengono rilevati problemi oltre l'ambito di base, suggerire `seo-audit-full` --- ## Regole per la scrittura dei dettagli del report **La cella Dettaglio nelle tabelle dei controlli deve seguire queste regole — nessuna eccezione:** **Superato → una breve frase. Nessun elenco, nessuna elaborazione.** ``` Buono: "XML urlset valido · 104 URL · referenziato in robots.txt." Cattivo: "XML urlset valido con 104 URL. Correttamente referenziato in robots.txt. I post del blog sono probabilmente indicizzati attraverso questa sitemap." ``` **Avviso → un `
    ` con ≤2 punti elenco. Un `
    ` con la correzione.** ``` Buono:
    · Title 48 caratteri — 2 sotto il minimo. · L'anno "2026" daterà la pagina.
    Espandere a 50–60 caratteri; rimuovere l'anno se evergreen.
    Cattivo: prosa di tre frasi che spiega cos'è un tag title e perché la lunghezza è importante. ``` **Non superato → come Avviso. Iniziare con il fallimento esatto. Nessuna spiegazione di background.** NON spiegare cosa sia un controllo, NON ripetere informazioni già visibili nel badge di stato, NON trattare il lettore come se non conoscesse le basi della SEO. --- ## Formato obbligatorio per i risultati Ogni risultato importante **deve** seguire questa struttura: ``` **Risultato: [Titolo del risultato]** - **Evidenza:** [Cosa è stato osservato — citazione diretta, riferimento allo screenshot o dato misurabile] - **Impatto:** [Perché è importante per la SEO o l'UX] - **Correzione:** [Raccomandazione specifica e attuabile] ``` Non scrivere conclusioni vaghe. Se l'evidenza è insufficiente, dichiarare esplicitamente le ipotesi. --- ## Suggerimento di upgrade Includere questo alla fine di ogni report di audit di base: > **Vuoi un'analisi più approfondita?** > Questo è stato un audit SEO di base che copre segnali a livello di sito e controlli on-page fondamentali. > Per SEO tecnica avanzata, punteggio di qualità dei contenuti, analisi dei dati strutturati e risultati completi basati su crawl, usa la skill `seo-audit-full`. --- ## File di riferimento - Ambito dettagliato dell'audit e definizioni dei campi: [references/REFERENCE.md](references/REFERENCE.md) - Template del report HTML finale: [assets/report-template.html](assets/report-template.html) - Script di controllo a livello di sito: [scripts/check-site.py](scripts/check-site.py) - Script di controllo a livello di pagina: [scripts/check-page.py](scripts/check-page.py) - Recuperatore di pagina grezza: [scripts/fetch-page.py](scripts/fetch-page.py) - Script di validazione schema: [scripts/check-schema.py](scripts/check-schema.py) ## FAQ ### Che cos'è una Skill di Audit SEO per Agenti? Una Skill di Audit SEO per Agenti è un flusso di lavoro riutilizzabile che aiuta un agente AI a ispezionare una pagina web, verificare i problemi SEO e generare un report di audit strutturato. Questa skill è progettata per audit SEO rapidi su singole pagine all'interno dei flussi di lavoro di Codice Claude, Apri Artiglio e Codice. ### Cosa controlla la skill di audit SEO? Controlla i segnali SEO on-page di base e quelli a livello di sito, inclusi title tag, meta description, tag H1, tag canonical, testo alternativo delle immagini, posizionamento delle parole chiave, link interni, robots.txt, sitemap.xml, gestione 404, canonicalizzazione URL, pagine di fiducia e schema JSON-LD. ### Si tratta di un audit SEO tecnico completo? No. Questo è un audit SEO leggero di primo passaggio per una singola pagina. È utile per controlli rapidi e rilevamento di problemi di base. Per audit basati su crawling, Core Web Vitals, diagnostica di indicizzazione, analisi dei log e SEO tecnico avanzato, utilizza un flusso di lavoro di audit SEO completo. ### Chi dovrebbe utilizzare questa Skill di Audit SEO per Agenti? È utile per operatori SEO, fondatori SaaS, hacker indipendenti, esperti di marketing, team di contenuti e sviluppatori che desiderano un modo rapido per controllare una pagina prima di pubblicarla o migliorarla. ### Che tipo di report genera? Genera un report di audit SEO strutturato con stati di superato, avviso e non superato. I risultati importanti includono prove, impatto SEO e correzioni specifiche, rendendo il report più facile da consegnare a sviluppatori o team di contenuti. ### Può auditare qualsiasi URL? Sì, può eseguire l'audit di un URL pubblico basandosi sul contenuto visibile della pagina e sui segnali SEO pubblicamente disponibili. Se il codice sorgente, i dati GSC, i dati analitici, i log di crawl o i dati sulle prestazioni non sono disponibili, il report dovrebbe indicare chiaramente tali limitazioni. ### In cosa è diverso da una normale checklist SEO? Una normale checklist SEO ti dice cosa revisionare. Questa Skill di Audit SEO per Agenti fornisce a un agente AI un processo ripetibile per eseguire controlli, interpretare i risultati e produrre un report strutturato con prove e correzioni. ### Quando dovrei utilizzare invece un audit SEO completo? Utilizza un audit SEO completo quando hai bisogno di un'analisi tecnica più approfondita, crawling a livello di sito, Core Web Vitals, controlli di indicizzazione, revisione della qualità dei contenuti, architettura dei link interni, analisi dei log o diagnostica avanzata del posizionamento.