Pesquisa de Palavras-chave SEO/GEO
Uma habilidade de agente que pesquisa e entrega uma lista priorizada de palavras-chave para SEO e GEO — utilizando pesquisa na web e análise de IA em vez de ferramentas pagas como Ahrefs ou Semrush.
Sem Ahrefs. Sem Semrush necessários.
Utiliza pesquisa na web, rastreamento de sites e análise de LLM para encontrar, agrupar e priorizar palavras-chave — incluindo uma dimensão GEO que as ferramentas tradicionais não oferecem. Opcionalmente, potencialize a pesquisa com scripts da API SERP para dados reais de preenchimento automático, PAA e recursos SERP.
Instalação
Clone o repositório e, em seguida, crie um link simbólico ou copie research-keywords/ para ~/.codex/skills/ ou ~/.claude/skills/. Consulte o README na raiz para exemplos de instalação.
Uso
/research-keywords
Ou:
"Pesquisar palavras-chave para o meu produto" "Encontrar palavras-chave SEO e GEO para [marca/URL]" "Executar pesquisa de palavras-chave para a minha [categoria de produto]"
A habilidade é interativa — ela faz perguntas, pesquisa e entrega um arquivo de palavras-chave estruturado.
O Processo em 4 Fases
Fase 1: Inteligência de Marca
A habilidade pergunta sobre o seu produto, público-alvo e concorrentes. Ela visita o seu site e os sites dos concorrentes para extrair linguagem, posicionamento e lacunas de conteúdo.
Fase 2: Descoberta de Palavras-chave
Pesquisa palavras-chave através de 6 métodos — sem necessidade de ferramentas pagas:
| Método | O Que Encontra |
|---|---|
| Mineração do Autocompletar do Google | Sugestões de pesquisa reais e variantes de cauda longa |
| As Pessoas Também Perguntam (PAA) | Palavras-chave em formato de pergunta que os mecanismos de IA adoram responder |
| Mineração no Reddit e Comunidades | Linguagem real dos usuários, pontos problemáticos e gírias |
| Análise de Conteúdo do Concorrente | Tópicos que os concorrentes abordam e você não |
| Palavras-chave de Perguntas e Problemas | Pesquisas conscientes de problemas que levam ao seu produto |
| Palavras-chave de Citação de IA (GEO) | Consultas onde a IA gera respostas e cita fontes |
Fase 3: Análise e Agrupamento de Palavras-chave
Agrupa palavras-chave em clusters de tópicos, pontuando cada uma em 3 dimensões:
- Relevância para o seu produto (1-5)
- Oportunidade GEO — a IA responderá a isso e citará fontes? (1-5)
- Valor de Negócio — quão próximo da conversão? (1-5)
Sinaliza vitórias rápidas: páginas existentes para otimizar, conteúdo fraco do concorrente, lacunas de citação de IA.
Fase 4: Produto Final
Produz um arquivo Markdown estruturado com:
- Clusters de tópicos priorizados com palavras-chave principais + de suporte
- Tabela de palavras-chave específicas para GEO (maior potencial de citação de IA)
- Vitórias rápidas e lacunas dos concorrentes
- Lista completa de palavras-chave brutas para referência
- Recomendações de conteúdo por cluster
O Que Torna Isso Diferente
| Pesquisa de Palavras-chave Tradicional | Esta Habilidade |
|---|---|
| Requer Ahrefs/Semrush (US$99-449/mês) | Gratuito — usa pesquisa na web |
| Foca em volume de busca + dificuldade | Adiciona pontuação de oportunidade GEO |
| Produz uma planilha de palavras-chave | Produz um plano de conteúdo acionável e agrupado |
| Ignora o potencial de citação de IA | GEO é uma dimensão de primeira classe |
| Linguagem de profissional de marketing | Linguagem real de usuários do Reddit/comunidades |
Funciona com Outras Habilidades
O produto final de palavras-chave alimenta diretamente:
- write-seo-geo-content — escreve páginas para os principais clusters de palavras-chave e prompts
- geo-content-research — constrói conteúdo completo pronto para IA para palavras-chave de alto GEO
- create-geo-charts — cria visualizações de dados para palavras-chave orientadas por dados
Scripts SERP (Ferramentas Poderosas Opcionais)
O diretório scripts/ contém ferramentas Node.js que obtêm dados reais do Google para turbinar a pesquisa de palavras-chave. Elas são opcionais — a habilidade funciona sem elas usando a pesquisa na web do Claude, mas fornecem dados mais volumosos e precisos.
keyword-explorer.mjs — Descoberta de Palavras-chave
Obtém sugestões reais de autocompletar do Google, perguntas do "As Pessoas Também Perguntam", pesquisas relacionadas e detecta recursos SERP (Visões Gerais de IA, Snippets em Destaque).
# Modo gratuito — sem chave de API, apenas autocompletar
node scripts/keyword-explorer.mjs --seeds "physical AI, DePAI" --free
# Modo completo com SerpAPI (nível gratuito: 100 pesquisas/mês em serpapi.com)
SERPAPI_KEY=xxx node scripts/keyword-explorer.mjs \
--seeds "physical AI, DePAI, decentralized robotics" \
--depth deep \
--out keywords.json
# Verificação rápida para uma única palavra-chave
node scripts/keyword-explorer.mjs -s "machine economy" --free -d quick
Opções:
| Sinalizador | Descrição | Padrão |
|---|---|---|
--seeds, -s | Palavras-chave semente separadas por vírgula (obrigatório) | — |
--free | Modo gratuito: sugestões do Google, sem chave de API | automático se sem chave |
--depth, -d | quick / normal / deep (profundidade) | normal |
--out, -o | Caminho do arquivo JSON de saída | gerado automaticamente |
--gl | Código do país | us |
--hl | Código do idioma | en |
O que ele produz:
- Todas as palavras-chave descobertas com tags de origem (autocompletar, PAA, related_search)
- Perguntas do "As Pessoas Também Perguntam" com snippets e fontes
- Detecção de recursos SERP por consulta (Visão Geral de IA, Snippet em Destaque, etc.)
- Consultas onde as Visões Gerais de IA aparecem (= alta oportunidade GEO)
serp-analyzer.mjs — Análise de Concorrência SERP
Pega uma lista de palavras-chave e verifica quem está classificado atualmente, quais recursos SERP aparecem e onde existem lacunas de conteúdo.
# Analisar palavras-chave da saída do explorador
SERPAPI_KEY=xxx node scripts/serp-analyzer.mjs \
--input keywords.json \
--top 20 \
--track "axisrobotics.ai,bittensor.com"
# Analisar palavras-chave específicas
SERPAPI_KEY=xxx node scripts/serp-analyzer.mjs \
--keywords "what is DePAI, physical AI companies, best AI robotics crypto" \
--track "axisrobotics.ai"
Opções:
| Sinalizador | Descrição | Padrão |
|---|---|---|
--input, -i | Caminho para o arquivo JSON de saída do keyword-explorer | — |
--keywords, -k | Palavras-chave separadas por vírgula para análise | — |
--top, -t | Quantas palavras-chave do arquivo de entrada | 10 |
--track | Domínios separados por vírgula para rastrear | — |
--out, -o | Caminho do arquivo JSON de saída | gerado automaticamente |
O que ele produz:
- Estimativa de dificuldade por palavra-chave (fácil / médio / difícil)
- Recursos SERP presentes (Visão Geral de IA, Snippet em Destaque, PAA, Gráfico de Conhecimento, etc.)
- Quais fontes as Visões Gerais de IA citam atualmente
- Presença/ausência de domínios rastreados (encontre suas lacunas de conteúdo)
- Domínios de classificação mais frequentes (identifique os concorrentes reais)
- Todas as perguntas do PAA (ideias de conteúdo)
Fluxo de Trabalho Recomendado
1. Execute o keyword-explorer com suas palavras-chave semente
→ Obtenha a lista bruta de palavras-chave + perguntas do PAA
2. Alimente o serp-analyzer com a saída para palavras-chave de alta prioridade
→ Obtenha dados de concorrência + oportunidades de recursos SERP
3. Execute a habilidade /research-keywords com ambas as saídas
→ Obtenha um plano de palavras-chave agrupado, pontuado e acionável
Configuração
# Sem dependências necessárias — Node.js puro (v18+), zero instalação via npm
# Basta uma chave SerpAPI para recursos completos (gratuito em serpapi.com)
export SERPAPI_KEY=your_key_here
Exemplo de Resultado
## Agrupamentos de Palavras-chave Prioritários
### Grupo 1: Melhores Ferramentas de Escrita com IA — Prioridade: 14/15
Palavra-chave Principal: best AI writing tools 2026
Intenção: Investigação Comercial
Oportunidade GEO: 5/5 — Visões Gerais de IA aparecem, formato de comparação
Valor de Negócio: 5/5 — intenção de compra direta
Relevância: 4/5
| Palavra-chave | Intenção | Oport. GEO | Notas |
|---|---|---|---|
| best AI writing tools 2026 | Comercial | Alta | Principal |
| AI writing tool comparison | Comercial | Alta | Conteúdo de tabela comparativa |
| is jasper AI worth it | Confiança | Alta | PAA — abordar no FAQ |
| AI content writer for blogs | Comercial | Média | Variante de caso de uso |