A maioria das equipes já tem um relatório de ranking do Google. É a aba Desempenho do Search Console, ordenada por cliques e printada num slide. Ela mostra posições. Não mostra o que mudou, por que mudou nem o que alguém deveria fazer a respeito.
Este fluxo resolve isso numa sentada. Você define um conjunto de consultas, entrega ao Codex um contrato de relatório por escrito e deixa que ele produza o mesmo formato toda semana. A primeira montagem leva cerca de 90 minutos. Cada rodada seguinte leva menos de dez.
O fluxo inteiro: exportações cruas entram, um relatório de formato fixo sai e uma decisão humana acontece no fim.
O que você vai ter no final
Para quem é: para quem responde pelo relatório de um site e já tem acesso ao Search Console. Você não precisa ser desenvolvedor, mas precisa de um lugar para guardar arquivos que o Codex consiga ler.
O que você terá ao terminar: um modelo de relatório salvo, um arquivo de instruções por escrito que o Codex segue em toda rodada e um relatório completo de uma semana real.
Pré-requisitos: uma propriedade verificada no Search Console, uma lista de 20 a 50 consultas que você realmente acompanha, um Codex com acesso a uma pasta de projeto e permissão de leitura no repositório do seu site se quiser a versão avançada.
Definição de pronto: você entrega o relatório para alguém que não trabalha com SEO e essa pessoa consegue dizer quais três consultas olhar e por quê.
Tempo: cerca de 90 minutos na primeira montagem, menos de 10 minutos por rodada depois disso.
Por que o relatório de Desempenho não é um relatório de ranking
O Search Console entrega quatro colunas: cliques, impressões, CTR e posição média. Isso é uma tabela de medição. Um relatório de ranking precisa responder a outro conjunto de perguntas, e os sinais de 2026 deixaram essa distância maior do que era.
A pesquisa com especialistas da Zyppy, publicada em 9 de setembro de 2026, reuniu 13.665 pontos de dados de 131 profissionais. Sinais de clique e comportamento ficaram em 29,4%, sinais de marca em 27,0% e saúde técnica de SEO em 17,5%. Dois dos três sinais que superam a saúde técnica são invisíveis numa coluna de posição. Nosso detalhamento do que esses números mudam está no guia prático, mas a versão curta para relatórios é esta: se o seu relatório só mostra posições, você está reportando o sinal que menos se moveu.
É essa lacuna que o Codex fecha. Ele não vai dizer por que o Google mudou algo. Vai montar a evidência da mudança de forma consistente o suficiente para que você consiga.
Antes de começar: quatro decisões
Tome essas decisões antes de escrever qualquer coisa, porque mudá-las depois significa refazer o relatório.
- O conjunto de consultas. De 20 a 50 consultas, agrupadas em dois ou três baldes que acompanhem o jeito que o negócio pensa. "Produto", "comparação", "suporte" funciona melhor que "alto volume / médio / baixo".
- A janela de comparação. Compare os últimos 28 dias com os 28 anteriores. Janelas mais curtas são ruidosas; mais longas escondem a mudança que você procura.
- O limiar. Decida o que conta como digno de relato. Uma consulta que se move mais de cinco posições, ou impressões que variam mais de 30% com cliques estáveis, são padrões razoáveis.
- O local de armazenamento. Uma pasta, uma regra de nomes.
reports/ranking/YYYY-MM-DD.mdmais uma subpastadata/para as exportações cruas. O Codex precisa de um lugar consistente para escrever.
Passo 1: exporte os dados crus
Abra o Search Console, selecione a propriedade e vá em Desempenho. Defina o intervalo para 56 dias, para que a comparação de 28 contra 28 seja possível a partir de uma única exportação, e use o botão Exportar para baixar o CSV da aba Consultas.
Faça o mesmo para Páginas e para Dispositivos, se pretende relatar a divisão entre celular e desktop.
Saída esperada: três arquivos CSV em data/, nomeados com a data da exportação.
Verificação de qualidade: abra o CSV de consultas e confirme que a primeira linha de dados não é uma consulta contendo a palavra "anonymous". O Search Console omite consultas raras, e essas linhas apareceriam no relatório como movimentação sem nome.
Se falhar: se a exportação vier cortada, seu intervalo é largo demais para o limite de linhas. Exporte janelas de 28 dias separadamente e deixe o Codex concatenar.
Passo 2: escreva o contrato do relatório
É este passo que decide se o fluxo sobrevive à terceira semana. Coloque o contrato num arquivo que o Codex leia em toda rodada: AGENTS.md na raiz do projeto, ou um arquivo de instruções dedicado na pasta de relatórios.
O contrato precisa de cinco coisas e de nada além disso:
Bloco do contrato | O que escrever | Por que importa |
|---|---|---|
Entradas | Caminhos exatos dos arquivos e a regra de intervalo de datas | Impede o agente de inventar uma janela |
Limiares | Suas faixas, em números | Transforma uma tabela em uma decisão |
Formato da saída | As três seções, nesta ordem | Mantém a semana 30 comparável à semana 1 |
Regras de confiança | O que dizer quando os dados não explicam uma mudança | Evita bobagem confiante |
Fronteiras | O que o agente não pode fazer | Somente leitura até você confiar nele |
Uma versão que funciona é assim:
## Contrato do relatório de ranking
Entradas: data/queries-*.csv, data/pages-*.csv
Janela: últimos 28 dias contra os 28 anteriores. Declare as duas datas no cabeçalho.
Relate apenas três coisas:
1. Consultas que se moveram: qualquer consulta que andou mais de 5 posições, ou
impressões subindo mais de 30% com cliques estáveis, ou qualquer consulta que
saiu do top 10.
2. Explicação provável: use só os dados dos arquivos. Se os arquivos não
explicarem a movimentação, escreva "não explicado por estes dados".
3. Verificar na próxima semana: uma linha por consulta sinalizada, nomeando a
página ou a consulta exata a inspecionar.
Nunca afirme uma causa que você não consiga apontar nos dados. Nunca recomende
mudança no site. Nunca edite arquivo fora de reports/ranking/.Saída esperada: um arquivo de instruções, versionado ou salvo ao lado dos dados.
Verificação de qualidade: leia o contrato em voz alta. Se alguma linha puder valer para outro site sem edição, ela é vaga demais para restringir qualquer coisa.
Se falhar: se o Codex continuar acrescentando seções, o formato de saída não está específico o bastante. Nomeie os três títulos exatamente como você os quer.
Anatomia do relatório. O rodapé que lista os arquivos exatos usados é a parte em que quem revisa mais confia, e a que a maioria dos modelos deixa de fora.
Passo 3: gere o primeiro relatório
Aponte o Codex para a pasta e peça um relatório seguindo o contrato. Peça o arquivo, não uma resposta de chat, para que a saída seja revisável e comparável por diff.
A primeira rodada é onde você descobre como seus dados realmente são. Conte com duas ou três rodadas de correção. Isso é normal e é a parte mais barata do fluxo inteiro.
Saída esperada: reports/ranking/YYYY-MM-DD.md com um cabeçalho, três seções e um rodapé listando os arquivos exatos usados.
Verificação de qualidade: pegue duas consultas sinalizadas e confira os números à mão no Search Console. Se baterem, o pipeline está sólido. Se não, pare e conserte o passo dos dados. Não depure a análise em cima de uma entrada quebrada.
Se falhar: a falha mais comum é uma divergência de datas entre a exportação e o contrato. Fixe as duas datas no cabeçalho em toda rodada, para que um descompasso de dois dias não transforme em silêncio um mês estável numa queda geral.
A primeira versão que montei relatou onze consultas movimentadas numa semana em que quase nada tinha se movido. O contrato estava certo; a exportação não. Um arquivo de 30 dias comparado com uma janela de 28 fez dois dias faltantes parecerem um colapso do site inteiro. Agora o contrato se recusa a rodar se os dois intervalos não baterem, e essa falha não voltou.
Passo 4: acrescente a linha que o agente não consegue escrever
Todo relatório ganha um parágrafo humano: o que lançamos, mudamos ou quebramos na semana passada.
Isso não é enfeite. É o jeito mais rápido de pegar um agente atribuindo o seu próprio lançamento a uma atualização de algoritmo. Quando o relatório diz que um grupo de páginas de produto caiu e a sua nota diz que o modelo mudou na terça, a explicação se estreita na hora.
Saída esperada: duas ou três frases no topo do relatório, escritas por uma pessoa.
Verificação de qualidade: se a nota e a seção de movimentação se contradizem, a contradição é a linha mais valiosa do relatório. Deixe-a visível em vez de alisá-la.
Passo 5: verifique antes de enviar
Rode estas três checagens antes de o relatório sair da sua mesa.
- Datas. As duas janelas declaradas no cabeçalho, batendo com a exportação.
- Duas conferências pontuais. Duas consultas sinalizadas verificadas à mão.
- Uma checagem de contradição. Alguma explicação afirmada cita dados que não estão na lista de arquivos no rodapé?
Se as três passarem, o relatório pode ser compartilhado com segurança. É um rascunho do seu julgamento, não um substituto para ele.
O caminho avançado, quando você estiver pronto
Rode o fluxo à mão por quatro semanas primeiro. Só automatize depois de ter corrigido o mesmo tipo de erro duas vezes.
Depois disso, as melhorias são incrementais:
- Agende a rodada. Uma execução semanal agendada escreve o relatório antes de você abrir o notebook. Mantenha o parágrafo humano como campo obrigatório, para que o relatório não possa sair sem ele.
- Guarde snapshots no controle de versão. Cada rodada vira um commit. O diff entre duas semanas é uma leitura mais rápida do que qualquer um dos dois relatórios.
- Adicione uma segunda propriedade. Consultas de concorrentes ou de marca ficam num relatório separado com o mesmo contrato, não misturadas no principal.
- Adicione um sinal externo. Uma checagem de busca de marca ou de share of answer torna o sinal de marca da pesquisa de 2026 mensurável em vez de teórico.
O que não automatizar: o passo da recomendação. No momento em que um agente começa a propor mudanças no site, você saiu do relatório para a publicação, e a carga de revisão sobe mais rápido do que o tempo economizado.
Solução de problemas
Sintoma | Causa provável | Correção |
|---|---|---|
Toda consulta parece ter caído | Descompasso de intervalo de datas entre exportações | Fixe as duas janelas no contrato e no cabeçalho |
O relatório está vazio | Limiares rígidos demais para o seu nível de tráfego | Baixe o limiar de impressões antes de baixar o de posição |
As mesmas cinco consultas toda semana | O conjunto de consultas é estreito demais | Inclua consultas de cauda longa e de comparação nos baldes |
Movimentação sem explicação | Normal em consultas de baixo volume | Mantenha a saída "não explicado por estes dados" e siga em frente |
Números diferentes do Search Console | Propriedade ou filtro divergentes na exportação | Exporte sempre da mesma propriedade e do mesmo conjunto de filtros |
Mantenha o fluxo
Três hábitos de manutenção mantêm isso útil depois do primeiro trimestre.
Revise o conjunto de consultas a cada trimestre. Um relatório que persegue as prioridades do ano passado é aula de história, não relatório de ranking.
Releia o contrato quando o Search Console mudar. O Google atualiza periodicamente a interface do relatório de Desempenho e os campos de exportação. Se um campo sumir, o contrato precisa de ajuste no mesmo dia.
Guarde os relatórios antigos. Comparar o relatório deste trimestre com o mesmo trimestre do ano passado é o único jeito barato de separar queda real de sazonalidade.
Perguntas frequentes (FAQ)
Preciso do Codex especificamente? Não. O fluxo funciona com qualquer agente que leia arquivos, rode em agenda e escreva uma saída revisável. O Codex se encaixa bem quando o seu site já vive num repositório, porque o relatório vira um commit que você pode comparar.
Dá para fazer só com ferramentas gratuitas? Dá. O fluxo inteiro roda com dados do Search Console, que são gratuitos, mais o agente. Você só precisa de um rastreador de posições pago quando quer posições de concorrentes ou posições que não aparecem na sua própria propriedade.
Qual a diferença para o relatório de Desempenho do Search Console? O relatório de Desempenho mostra uma tabela. Este fluxo produz uma decisão: quais consultas cruzaram um limiar, o que os dados explicam e não explicam, e o que inspecionar na próxima semana. Ele também guarda registro, o que a interface não faz.
E se o meu site tiver pouquíssimo tráfego? Baixe o limiar de impressões e compare 28 dias com os mesmos 28 dias do ano passado, em vez dos 28 anteriores. Sites de baixo volume tiram mais sinal de comparações ano a ano do que de semana a semana.
O relatório deve incluir AI Overviews ou citações de IA? Se quiser, adicione uma seção separada com contrato próprio. Deixe fora do relatório de posições, porque as fontes e a medição são diferentes, e misturar deixa os dois mais difíceis de ler.
Autor: Leo Harrington, tradutor de análise de SEO para mais de 500 relatórios executivos na Auspia. Leo escreve sobre transformar dados de busca em relatórios sobre os quais um não especialista consegue agir.
