inemaSEO 5 — Com Agentes: Claude Code e Codex fazendo o trabalho repetitivo|INEMA.CLUB-PRO

Aula 6 · 16 min

Relatório semanal automático e o agente que lê e propõe

O observador fecha a máquina: toda semana, um script junta o Search Console sem a marca, a indexação das páginas-chave e a posição das consultas-alvo num relatório. Um agente lê e propõe três ações, cada uma com a linha que a justifica. Você aprova o que vira tarefa.

Começar a aula
Dona de pequeno negócio lê com uma caneta na mão um relatório impresso com gráficos simples, numa mesa com café.

Nesta aula você vai

  1. 1O que entra no relatório e de onde vem cada número
  2. 2Agendar sem perder o controle: o cron gera, você commita
  3. 3O pedido ao agente: três propostas, cada uma com evidência
  4. 4Ler uma semana real do INEMA

Objetivo: gerar o relatório semanal sem marca e pedir ao agente 3 propostas com evidência, que você aprova antes de virar tarefa.

01Do Search Console à tarefa aprovada

Clique em cada bloco.

Clique em cada bloco do diagrama para ver o que ele faz.

O script mede; o agente sugere; você escolhe o que fazer na semana.

02Como o INEMA roda o observador

Clique em cada passo.

1. O script

No projeto de SEO do INEMA, um script roda o export sem marca, inspeciona as URLs-chave, lê as posições das consultas-alvo e escreve o relatório comparado com a semana anterior. Com a opção sem API, só remonta o relatório com o que já está salvo.

A versão pública do export é o gsc_semanal.py do método; o relatório em volta dele cabe num script curto que o agente pode montar para você.

03O export, o agendamento e o pedido ao agente

O gsc_semanal.py precisa da sua credencial do Search Console (gratuita, ver o cabeçalho do script).

Export semanal sem marca (público, método inemaSEO)
export GSC_SITES="sc-domain:seusite.com"
export GSC_MARCA="seusite|seu nome|erro comum de digitação"
export GSC_QUOTA_PROJ="<seu projeto no Google Cloud>"
python3 tools/gsc_semanal.py --dias 7 --saida dados/gsc
Agendamento (modelo de crontab: terça às 9h)
0 9 * * 2 cd ~/projetos/seo-seusite && python3 tools/gsc_semanal.py --dias 7 --saida dados/gsc >> dados/gsc/cron.log 2>&1
Pedido ao agente observador
Leia o relatório desta semana (reports/semana-*.md mais recente) e o da semana anterior.
Proponha no máximo 3 ações para esta semana. Para cada uma:
- a linha do relatório que justifica (copiada);
- o tipo: título/descrição, página nova para consulta, indexação, link interno;
- o que muda e onde;
- como vamos saber na semana que vem se funcionou.
Não altere nada, não chame API. Se a semana não mostra nada novo, diga isso em vez de inventar ação.
Exemplo do repositório
# Relatório semanal de SEO — semana até 2026-10-11

Gerado em 2026-10-13 por `scripts/gsc_relatorio_semanal.py`.

## Totais (cliques / impressões)

| site       | total     | marca    | sem marca | consultas sem marca | vs semana anterior (impr. sem marca) |
| inema.club | 114 / 702 | 87 / 238 | 0 / 157   | 51                  | ▲ +110 |
| inema.pro  | 11 / 761  | 5 / 116  | 2 / 293   | 52                  | ▲ +279 |

## Indexação das URLs-chave (inspeção de 2026-10-13)
| /eventos/ | URL is unknown to Google | - | = |

Indexadas: 13 de 14.

Trecho do relatório real; as tabelas de consultas foram omitidas.

04Prática: uma semana do seu site

Se ainda não tem a credencial da API, exporte as consultas da semana pelo painel do Search Console (Desempenho → Exportar) e use o CSV.

E1 · O relatório da semana

40 min

Rode o export sem marca da última semana (ou exporte pelo painel) e peça ao agente um relatório em Markdown com totais, marca, sem marca e as 15 consultas sem marca com mais impressões.

Pronto quando: existe um arquivo reports/semana-[data].md com os totais separados por marca e sem marca, e os números batem com o painel do Search Console.

E2 · Três propostas e a sua decisão

20 min

Passe o pedido do observador ao agente. Confira cada linha citada no relatório e decida.

Pronto quando: você tem até 3 propostas, cada uma com a linha copiada do relatório e a sua decisão (aprovada, com a tarefa criada, ou recusada, com o porquê).

05Teste o que aprendeu

A explicação aparece depois da sua resposta.

Pergunta 1 de 4

O cron gera o relatório toda terça. Quem faz o commit?competência

06Para levar

Uma rodada por semanaSem marca, indexação e consultas-alvo, comparados com a semana anterior.
Cron gera, você guardaO agendamento produz arquivos; o commit é seu.
Três propostas com evidênciaO agente sugere; cada sugestão cita a linha; você aprova.
Régua de 2026O número que mostra se o SEO funciona é o de buscas sem a sua marca.

Para ir além

Aula anteriorPróxima aula