Investigación de palabras clave SEO/GEO
Una habilidad de agente que investiga y entrega una lista priorizada de palabras clave para SEO y GEO — usando búsqueda web y análisis de IA en lugar de herramientas de pago como Ahrefs o Semrush.
No se requiere Ahrefs ni Semrush.
Utiliza búsqueda web, rastreo de sitios web y análisis de LLM para encontrar, agrupar y priorizar palabras clave — incluyendo una dimensión GEO que las herramientas tradicionales no ofrecen. Opcionalmente, potencia la investigación con scripts de API SERP para datos reales de autocompletado, PAA y características de SERP.
Instalación
Clona el repositorio, luego crea un enlace simbólico o copia research-keywords/ en ~/.codex/skills/ o ~/.claude/skills/. Consulta el README de la raíz para ejemplos de instalación.
Uso
/research-keywords
O:
"Investigar palabras clave para mi producto" "Encontrar palabras clave SEO y GEO para [marca/URL]" "Ejecutar investigación de palabras clave para mi [categoría de producto]"
La habilidad es interactiva — te hace preguntas, investiga y entrega un archivo de palabras clave estructurado.
El proceso de 4 fases
Fase 1: Inteligencia de marca
La habilidad pregunta sobre tu producto, audiencia y competidores. Visita tu sitio web y los de la competencia para extraer lenguaje, posicionamiento y brechas de contenido.
Fase 2: Descubrimiento de palabras clave
Investiga palabras clave con 6 métodos — sin necesidad de herramientas de pago:
| Método | Qué encuentra |
|---|---|
| Minería de autocompletado de Google | Sugerencias de búsqueda reales y variantes de cola larga |
| People Also Ask (PAA) | Palabras clave en formato de pregunta que los motores de IA adoran responder |
| Minería de Reddit y comunidades | Lenguaje real de usuarios, puntos de dolor y jerga |
| Análisis de contenido de competidores | Temas que cubren los competidores y tú no |
| Palabras clave de preguntas y problemas | Búsquedas conscientes de problemas que llevan a tu producto |
| Palabras clave de citación de IA (GEO) | Consultas donde la IA genera respuestas y cita fuentes |
Fase 3: Análisis y agrupación de palabras clave
Agrupa palabras clave en clústeres temáticos, puntúa cada una en 3 dimensiones:
- Relevancia para tu producto (1-5)
- Oportunidad GEO — ¿la IA responderá esto y citará fuentes? (1-5)
- Valor empresarial — ¿qué tan cerca de la conversión? (1-5)
Señala victorias rápidas: páginas existentes para optimizar, contenido débil de competidores, brechas de citación de IA.
Fase 4: Entregable
Produce un archivo Markdown estructurado con:
- Clústeres temáticos priorizados con palabras clave pilares y de apoyo
- Tabla de palabras clave específicas de GEO (mayor potencial de citación de IA)
- Victorias rápidas y brechas de competidores
- Lista completa de palabras clave sin procesar para referencia
- Recomendaciones de contenido por clúster
Qué hace esto diferente
| Investigación de palabras clave tradicional | Esta habilidad |
|---|---|
| Requiere Ahrefs/Semrush ($99-449/mes) | Gratis — usa búsqueda web |
| Se enfoca en volumen de búsqueda + dificultad | Añade puntuación de oportunidad GEO |
| Produce una hoja de cálculo de palabras clave | Produce un plan de contenido agrupado y accionable |
| Ignora el potencial de citación de IA | GEO es una dimensión de primera clase |
| Lenguaje de mercadólogo | Lenguaje real de usuarios de Reddit/comunidades |
Funciona con otras habilidades
El entregable de palabras clave alimenta directamente a:
- write-seo-geo-content — escribir páginas para los clústeres de palabras clave y prompts principales
- geo-content-research — construir contenido completo listo para IA para palabras clave de alto GEO
- create-geo-charts — crear visualizaciones de datos para palabras clave basadas en datos
Scripts SERP (Herramientas potentes opcionales)
El directorio scripts/ contiene herramientas Node.js que obtienen datos reales de Google para potenciar la investigación de palabras clave. Son opcionales — la habilidad funciona sin ellas usando la búsqueda web de Claude, pero proporcionan datos de mayor volumen y más precisos.
keyword-explorer.mjs — Descubrimiento de palabras clave
Obtiene sugerencias reales de autocompletado de Google, preguntas de People Also Ask, búsquedas relacionadas y detecta características de SERP (AI Overviews, Featured Snippets).
# Free mode — no API key, autocomplete only
node scripts/keyword-explorer.mjs --seeds "physical AI, DePAI" --free
# Full mode with SerpAPI (free tier: 100 searches/month at serpapi.com)
SERPAPI_KEY=xxx node scripts/keyword-explorer.mjs \
--seeds "physical AI, DePAI, decentralized robotics" \
--depth deep \
--out keywords.json
# Quick scan for a single seed
node scripts/keyword-explorer.mjs -s "machine economy" --free -d quick
Opciones:
| Flag | Descripción | Por defecto |
|---|---|---|
--seeds, -s | Palabras clave semilla separadas por comas (obligatorio) | — |
--free | Modo gratuito: sugerencias de Google, sin clave API | auto si no hay clave |
--depth, -d | quick / normal / deep | normal |
--out, -o | Ruta del archivo JSON de salida | auto-generado |
--gl | Código de país | us |
--hl | Código de idioma | en |
Qué produce:
- Todas las palabras clave descubiertas con etiquetas de fuente (autocomplete, PAA, related_search)
- Preguntas de People Also Ask con fragmentos y fuentes
- Detección de características SERP por consulta (AI Overview, Featured Snippet, etc.)
- Consultas donde aparecen AI Overviews (= alta oportunidad GEO)
serp-analyzer.mjs — Análisis de competencia SERP
Toma una lista de palabras clave y verifica quién se posiciona actualmente, qué características SERP aparecen y dónde existen brechas de contenido.
# Analyze keywords from explorer output
SERPAPI_KEY=xxx node scripts/serp-analyzer.mjs \
--input keywords.json \
--top 20 \
--track "axisrobotics.ai,bittensor.com"
# Analyze specific keywords
SERPAPI_KEY=xxx node scripts/serp-analyzer.mjs \
--keywords "what is DePAI, physical AI companies, best AI robotics crypto" \
--track "axisrobotics.ai"
Opciones:
| Flag | Descripción | Por defecto |
|---|---|---|
--input, -i | Ruta al archivo JSON de salida de keyword-explorer | — |
--keywords, -k | Palabras clave separadas por comas para analizar | — |
--top, -t | Cuántas palabras clave del archivo de entrada | 10 |
--track | Dominios separados por comas para rastrear | — |
--out, -o | Ruta del archivo JSON de salida | auto-generado |
Qué produce:
- Estimación de dificultad por palabra clave (fácil / media / difícil)
- Características SERP presentes (AI Overview, Featured Snippet, PAA, Knowledge Graph, etc.)
- Qué fuentes citan actualmente las AI Overviews
- Presencia/ausencia de dominios rastreados (encuentra tus brechas de contenido)
- Dominios más frecuentes en el ranking (identifica competidores reales)
- Todas las preguntas PAA (ideas de contenido)
Flujo de trabajo recomendado
1. Run keyword-explorer with your seed keywords
→ Get raw keyword list + PAA questions
2. Feed output into serp-analyzer for top priority keywords
→ Get competition data + SERP feature opportunities
3. Run the /research-keywords skill with both outputs
→ Get clustered, scored, actionable keyword plan
Configuración
# No dependencies needed — pure Node.js (v18+), zero npm install
# Just need a SerpAPI key for full features (free at serpapi.com)
export SERPAPI_KEY=your_key_here
Ejemplo de salida
## Priority Keyword Clusters
### Cluster 1: Best AI Writing Tools — Priority: 14/15
Pillar Keyword: best AI writing tools 2026
Intent: Commercial Investigation
GEO Opportunity: 5/5 — AI Overviews appear, comparison format
Business Value: 5/5 — direct purchase intent
Relevance: 4/5
| Keyword | Intent | GEO Opp | Notes |
|---|---|---|---|
| best AI writing tools 2026 | Commercial | High | Pillar |
| AI writing tool comparison | Commercial | High | Comparison table content |
| is jasper AI worth it | Trust | High | PAA — address in FAQ |
| AI content writer for blogs | Commercial | Medium | Use-case variant |