Home » Blog » Claude Code » Come creare una skill Claude per la keyword research con dati reali di volume e difficoltà

Come creare una skill Claude per la keyword research con dati reali di volume e difficoltà

·

·

Una skill Claude per la keyword research è una cartella di istruzioni riutilizzabili, raccolte in un file chiamato SKILL.md, che insegna a Claude a svolgere la ricerca delle parole chiave sempre con lo stesso metodo: dalle seed keyword all’espansione, dalla classificazione per intento ai cluster, fino a un file finale ordinato per priorità.

Una skill Claude per la keyword research è una cartella di istruzioni, raccolte in un file chiamato SKILL.md, che insegna a Claude a fare la ricerca delle parole chiave sempre nello stesso modo. Si parte da poche seed keyword e si arriva a un file ordinato per priorità, con volumi, difficoltà, intento e cluster già compilati.

Torna utile soprattutto a chi segue più siti, come consulenti SEO, content writer e agenzie: il metodo si scrive una volta sola e Claude lo richiama da solo quando serve, senza doverlo rispiegare a ogni conversazione. C’è però un limite da conoscere subito. Il modello non sa quante ricerche mensili ha una query e, se lo chiede a memoria, tira a indovinare; per questo la skill va abbinata a uno strumento SEO collegato, come Ubersuggest, Semrush, Ahrefs o DataForSEO, che fornisce i numeri veri.

Costruirne una richiede meno tempo di quanto sembri. Si mette per iscritto il metodo che si usa già, si collega la fonte dei dati, si fissano i criteri di priorità e si prova la skill su qualche keyword già studiata a mano, correggendo le istruzioni finché il file prodotto coincide con quello che si consegnerebbe a un cliente.

Cos’è una skill Claude per la keyword research?

Una skill Claude per la keyword research è un insieme di istruzioni salvate in una cartella, con un file SKILL.md al centro, che descrive passo dopo passo come Claude deve cercare, valutare e organizzare le parole chiave di un sito.

La keyword research, la ricerca sistematica delle parole chiave su cui costruire i contenuti, segue di solito una sequenza ricorrente. Si parte da alcuni termini di base, si allarga l’elenco con varianti e domande, si raccolgono le metriche, si classificano le query per intento e si raggruppano in temi. Una skill trasforma questa sequenza in una procedura scritta, che Claude ripete identica ogni volta.

Chi usa Claude AI senza skill deve rispiegare il metodo a ogni conversazione; con una skill dedicata basta indicare la keyword di partenza e il sito.

Le funzioni tipiche di una skill per la keyword research sono le seguenti:

  • partire da una seed keyword o dal dominio di un concorrente ed estrarre termini correlati, domande e posizionamenti
  • raccogliere volume di ricerca, keyword difficulty e costo per clic da uno strumento collegato
  • classificare le query per intento e raggrupparle in cluster tematici, con pagine principali e pagine di supporto
  • consegnare il risultato in un formato stabile, come una tabella, un foglio di calcolo o un file CSV.

Il valore della skill sta nella coerenza: due ricerche fatte a distanza di mesi producono file confrontabili, con le stesse colonne e gli stessi criteri.

Che differenza c’è tra skill, connettore MCP e prompt?

La skill contiene il metodo, il connettore MCP fornisce i dati e il prompt è la singola richiesta che avvia il lavoro: per una keyword research affidabile servono tutti e tre.

Il connettore si basa sul Model Context Protocol, lo standard aperto che collega Claude a servizi esterni come gli strumenti SEO. Il prompt, l’istruzione scritta in linguaggio naturale, resta il punto di contatto con il modello, ma da solo si perde alla fine della conversazione. La tabella seguente sintetizza le differenze principali.

ElementoCosa contieneRuolo nella keyword research
Skillmetodo, passaggi, formato di consegnastabilisce come si lavora
Connettore MCPaccesso a volumi, difficoltà, SERPfornisce numeri aggiornati
Promptrichiesta singola con keyword e sitoavvia la ricerca su un caso preciso

I due elementi si completano: la skill stabilisce quali dati chiedere e come usarli, il connettore li fornisce. Per questo si progettano insieme, scrivendo nella skill quale strumento interrogare e con quali parametri.

Perché una skill per la keyword research ha bisogno di dati reali?

Una skill per la keyword research ha bisogno di dati reali perché un modello linguistico non conosce i volumi di ricerca aggiornati e, se li chiede a memoria, tende a stimarli o a inventarli.

I modelli vengono addestrati su testi raccolti fino a una certa data e non hanno accesso diretto alle statistiche di Google. Se si chiede quante ricerche mensili ha una query, il modello può rispondere con un numero plausibile ma senza fondamento: è un caso tipico di allucinazioni AI, informazioni false presentate con sicurezza. In una keyword research un volume sbagliato sposta le priorità dell’intero piano editoriale.

La soluzione consiste nello scrivere nella skill una regola esplicita: i numeri arrivano solo dallo strumento collegato, e se lo strumento non restituisce un dato la cella resta vuota con la dicitura «non disponibile». Lo stesso vale per la difficoltà, che ogni piattaforma calcola con un proprio algoritmo e che quindi va sempre indicata insieme alla fonte.

Anche la ricerca web di Claude non risolve il problema, perché i volumi pubblicati online sono stime di terzi, spesso datate e riferite ad altri paesi. Il modello resta invece utile per i compiti di ragionamento: capire l’intento di una query, riconoscere sinonimi, raggruppare varianti, proporre titoli. La divisione dei compiti più efficace affida i numeri allo strumento e l’interpretazione a Claude.

Quali strumenti forniscono volume e difficoltà a Claude?

Gli strumenti che forniscono volume di ricerca e difficoltà a Claude sono le piattaforme SEO dotate di un server MCP o di un connettore, come Ubersuggest, Semrush, Ahrefs, DataForSEO e SE Ranking, affiancate da Google Search Console per i dati del proprio sito.

Ogni strumento ha un database diverso, e i volumi per la stessa keyword possono variare anche di molto da una piattaforma all’altra. Per questo conviene sceglierne uno principale e usarlo sempre nella stessa skill, così che i confronti nel tempo restino coerenti.

StrumentoCome si collegaPunto di forza
Ubersuggestconnettore dell’app Claudedati localizzati per l’Italia e costi contenuti
Semrushserver MCP ufficiale remotoampiezza del database keyword
Ahrefsserver MCP ufficiale remotodifficoltà e dati sui backlink
DataForSEOserver MCP con pagamento a consumodati grezzi via API per grandi volumi
SE Rankingserver MCP ufficialeflussi pronti anche per la visibilità nei motori AI
Google Search Consoleserver MCP di terze parti o script sull’APIquery reali per cui il sito compare già

L’accesso ai dati ha quasi sempre un costo: Semrush e Ahrefs richiedono un piano a pagamento e consumano unità o crediti API, DataForSEO si paga a consumo e Ubersuggest segue i limiti giornalieri del proprio abbonamento. Per questo la skill dovrebbe indicare quante keyword interrogare al massimo in ogni ricerca. Per un sito italiano vanno scritti anche il paese e la lingua da usare in ogni chiamata, ad esempio l’Italia e l’italiano, altrimenti alcuni strumenti restituiscono i dati degli Stati Uniti.

Come si crea una skill per la keyword research, passo dopo passo?

Creare una skill per la keyword research richiede sei passaggi: definire il metodo e il risultato atteso, collegare la fonte dei dati, scrivere il file SKILL.md, stabilire i criteri di priorità, installare la skill e provarla su casi reali.

Definire il metodo e il risultato atteso

Definire il metodo significa scrivere, prima ancora di aprire Claude, le fasi della ricerca e l’aspetto preciso del file finale.

Il punto di partenza sono le seed keyword, i termini di base da cui si sviluppa l’intera ricerca. Conviene descrivere il risultato atteso colonna per colonna: keyword, volume, difficoltà, intento, cluster, priorità, fonte del dato. Un buon metodo di partenza è quello che si usa già a mano, messo per iscritto.

Collegare la fonte dei dati

Per collegare la fonte dei dati si attiva in Claude il connettore o il server MCP dello strumento SEO scelto e si verifica che risponda.

Nell’app di Claude i connettori si attivano dalle impostazioni, mentre in Claude Code, l’agente di Anthropic che lavora da terminale e sui file del computer, un server MCP si aggiunge con un comando. Prima di scrivere la skill conviene fare una prova manuale, chiedendo il volume di una keyword nota e confrontandolo con quello mostrato dallo strumento nel browser.

Scrivere il file SKILL.md

Il file SKILL.md è un documento di testo con un’intestazione che contiene nome e descrizione della skill, seguita dalle istruzioni in linguaggio naturale.

La descrizione è la parte più delicata, perché Claude la legge per decidere quando attivare la skill. Nel corpo si indicano i passaggi, lo strumento da interrogare, i parametri e le regole sui dati, compresa la classificazione per search intent, l’intenzione che sta dietro una ricerca. Un file di output già compilato, allegato alla skill, funziona come nel few-shot prompting: mostra al modello il risultato atteso meglio di qualsiasi descrizione. Un esempio essenziale è il seguente.

---
name: keyword-research
description: Keyword research per un sito italiano con dati reali di volume e difficoltà. Da usare quando viene chiesta una ricerca di parole chiave, a partire da una seed keyword o da un dominio concorrente.
---

1. Chiedi seed keyword, sito e pubblico, se mancano.
2. Con lo strumento SEO collegato (paese Italia, lingua italiano) raccogli suggerimenti, domande e keyword correlate.
3. Per ogni keyword salva volume, difficoltà e CPC così come li restituisce lo strumento. Non stimare mai un dato: se manca, scrivi «non disponibile».
4. Classifica ogni keyword per intento: informativo, navigazionale, commerciale, transazionale.
5. Raggruppa le keyword in cluster e indica per ognuno la keyword principale.
6. Assegna la priorità con i criteri qui sotto.
7. Consegna un file CSV con le colonne: keyword, volume, difficoltà, intento, cluster, priorità, fonte.

## Criteri di priorità

- Pertinenza da 1 a 3 rispetto ai servizi del sito.
- Punteggio = volume × pertinenza ÷ (difficoltà + 10).
- Alta: punteggio sopra 20. Media: tra 5 e 20. Bassa: sotto 5.
- Le domande a volume zero restano nel file con priorità «FAQ».

La documentazione di Claude Code consiglia di tenere il file sotto le 500 righe e di spostare i materiali lunghi in file di supporto nella stessa cartella. Chi preferisce non scriverlo da zero può usare la skill skill-creator di Anthropic, che costruisce il file a partire da una descrizione del metodo e lo rifinisce dopo le prime prove.

Stabilire i criteri di priorità

I criteri di priorità stabiliscono nella skill come ordinare le keyword, in modo che la classifica finale non cambi da una richiesta all’altra.

Un criterio diffuso combina volume, difficoltà e pertinenza in un punteggio di opportunità. Con la formula del file d’esempio, una keyword da 480 ricerche mensili, difficoltà 30 e pertinenza 2 ottiene 24 punti e priorità alta, mentre una da 1.000 ricerche, difficoltà 90 e pertinenza 1 si ferma a 10 punti e priorità media, pur avendo un volume doppio. Accanto al punteggio servono regole qualitative: dare spazio alle long-tail keyword, le query più lunghe e specifiche con concorrenza più bassa, e conservare le domande a volume zero che emergono da forum e suggerimenti di Google, utili per le FAQ e per intercettare le domande poste agli assistenti AI. Il raggruppamento segue le regole del keyword clustering, che unisce in una sola pagina le query con lo stesso intento.

Installare la skill in Claude o in Claude Code

Per installare la skill la si carica nell’app di Claude come file ZIP oppure la si salva nella cartella delle skill di Claude Code.

Nell’app, dove le skill si chiamano competenze, la cartella compressa si carica da Personalizza > Competenze, dopo aver attivato l’esecuzione del codice; la cartella dentro lo ZIP deve avere lo stesso nome della skill, e la guida ufficiale di Anthropic sull’uso delle skill descrive i passaggi per ogni piano. In Claude Code la cartella va in ~/.claude/skills/ per averla in tutti i progetti, oppure in .claude/skills/ dentro una cartella di lavoro. Chi usa Claude Code per la SEO può poi richiamarla direttamente con il comando /keyword-research seguito dalla seed keyword.

Provare e correggere la skill

La prova della skill consiste nel lanciarla su due o tre keyword già studiate a mano e nel confrontare il risultato con il lavoro fatto in precedenza.

Le differenze più comuni riguardano cluster troppo ampi, intenti classificati male o colonne mancanti. Ogni errore ricorrente diventa una nuova riga di istruzioni, finché il file prodotto dalla skill non coincide con quello che si sarebbe consegnato a un cliente.

Esempi concreti di skill per la keyword research

Gli esempi concreti di skill per la keyword research mostrano che il guadagno più grande arriva quando il lavoro si ripete: un catalogo da mappare, una città da presidiare, dei concorrenti da raggiungere. I tre casi che seguono sono ipotetici, ma i numeri sono plausibili e mostrano cosa emerge che a mano sarebbe sfuggito.

  • e-commerce di arredamento: un negozio online di mobili da esterno lancia la skill su cinque seed keyword di categoria e in una sola sessione ottiene 320 keyword con volumi reali, raggruppate in 18 cluster; la ricerca, che prima occupava una giornata, si chiude in circa un’ora, quasi tutta dedicata a verificare i cluster
  • studio professionale locale: uno studio di commercialisti aggiunge alla skill una regola per le query con il nome della città e trova 40 domande a basso volume, come quelle sulle scadenze fiscali delle partite IVA, che diventano FAQ distribuite su sei pagine di servizio
  • blog B2B con analisi dei concorrenti: un’azienda di software gestionale parte dai domini di due concorrenti e scopre 85 parole chiave di gap keyword, cioè query per cui i concorrenti si posizionano e il blog no; la skill le organizza in sette topic cluster, gruppi di articoli collegati a una pagina principale, e su quella base si costruisce il piano editoriale del trimestre.

Se vuoi applicare questi esempi ai tuoi testi o al lavoro del tuo team, nel mio corso Claude AI li costruiamo insieme sul tuo caso.

Come si lancia la skill con un prompt?

La skill si lancia con un prompt breve che indica la seed keyword, il sito, il pubblico e l’eventuale limite di keyword da analizzare, mentre il metodo resta nel file SKILL.md.

Il prompt serve solo a fornire i dati del caso specifico. Più il metodo è scritto bene nella skill, più il prompt può essere corto. In Claude Code, dove la skill può salvare file sul computer, un prompt di partenza può essere strutturato così:

Usa la skill keyword-research per il sito [URL del tuo sito], che si rivolge a [pubblico]. Seed keyword: [keyword 1], [keyword 2], [keyword 3]. Considera anche i domini concorrenti [concorrente 1] e [concorrente 2]. Analizza al massimo [numero] keyword, escludi quelle con intento transazionale e salva il file CSV nella cartella [nome cartella].

Nell’app di Claude la richiesta è la stessa, ma il file CSV si scarica dalla conversazione invece di essere salvato in una cartella.

Quali errori evitare nella keyword research con Claude?

Gli errori da evitare nella keyword research con Claude riguardano i dati non verificati, le istruzioni troppo generiche e la mancanza di un controllo umano sulle priorità finali.

Nel dettaglio, gli errori ricorrenti sono questi:

  • dimenticare di indicare paese e lingua, con dati riferiti a un altro mercato
  • mescolare nella stessa ricerca fonti diverse senza indicare da dove arriva ogni numero
  • scrivere una descrizione vaga, che non fa attivare la skill quando serve
  • caricare nel file SKILL.md centinaia di righe di teoria invece dei passaggi operativi
  • pubblicare un piano editoriale basato sulla classifica della skill senza rileggerla.

La skill accelera la raccolta e l’ordinamento, ma la scelta delle keyword su cui investire resta una decisione strategica.

Vuoi che Claude scriva come scrivi tu?

Nel percorso su Claude configuriamo progetti, istruzioni ed esempi sul tuo tono di voce. Se lavori in agenzia, costruiamo insieme anche i flussi di produzione con Claude Code.

Puoi partire da una call gratuita di 30 minuti.

Domande frequenti

Le skill di Claude si possono usare nel piano gratuito?

Sì, le skill sono disponibili in tutti i piani, compreso quello gratuito, a condizione di attivare l’esecuzione del codice nelle impostazioni.

Claude può trovare da solo il volume di ricerca delle keyword?

No, senza uno strumento collegato Claude può solo stimare i volumi. Per avere numeri reali serve un connettore o un server MCP di una piattaforma SEO.

Quale server MCP SEO conviene collegare a Claude?

Dipende dallo strumento già in uso: Semrush e Ahrefs offrono server ufficiali, Ubersuggest è disponibile come connettore e DataForSEO è adatto a grandi volumi a consumo.

Una skill può fare anche il keyword clustering?

Sì, basta descrivere nel file SKILL.md come raggruppare le keyword per intento e tema e quale colonna aggiungere al file finale.

La stessa skill funziona in Claude Code e nell’app di Claude?

Sì, la cartella con il file SKILL.md è la stessa: nell’app si carica come file ZIP, in Claude Code si salva nella cartella delle skill.

Vuoi applicare questi metodi al tuo lavoro?

Scrivo contenuti per Google e per i motori AI, costruisco automazioni con Claude e formo team e professionisti. In una call gratuita di 30 minuti guardiamo insieme il tuo caso e capiamo da dove partire.

Oppure scopri cosa faccio.

Continua a leggere


Avatar Giuseppe Martella

Scopri chi sono e come lavoro →