Configurações de cookies

Os cookies necessários mantêm o site funcionando. A análise mostra quais páginas são úteis. Você pode mudar sua escolha a qualquer momento pelo rodapé.

Política de cookies deste site — detalhes completos: categorias de cookies, como guardamos sua escolha no navegador e como retirar o consentimento.

Necessários

Funções básicas do site e sua escolha de consentimento. Sempre ativos.

Análise

Ajuda a entender como o site é usado. Carregado apenas com sua permissão.

GitHubBaixar ZIP

Integração com o Google Search Console

Consulte o Search Console, guarde os dados em um arquivo SQLite local e cruze-os com as evidências do rastreamento por URL. O acesso é somente leitura e usa as suas próprias credenciais do Google.

Ver no GitHubInício rápido

O que faz

  • SpiderHead no terminal: seohead gsc-query

Conecte somente leitura

O SpiderHead usa apenas o escopo somente leitura do Search Console. Há três formas de fornecer o acesso, e você escolhe uma. Depois, o provider-verify confere o acesso à propriedade separadamente, porque um login válido não prova que você pode ler um determinado site.

  • Consentimento no navegador com o seu cliente OAuth de desktop, pelo scripts/gsc_oauth_login.py. O refresh token fica guardado na sua pasta de configuração local.
  • Uma conta de serviço do Google que você adiciona como usuário da propriedade.
  • Um token de acesso já pronto na configuração GSC_ACCESS_TOKEN.

Histórico local

O gsc-archive coloca um intervalo de datas na fila e o busca em lotes pequenos e retomáveis, gravando em um arquivo SQLite que você nomeia. O sources-sync mantém o histórico diário por projeto e busca só os dias que faltam. Nada vai para um serviço hospedado, e os arquivos são criados com permissões somente para o dono.

  • As datas são inclusivas e usam o horário do Pacífico.
  • Granularidades diferentes (totais, páginas, consultas) são conjuntos de dados separados e nunca são somadas.
  • Os arquivos podem conter consultas e URLs, então mantenha-os fora de relatórios públicos e do Git.

Inspeção de URL

O gsc-query com o modo inspect_url retorna o veredito de indexação do próprio Google para uma URL. Ele fica em linha separada, à parte das verificações do rastreador. Dentro do sf run, --gsc-inspect inspeciona uma amostra determinística de até 50 URLs, com limites de taxa locais de 600 por minuto e 2.000 por 24 horas.

  • Só a versão indexada de uma página pode ser inspecionada.
  • Os limites por site do Google se aplicam além dos locais.
  • URLs não inspecionadas permanecem como desconhecidas.

Três passos, um rastreamento salvo

  1. Conecte uma permissão somente leitura

    Conecte uma permissão somente leitura do Google para uma propriedade que você possui. Verifique o status dela a qualquer momento.

  2. Arquive localmente

    Coloque um intervalo de datas na fila e execute em lotes pequenos e limitados, gravando em um arquivo SQLite na sua máquina. Novas execuções buscam apenas os dias que faltam.

  3. Cruze com cada URL

    Cliques, impressões, posição e CTR são cruzados com as páginas do rastreamento pela URL. O veredito de indexação do próprio Google para uma URL fica em linha separada.

Um comando

bash
seohead gsc-query --site-url sc-domain:example.com --start-date 2026-09-01 --end-date 2026-09-30

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

O que você precisa

  • Uma propriedade do Search Console que você possui ou pode ler (propriedade de domínio ou prefixo de URL)
  • Uma credencial: consentimento OAuth, conta de serviço ou token de acesso (todos somente leitura)
  • Um intervalo de datas, dentro de cerca dos últimos 16 meses
  • Opcional: um rastreamento ou scan ao qual vincular as linhas

Limites

  • O Google mantém cerca de 16 meses de dados.
  • Consultas anonimizadas são omitidas, e as linhas podem ser limitadas. Um job limitado é marcado e não é uma exportação completa.
  • Cliques, impressões, CTR e posição não são somados entre granularidades diferentes.
  • O veredito de indexação cobre apenas as URLs que você inspeciona.

Perguntas

Meus dados vão para um serviço hospedado?
Não. As requisições saem da sua máquina diretamente para a API do Google Search Console, usando a sua própria permissão. Os resultados ficam guardados em arquivos SQLite locais, com permissões somente para o dono. Mantenha esses arquivos fora de relatórios públicos e do Git, porque podem conter consultas e URLs.
Ela pode alterar a minha propriedade do Search Console?
Não. A permissão é somente leitura. A ferramenta só lê os dados de análise de pesquisa e os resultados da inspeção de URL.
Até quando os dados voltam?
Cerca de 16 meses, que é o histórico disponível no Google. As datas são inclusivas e usam o horário do Pacífico.
Por que algumas consultas parecem estar faltando?
O Google omite consultas anonimizadas e pode limitar o número de linhas retornadas. Um job limitado não é uma exportação completa, e a ferramenta o marca assim.
O veredito de indexação do Google substitui as verificações do rastreamento?
Não. O veredito do Google para uma URL vem do gsc-query no modo inspect_url. As verificações do próprio rastreador (metadados, cabeçalhos, robots, redirecionamentos, dados estruturados, renderização) rodam com o inspect-url. Os dois resultados ficam separados.
Quanto custa e o que fica guardado localmente?
A API é gratuita dentro das cotas do Google. O SpiderHead guarda o seu refresh token ou o caminho da conta de serviço na sua pasta de configuração local, e os arquivos de arquivamento e de histórico no local que você indicar. Nenhum token é gravado nos arquivos de histórico.

Continue explorando

Do blog e do glossário

Google Search Console: guia completo 2026BlogGoogle Search Console (GSC)GlossárioIndexaçãoGlossário

Mais neste grupo · Fontes de dados

Dados do GA4 e do Yandex MetrikaRecursoIntegração com o Yandex WebmasterRecursoRelatório de Core Web Vitals do CrUXRecursoAnalisador de arquivos de log do servidorRecursoVerificador de backlinks de uma lista de doadoresRecursoFerramenta para montar o núcleo semânticoRecurso

Teste no seu próprio site

Baixar ZIPTodos os recursos