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 Yandex Webmaster

Leia as consultas de pesquisa do Yandex Webmaster por URL para um host que você verificou e mantenha as linhas junto ao seu rastreamento. Somente leitura, com token OAuth, gratuito dentro da cota da API do Webmaster.

Ver no GitHubInício rápido

O que faz

  • Terminal: opções do seohead webmaster-url-queries

Consultas por URL

O webmaster-url-queries retorna consultas de pesquisa para uma página exata (--url) ou para um grupo de páginas (--url-contains). As linhas de URL e de consulta ficam separadas. CTR e posição média não são somados entre páginas.

  • --max-urls e --max-queries-per-url definem limites explícitos, e a resposta informa quando houve truncamento.
  • --start-date e --end-date filtram as linhas diárias.
  • O Yandex mantém a própria janela móvel, então um intervalo antigo é recusado como indisponível.

Acesso

Você precisa do ID de um host verificado na sua conta do Yandex Webmaster e de um token OAuth dessa conta. O token vai em YANDEX_WEBMASTER_TOKEN ou no seu arquivo de token. O SpiderHead não cria contas nem faz login por você. O provider-discover pode listar os hosts que o token enxerga.

  • A requisição é somente leitura e não grava nada de volta no Yandex.
  • Sem o ID do host, o comando não é executado.
  • O SpiderHead confere o host na sua conta antes de pedir as consultas.

Mantenha junto ao rastreamento

O sources-sync pode guardar as evidências diárias do Webmaster em um histórico SQLite local, para acumular dados além do que a API devolve de uma vez. O evidence-join anexa linhas associadas por URL a um rastreamento e lista candidatos a páginas órfãs para revisão. Nenhuma das duas etapas altera o rastreamento.

  • Use --source webmaster ou webmaster_history com o sources-sync.
  • URLs que existem só no rastreamento, só fora dele ou sem chave de associação ficam identificadas e separadas.
  • Os registros guardados podem incluir consultas e URLs, então mantenha esses arquivos fora do Git.

Três passos, um rastreamento salvo

  1. Aponte para um host verificado

    O comando precisa de um ID de host do Yandex Webmaster de um site que você verificou, além do token OAuth configurado localmente. Sem o ID do host, ele não é executado.

  2. Busque as consultas de uma URL

    Peça uma página exata com --url ou um grupo com --url-contains. Os limites são explícitos: --max-urls e --max-queries-per-url, com --start-date e --end-date opcionais.

  3. Junte as linhas ao seu rastreamento

    Mantenha as linhas de URL e de consulta separadas. A etapa evidence-join anexa as linhas associadas por URL a um rastreamento e lista candidatos a páginas órfãs para revisão, sem alterar o rastreamento.

Um comando

bash
seohead webmaster-url-queries --url https://example.com/

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

O que você precisa

  • Um ID de host verificado no Yandex Webmaster (--host-id)
  • Um token OAuth do Yandex com acesso a esse host
  • Uma URL exata ou um trecho de URL

Limites

  • Só é possível ler hosts verificados na sua própria conta.
  • O Yandex guarda os dados de consultas por uma janela móvel limitada. Um intervalo de datas que termina há mais de 14 dias é recusado.
  • Os resultados têm limite, e um resultado truncado é marcado como tal.
  • Outras operações do Webmaster, como indexação e diagnósticos, rodam pelo provider-collect, não por este comando.

Perguntas

Preciso de um host verificado no Yandex Webmaster?
Sim. O comando recebe um ID de host verificado (--host-id) e um token OAuth configurado na sua máquina. O SpiderHead não cria contas nem faz login por você.
Isso altera alguma coisa no Yandex ou no meu site?
Não. É uma requisição somente leitura. Ela devolve estatísticas de consultas para as URLs que você indicar e não grava nada no Yandex nem no site.
Os cliques e as posições são somados entre páginas?
Não. Cada URL mantém as próprias linhas de consulta. CTR e posição média não são somados entre páginas, e a resposta informa os limites aplicados.
Quanto custa?
Nada além da cota da API do Yandex Webmaster. O toolkit lista o provedor como gratuito dentro dessa cota.
Posso guardar um histórico além da janela da API?
Sim, com o sources-sync. Ele guarda as evidências diárias do Webmaster em um histórico SQLite local, então você acumula dados ao longo do tempo. Não consegue recuperar dias que o Yandex deixou de devolver.
Posso usar com um assistente de IA?
Sim. O servidor MCP local expõe a mesma operação como seo_webmaster_url_queries.

Continue explorando

Do blog e do glossário

Yandex WebmasterGlossário

Mais neste grupo · Fontes de dados

Integração com o Google Search ConsoleRecursoDados do GA4 e do Yandex MetrikaRecursoRelató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