Ricerca parole chiave SEO/GEO
Una competenza agente che ricerca e fornisce una lista di parole chiave prioritarie per SEO e GEO — utilizzando la ricerca sul web e l'analisi AI invece di strumenti a pagamento come Ahrefs o Semrush.
Niente Ahrefs. Niente Semrush necessario.
Utilizza la ricerca sul web, la scansione di siti web e l'analisi LLM per trovare, raggruppare e dare priorità alle parole chiave — inclusa una dimensione GEO che gli strumenti tradizionali non offrono. Opzionalmente potenzia la ricerca con script API SERP per ottenere dati reali di completamento automatico, PAA e funzionalità SERP.
Installazione
Clona il repository, quindi crea un collegamento simbolico o copia research-keywords/ in ~/.codex/skills/ o ~/.claude/skills/. Vedi il README principale per esempi di installazione.
Utilizzo
/research-keywords
Oppure:
"Ricerca parole chiave per il mio prodotto" "Trova parole chiave SEO e GEO per [marca/URL]" "Esegui una ricerca di parole chiave per la mia [categoria di prodotto]"
La competenza è interattiva — ti pone domande, effettua ricerche e fornisce un file strutturato di parole chiave.
Il processo a 4 fasi
Fase 1: Brand Intelligence
La competenza chiede informazioni sul tuo prodotto, il pubblico e i concorrenti. Visita il tuo sito e quelli della concorrenza per estrarre linguaggio, posizionamento e lacune di contenuto.
Fase 2: Scoperta delle parole chiave
Ricerca parole chiave attraverso 6 metodi — senza bisogno di strumenti a pagamento:
| Metodo | Cosa trova |
|---|---|
| Estrazione del completamento automatico di Google | Suggerimenti di ricerca reali e varianti a coda lunga |
| People Also Ask (PAA) | Parole chiave in formato domanda che i motori AI amano rispondere |
| Reddit e community minerarie | Linguaggio reale degli utenti, punti dolenti e gergo |
| Analisi dei contenuti della concorrenza | Argomenti che i concorrenti coprono e tu no |
| Parole chiave di domanda e problema | Ricerche consapevoli del problema che portano al tuo prodotto |
| Parole chiave di citazione AI (GEO) | Query in cui l'AI genera risposte e cita fonti |
Fase 3: Analisi e raggruppamento delle parole chiave
Raggruppa le parole chiave in cluster tematici, assegna un punteggio a ciascuno su 3 dimensioni:
- Rilevanza per il tuo prodotto (1-5)
- Opportunità GEO — l'AI risponderà e citerà fonti? (1-5)
- Valore commerciale — quanto è vicino alla conversione? (1-5)
Segnala vittorie facili: pagine esistenti da ottimizzare, contenuti deboli della concorrenza, lacune nelle citazioni AI.
Fase 4: Prodotto finale
Genera un file Markdown strutturato con:
- Cluster tematici prioritari con parole chiave pilastro e di supporto
- Tabella delle parole chiave specifiche per GEO (massimo potenziale di citazione AI)
- Vittorie facili e lacune della concorrenza
- Elenco completo delle parole chiave grezze per riferimento
- Raccomandazioni di contenuto per cluster
Cosa rende questo diverso
| Ricerca tradizionale di parole chiave | Questa competenza |
|---|---|
| Richiede Ahrefs/Semrush ($99-449/mese) | Gratuito — utilizza la ricerca sul web |
| Si concentra sul volume di ricerca e difficoltà | Aggiunge punteggio delle opportunità GEO |
| Produce un foglio di calcolo di parole chiave | Produce un piano di contenuti raggruppato e attuabile |
| Ignora il potenziale di citazione AI | GEO è una dimensione di primo livello |
| Linguaggio da marketer | Linguaggio reale degli utenti da Reddit/community |
Funziona con altre competenze
Il file delle parole chiave confluisce direttamente in:
- write-seo-geo-content — scrivi pagine per le parole chiave principali e i cluster di prompt
- geo-content-research — costruisci contenuti completi pronti per l'AI per parole chiave ad alto GEO
- create-geo-charts — crea visualizzazioni di dati per parole chiave basate sui dati
Script SERP (Strumenti potenti opzionali)
La directory scripts/ contiene strumenti Node.js che estraggono dati reali da Google per potenziare la ricerca di parole chiave. Questi sono opzionali — la competenza funziona senza di essi utilizzando la ricerca web di Claude, ma forniscono dati più voluminosi e precisi.
keyword-explorer.mjs — Scoperta delle parole chiave
Estrae suggerimenti reali di completamento automatico di Google, domande "People Also Ask", ricerche correlate e rileva le funzionalità SERP (AI Overviews, Featured Snippets).
# Modalità gratuita — nessuna chiave API, solo completamento automatico
node scripts/keyword-explorer.mjs --seeds "physical AI, DePAI" --free
# Modalità completa con SerpAPI (livello gratuito: 100 ricerche/mese su serpapi.com)
SERPAPI_KEY=xxx node scripts/keyword-explorer.mjs \
--seeds "physical AI, DePAI, decentralized robotics" \
--depth deep \
--out keywords.json
# Scansione rapida per un singolo seed
node scripts/keyword-explorer.mjs -s "machine economy" --free -d quick
Opzioni:
| Flag | Descrizione | Predefinito |
|---|---|---|
--seeds, -s | Parole chiave seed separate da virgola (richiesto) | — |
--free | Modalità gratuita: suggerimenti Google, senza chiave API | auto se nessuna chiave |
--depth, -d | quick / normal / deep | normal |
--out, -o | Percorso del file JSON di output | generato automaticamente |
--gl | Codice paese | us |
--hl | Codice lingua | en |
Cosa produce:
- Tutte le parole chiave scoperte con tag di origine (autocomplete, PAA, related_search)
- Domande "People Also Ask" con snippet e fonti
- Rilevamento delle funzionalità SERP per query (AI Overview, Featured Snippet, ecc.)
- Query in cui appaiono AI Overviews (= alta opportunità GEO)
serp-analyzer.mjs — Analisi della concorrenza SERP
Prende un elenco di parole chiave e controlla chi si posiziona attualmente, quali funzionalità SERP appaiono e dove esistono lacune di contenuto.
# Analizza le parole chiave dall'output dell'esploratore
SERPAPI_KEY=xxx node scripts/serp-analyzer.mjs \
--input keywords.json \
--top 20 \
--track "axisrobotics.ai,bittensor.com"
# Analizza parole chiave specifiche
SERPAPI_KEY=xxx node scripts/serp-analyzer.mjs \
--keywords "what is DePAI, physical AI companies, best AI robotics crypto" \
--track "axisrobotics.ai"
Opzioni:
| Flag | Descrizione | Predefinito |
|---|---|---|
--input, -i | Percorso all'output JSON di keyword-explorer | — |
--keywords, -k | Parole chiave separate da virgola da analizzare | — |
--top, -t | Quante parole chiave dal file di input | 10 |
--track | Domini separati da virgola da tracciare | — |
--out, -o | Percorso del file JSON di output | generato automaticamente |
Cosa produce:
- Stima della difficoltà per parola chiave (facile / media / difficile)
- Funzionalità SERP presenti (AI Overview, Featured Snippet, PAA, Knowledge Graph, ecc.)
- Quali fonti citano attualmente le AI Overviews
- Presenza/assenza del dominio tracciato (trova le tue lacune di contenuto)
- Domini più frequenti nei posizionamenti (identifica i veri concorrenti)
- Tutte le domande PAA (idee per i contenuti)
Flusso di lavoro consigliato
1. Esegui keyword-explorer con le tue parole chiave seed
→ Ottieni elenco grezzo di parole chiave + domande PAA
2. Fornisci l'output a serp-analyzer per le parole chiave a priorità più alta
→ Ottieni dati sulla concorrenza + opportunità delle funzionalità SERP
3. Esegui la competenza /research-keywords con entrambi gli output
→ Ottieni un piano di parole chiave raggruppato, valutato e attuabile
Configurazione
# Nessuna dipendenza necessaria — puro Node.js (v18+), zero npm install
# Serve solo una chiave SerpAPI per le funzionalità complete (gratuita su serpapi.com)
export SERPAPI_KEY=your_key_here
Esempio di output
## Cluster di parole chiave prioritari
### Cluster 1: Migliori strumenti di scrittura AI — Priorità: 14/15
Parola chiave pilastro: migliori strumenti di scrittura AI 2026
Intento: Indagine commerciale
Opportunità GEO: 5/5 — Appaiono AI Overviews, formato comparativo
Valore commerciale: 5/5 — intenzione di acquisto diretta
Rilevanza: 4/5
| Parola chiave | Intento | Opportunità GEO | Note |
|---|---|---|---|
| migliori strumenti di scrittura AI 2026 | Commerciale | Alta | Pilastro |
| confronto strumenti di scrittura AI | Commerciale | Alta | Contenuto tabella comparativa |
| ne vale la pena jasper AI | Fiducia | Alta | PAA — affrontare nelle FAQ |
| scrittore di contenuti AI per blog | Commerciale | Media | Variante per caso d'uso |