E1 · Importar e gerar
15 minImporte a pasta de exemplo (ou os seus CSV) e gere o relatório de um site.
Pronto quando: o terminal mostra a linha "semana … sem marca … pauta …" e o relatorio.html abre com a série semanal.
Aula 4 · 17 min
gsc-historico: o Search Console para sempre
O Search Console guarda 16 meses. Daqui a dois anos, a semana em que o seu site começou a ser achado por quem não conhece a sua marca terá sumido. O gsc-historico importa o CSV semanal num banco local que nunca apaga nada e monta o relatório que importa: marca, sem marca e anônimas, o que subiu, o que caiu e a pauta.
Começar a aula
Nesta aula você vai
- 1De onde vem o CSV e o que é "anônimas"
- 2Importar sem duplicar e gerar o relatório
- 3Ler a série semanal e o subiu/caiu
- 4Pauta e página sem clique: regras da ferramenta, não do Google
Objetivo: importar os CSV semanais num banco que não apaga e ler marca × sem marca × anônimas, a pauta e as páginas sem clique.
01Do Search Console ao histórico
Toda semana o mesmo caminho. Clique em cada etapa.
Clique em cada bloco do diagrama para ver o que ele faz.
O dado é do Google; a memória longa é sua.
02Ler o que o relatório mostra
Clique em cada lista.
1. Série
Marca é quem já te conhece. Sem marca é gente nova chegando pelo assunto. Anônimas é o que o Google esconde por ser raro: total menos marca menos sem marca.
Acompanhe as impressões e os cliques sem marca, semana a semana.
Caso real do INEMA
inema.club, de 16–22/09 a 05–11/10: impressões sem marca de 8 para 157 e consultas sem marca de 3 para 51, com 0 clique sem marca. Os 2 primeiros cliques sem marca vieram no inema.pro (2/293), puxados por "curso jev".
2. Subiu e caiu
Soma impressões e cliques de cada consulta, semana atual contra a anterior. A posição mostrada é a melhor entre as páginas.
Consulta que cai várias semanas seguidas é sinal para olhar a página dela.
3. Pauta
Consulta nova (nunca vista no banco) sem página dona vira pauta: escreva uma página feita para ela.
Página dona é uma regra desta ferramenta: alguma página na 1ª página do Google, ou com palavra da consulta no endereço.
Decida você
A regra compara palavras com o endereço, não com o conteúdo. Uma página em espanhol pode já aparecer para a consulta, fora da 1ª página, e mesmo assim a consulta sair como pauta. A coluna paginas_hoje mostra quem aparece hoje.
4. Sem clique
Página com 5+ impressões sem marca na semana e 0 clique: reescreva título e descrição com uma promessa específica.
Ela pode ter clique de marca; a lista olha só as buscas sem marca.
03Importar e gerar o relatório
Rode a partir da pasta ferramentas/gsc-historico. O exemplo usa os CSV reais do inemaSEO que vêm no repositório.
Terminal · importar (pasta ou arquivos)
cd ferramentas/gsc-historico python3 gsc_historico.py importar ../../exemplos/gsc-historico/entrada --db dados/gsc.sqlite
Terminal · relatório de um site
python3 gsc_historico.py relatorio --db dados/gsc.sqlite --site inema.club --saida saida/inema.club # outra comparação: --atual AAAA-MM-DD --anterior AAAA-MM-DD
Terminal · toda semana, com os seus CSV
# depois do gsc_semanal.py (inemaseo-metodo), aponte para a pasta dele python3 gsc_historico.py importar ~/caminho/da/pasta/gsc --db dados/gsc.sqlite python3 gsc_historico.py relatorio --db dados/gsc.sqlite --site <seusite.com> --saida saida/<seusite.com>
Modelo · modo API (usa a API do Google; não rodado neste curso)
# roda o gsc_semanal.py com a sua credencial (gcloud) e importa; não testado ao vivo pelo autor python3 gsc_historico.py puxar --script ~/projetos/inemaseo-metodo/tools/gsc_semanal.py --pasta dados/gsc-csv
Exemplo do repositório
importado: 10 linha(s) de resumo, 244 linha(s) de consulta → dados/gsc.sqlite inema.club semana 2026-10-11 (comparada com 2026-10-04): sem marca 0 cliques / 157 impr.; subiram 15, caíram 15, pauta 18, páginas sem clique 5 → saida/inema.club/relatorio.html inema.pro semana 2026-10-11 (comparada com 2026-10-04): sem marca 2 cliques / 293 impr.; subiram 15, caíram 5, pauta 6, páginas sem clique 6 → saida/inema.pro/relatorio.html
Início do pauta.csv (consulta, impressões, melhor posição, página que aparece hoje):
ia para principiantes,6,38.5,…/es/aprender-inteligencia-artificial/ guía ia principiantes,5,60.8,…/es/aprender-inteligencia-artificial/ tutorial ia desde cero,5,29.4,…/es/aprender-inteligencia-artificial/
Início do paginas_sem_clique.csv:
…/es/aprender-inteligencia-artificial/,106 impr.,posição 39.1,22 consultas https://buscas.inema.club/,12 impr.,posição 26.6,6 consultas
A página em espanhol já aparece para essas consultas; a regra de página dona não a reconhece porque as palavras não estão no endereço. Aqui a decisão é melhorar a página que existe, não escrever outra.
- Somar semanas sobrepostas: 27/09–03/10 e 28/09–04/10 dividem dias; o banco guarda as duas e o relatório avisa.
- Ler pauta como ordem: é heurística; confira a coluna da página que aparece hoje.
- Pôr o banco no git: fica em dados/, que o .gitignore já tira.
04Prática: o seu histórico
Sem CSV seu ainda? Faça com o exemplo e volte quando o gsc_semanal.py rodar.
E2 · Três decisões de pauta
20 minPegue 3 consultas da pauta e decida para cada uma: escrever página nova ou melhorar a que já aparece (coluna da página de hoje).
Pronto quando: 3 linhas com consulta, decisão (nova ou melhorar) e a URL da página que você faria ou mudaria.
05Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 4
Por que guardar o Search Console num banco local?competência
Correto
O dado é o mesmo; a diferença é a memória. Sem arquivar, a história do site some depois de 16 meses.Não é essa
O dado é o mesmo; a diferença é a memória. Sem arquivar, a história do site some depois de 16 meses.Rever: Do Search Console ao históricoPergunta 2 de 4
Total 114 cliques, marca 87, sem marca 0. De onde vêm os outros 27?
Correto
É a semana de 05–11/10 do inema.club. Anônimas = total menos marca menos sem marca. Por isso as três colunas nunca batem sem ela.Não é essa
É a semana de 05–11/10 do inema.club. Anônimas = total menos marca menos sem marca. Por isso as três colunas nunca batem sem ela.Rever: Ler o que o relatório mostraPergunta 3 de 4
Uma consulta saiu como pauta, mas a coluna da página de hoje mostra uma página sua aparecendo, fora da 1ª página. O que fazer?
Correto
A regra compara palavras da consulta com o endereço. Se uma página já aparece, melhorar costuma valer mais que criar uma concorrente dentro do próprio site.Não é essa
A regra compara palavras da consulta com o endereço. Se uma página já aparece, melhorar costuma valer mais que criar uma concorrente dentro do próprio site.Rever: Importar e gerar o relatórioPergunta 4 de 4
Qual é o número que mostra gente nova chegando pelo assunto?
Correto
Marca é quem já te conhece. O sem marca mede se o conteúdo atrai quem ainda não conhece o site.Não é essa
Marca é quem já te conhece. O sem marca mede se o conteúdo atrai quem ainda não conhece o site.Rever: Ler o que o relatório mostraTeste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.Escolha uma alternativa. A explicação aparece depois da sua tentativa.
06Para levar
MemóriaCSV semanal → SQLite que nunca apaga; reimportar não duplica.
O númeroSem marca, semana a semana; anônimas explicam a diferença.
PautaHeurística da ferramenta: confira a página que já aparece antes de escrever outra.