Ferramenta para montar o núcleo semântico

Colete, limpe e clusterize as palavras-chave do projeto: Wordstat, clusters de SERP e frequência exata, com plano offline antes de cada chamada paga.

Experimente

Núcleo semântico do SpiderHead: a trilha de etapas, gratuitas e pagas, e o plano offline de uma etapa paga.

Treze etapas, um núcleo que se acumula

Cada etapa muda um status e registra o motivo, então nenhuma frase é apagada e toda decisão pode ser explicada. As etapas gratuitas ficam entre as pagas, para você conferir o conjunto antes de comprar a próxima resposta.

  • GrátisGrátis, roda localmente
  • PagoChamada paga ao provedor
  • WebPáginas públicas da web, sem cota de provedor
  1. Grátis

    Importar

    Traga o que você já tem: um CSV ou uma planilha de um XLSX. Mapeie query, frequency, group, subgroup, URL e comment e depois adicione, atualize ou substitua. A prévia mostra as linhas novas, existentes e duplicadas antes de gravar qualquer coisa.

    phrases
  2. Pago

    Coletar · Yandex Wordstat

    Expande suas sementes por região e expande de novo as frases fortes até a profundidade definida. A fila é deduplicada, e --resume continua uma execução interrompida sem pedir a mesma frase outra vez.

    phrases, expansions, provenance
  3. Grátis

    Limpar

    Aplica os filtros do projeto (intenção, stop words, padrões informacionais), sinaliza frequências atípicas e agrupa as frases por lema. Uma frase com impressões ou posições observadas nunca é cortada por regras de frequência.

    status, route, lemma group
  4. Grátis

    Grafo

    Monta um grafo de palavras do conjunto. Candidatas a homônimos vão para revisão e os clusters candidatos vão para anomalies.md, antes de você pagar por qualquer outra coisa.

    anomalies.md
  5. Grátis

    Aderência ao site

    Uma frase só entra no núcleo se o site a oferece. Frases sem nenhum termo de catalog.txt vão para revisão como fora do catálogo.

    review list
  6. Pago

    Clusterizar · Yandex Search API

    Busca um top 10 por frase e o guarda em cache, então uma nova execução paga só pelas frases novas. Frases que compartilham páginas formam um cluster; --method louvain reagrupa os resultados em cache para quebrar cadeias longas.

    SERP cache, clusters, landing candidates
  7. Grátis

    Relevância

    Se nenhum site do seu tipo de vendors.txt aparece no top 10 de uma frase, o tema provavelmente está fora do escopo. A frase vai para revisão; nada é apagado.

    review list
  8. Grátis

    Concorrentes

    Lê os resultados em cache: quais domínios dominam seus clusters e quais palavras usam nos títulos. Os candidatos vão para synonyms.txt.

    competitors.md, synonyms.txt
  9. Web

    Mineração

    Abre as páginas de concorrentes mais frequentes dos resultados coletados e lê title, description, H1 e os primeiros H2. Frases temáticas de duas e três palavras vão para synonyms.txt.

    competitor_mining.md, synonyms.txt
  10. Pago

    Sinônimos · Yandex Wordstat

    Verifica os candidatos de synonyms.txt. Só frases com demanda entram no núcleo; depois collect --resume faz o conjunto crescer a partir delas.

    checked phrases
  11. Pago

    Frequência exata · Arsenkin

    Compra a frequência exata !W uma vez por grupo de lemas, no fim, quando o conjunto parou de mudar. Acima do limite de orçamento do projeto, exige --yes.

    exact frequency, task receipts
  12. Grátis

    Relatório e Excel

    report.md e clusters.csv para leitura, uma planilha XLSX (Summary, Core, Info, Clusters, Rejected) para o cliente, pool.csv e pool.json para outras ferramentas.

    report.md, XLSX, CSV, JSON
  13. Grátis

    Landing page e insights

    Depois do lançamento, escolha a landing page de cada cluster entre candidatas medidas, depois leia os sinais semanais dos clusters a partir dos seus dados locais do Search Console, Webmaster e Metrika e transforme os escolhidos em tarefas do checklist.

    landing, weekly signals, tasks

O ciclo que faz o núcleo crescer

O núcleo não se coleta de uma vez. Concorrentes e mineração trazem novos candidatos, a etapa de sinônimos os verifica, a coleta continua e a clusterização roda de novo. A frequência exata é comprada por último.

  1. collect
  2. clean · graph · site match
  3. cluster
  4. competitors · mine
  5. synonyms
  6. collect --resume
  7. exact, once
  8. report

De onde vêm os dados

O pipeline de coleta roda com dados do Yandex. Demanda do Google, monitoramento de posições e análise de busca são comandos separados do toolkit, que funcionam ao lado do núcleo.

Dentro do pipeline

Pago

Yandex Wordstat

collect · synonyms

Frequência base, refinamentos e consultas parecidas pela API do Yandex Cloud. Chave de API e ID da pasta; cota por hora.

Pago

Yandex Search API

cluster

Um top 10 por frase e região, guardado em cache com o horário e a região da busca. Somente o endpoint assíncrono.

Pago

Arsenkin

exact

A frequência exata !W que a API do Wordstat não fornece. Cobrada na criação da tarefa; o task_id é guardado, então um resultado que expirou é buscado de novo, não comprado de novo.

Ao lado do núcleo

Pago

DataForSEO

google-keywords

Volume de busca, concorrência e expansão de sementes do Google. Sandbox por padrão.

Pago

Consultas avulsas do Wordstat

keywords-expand · keywords-seasonality · regions-tree

Expanda uma frase, leia a demanda dela por mês, navegue pela árvore de regiões (a árvore é gratuita).

Grátis

Topvisor

topvisor-read

Lê projetos, palavras-chave e o histórico de posições registrado na sua conta existente. Verificações pagas não podem ser iniciadas pelo toolkit.

Grátis

Search Console · Webmaster · Metrika

semantics insights

Sinais semanais dos clusters a partir de dados que o toolkit já sincronizou localmente. A etapa de insights em si não faz nenhuma chamada a provedores.

Pague uma vez, veja o plano antes

Toda etapa paga tem um plano offline: a região, o mecanismo, a origem das consultas e um limite máximo de requisições ou tarefas. Um plano não cria nenhum cliente de provedor.

Um plano antes de cada chamada paga

--dry-run --json imprime o plano. A execução em si exige --confirm-paid, mesmo quando a estimativa é zero.

Recibos, não novas tentativas

Tentativas do Wordstat, buscas de SERP e tarefas do Arsenkin são reservadas antes da chamada. Uma requisição ambígua nunca é reenviada automaticamente.

Caches que ficam

SERPs em cache e recibos pagos sobrevivem à substituição do conjunto, então clusterizar de novo paga só pelas frases novas.

Um único diário de gastos

Cada cobrança vai para spend-report com o projeto semântico e a etapa a que pertence.

Quando o preço de um provedor não pode ser determinado offline, o plano diz isso em vez de chutar um número.

Importação e exportação

Entrada

  • CSV ou XLSX, uma planilha selecionada; cabeçalhos mapeados automaticamente quando não há ambiguidade
  • Campos: query, frequency, group, subgroup, URL, comment, além de base, quoted, exact, impressões e posições no Yandex/Google
  • Um caminho Category / Cluster é dividido em group e subgroup
  • add mantém as frases existentes, update aplica os campos informados, replace troca o conjunto e é recusado quando vazio
  • Entrada limitada: 32 MiB por arquivo, 100.000 linhas, 128 colunas

Saída

  • Planilha XLSX: Summary, Core, Info, Clusters com concorrentes, Rejected
  • Resumo report.md e matriz clusters.csv
  • pool.csv e pool.json para outras ferramentas
  • Escopo: o núcleo inteiro, um cluster (--cluster) ou clusters sem landing page (--scope no-landing)
  • Uma simulação (dry run) lista antes os arquivos exatos e o número de linhas

Saída real da CLI

Capturada do projeto de exemplo sintético que acompanha o toolkit. As frases estão em russo, como a demanda do Yandex, e as frequências são inventadas. Nenhuma chamada paga foi feita.

Etapas gratuitas, uma após a outra
$ seohead semantics clean --project ./core
$ seohead semantics graph --project ./core
$ seohead semantics sitematch --project ./core
clean: kept=34 review=4 dropped=3 | lemma groups=41 (median base=720, outlier>36000)
graph: homonyms=0, to review=0, candidate clusters=7 -> anomalies.md
sitematch: catalog terms=11 | off-catalog->review=8 | kept and matching the site=26
O plano offline de uma etapa paga
$ seohead semantics cluster --project ./core --dry-run
"mode": "estimate", "stage": "cluster", "paid": true,
"provider": "yandex_search",
"request_estimate": {"unit": "requests", "count": 26, "kind": "upper_bound"},
"money_estimate": null,
"money_unavailable_reason": "provider pricing is not available from this offline preflight",
"paid_calls_made": 0
Como está o núcleo
$ seohead semantics status --project ./core
dropped=3 | kept=26 | review=12 | _total=41 | _exact=0 | _expanded=0 | _clusters=0
provider units: {'yandex_requests': 0, 'arsenkin': 0}
next: seohead semantics exact --project ./core
Plano de exportação, nada gravado
$ seohead semantics export --project ./core --scope no-landing --dry-run
"mode": "preview", "scope": "no-landing", "rows": 41,
"planned_files": ["core/semantics/pool.csv", "core/semantics/pool.json"]
bash
seohead semantics status --project ./my-core

Instale primeiro: guia de instalação. Todo comando também funciona como ferramenta MCP para agentes de IA.

O que você precisa

  • De três a dez frases-semente e os filtros do projeto em project.yaml
  • catalog.txt com as seções do site, vendors.txt com sites do seu tipo
  • Chave de API e ID da pasta do Yandex Cloud para o Wordstat e a Search API
  • Um token do Arsenkin para a frequência exata, só no fim
  • Opcional: uma lista de palavras-chave existente em CSV ou XLSX

Limites

  • Coleta e clusterização rodam com dados do Yandex; a demanda do Google é o comando separado google-keywords
  • O custo não é estimado offline quando o preço do provedor é desconhecido; o plano diz isso
  • Candidatas a landing page exigem uma clusterização por SERP e o domínio do próprio projeto
  • Os insights leem só dados já sincronizados no banco local de fontes

Entregue o núcleo a um agente

Dez ferramentas MCP expõem as mesmas etapas e leituras. Uma chamada paga devolve o plano e precisa de confirm_paid=true para enviar o trabalho.

  • seo_semantics_statusContadores, unidades do provedor e a próxima etapa
  • seo_semantics_runEtapas gratuitas
  • seo_semantics_minePáginas de concorrentes, sem cota de provedor
  • seo_semantics_paidEtapas pagas: primeiro o plano, depois confirm_paid=true
  • seo_semantics_clustersLista de clusters paginada
  • seo_semantics_cluster_showUm cluster com as evidências da landing page
  • seo_semantics_cluster_queriesFrases de um cluster com o top 10 guardado
  • seo_semantics_set_landingDefinir ou limpar uma landing page
  • seo_semantics_insightsSinais semanais por cluster e fonte
  • seo_semantics_insights_tasksSinais escolhidos para o checklist

Perguntas

O toolkit coleta palavras-chave do Google?
No pipeline de coleta, não: ele roda com Yandex Wordstat, Yandex Search API e Arsenkin. O volume de busca e a expansão de sementes do Google vêm do comando separado google-keywords, via DataForSEO, e você pode importar posições do Google para o núcleo como uma coluna.
Quais etapas custam dinheiro?
collect e synonyms (Yandex Wordstat), cluster para frases sem top 10 em cache (Yandex Search API) e exact (Arsenkin). mine lê páginas públicas de concorrentes e não usa cota de provedor. Todo o resto é gratuito e roda localmente.
Uma execução pode me cobrar duas vezes?
O toolkit foi feito para que isso não aconteça. As requisições pagas são reservadas antes da chamada, uma requisição interrompida não é reenviada automaticamente, um resultado pago do Arsenkin é buscado de novo pelo task_id e os resultados em cache ficam quando você substitui o conjunto.
As frases são apagadas?
Não. Uma etapa muda o status da frase (kept, review, dropped e assim por diante) e registra o motivo e a etapa. Você sempre pode ver por que uma frase saiu do núcleo e trazê-la de volta.
Posso começar de uma lista de palavras-chave existente?
Sim. Importe um CSV ou uma planilha XLSX com suas colunas mapeadas para query, frequency, group, subgroup, URL e comment. Posições e impressões importadas protegem uma frase de cortes por frequência.
Como a landing page de um cluster é escolhida?
Depois de uma clusterização por SERP, e só quando o domínio do próprio projeto é conhecido, cada URL candidata recebe uma pontuação pela parte das frases do cluster cujo top 10 a continha. Você escolhe a landing page; a escolha é gravada com um registro de auditoria.

Teste no seu próprio site