Auditoria de Portfólio GSC
Responde "como está tudo?" em todas as propriedades de uma conta do Search Console — a pergunta que as ferramentas por site não conseguem responder sem dezenas de exportações manuais.
Configuração
Requer um token de atualização OAuth com escopo https://www.googleapis.com/auth/webmasters.readonly:
export GOOGLE_GSC_CLIENT_ID=... # ou GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=... # ou GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com" # opcional, separado por vírgulas
pip install requests
A falha mais comum na configuração é unauthorized_client ao atualizar o token. Isso significa que o token de atualização foi emitido para um cliente OAuth diferente do ID/segredo que você está usando. Contas que adicionaram integrações do Google ao longo do tempo geralmente têm vários clientes; associe o par que gerou o token.
Execução
python3 scripts/audit_gsc.py # completo: ranqueamento + diff de palavras-chave para os 12 primeiros
python3 scripts/audit_gsc.py portfolio # apenas a tabela ranqueada
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90 # trimestre contra trimestre
Flags: --days (janela, comparada com a janela imediatamente anterior), --site (repetível), --top, --limit, --min-clicks.
Seções e o que significam
| Seção | Leia como |
|---|---|
| NOVO | consultas com zero cliques no período anterior. De onde o crescimento realmente está vindo. |
| SUBINDO | subiu ≥50%. Verifique se a posição também mudou — se não, a demanda aumentou, não o seu ranqueamento. |
| CAINDO | caiu ≥40% sobre uma base real. A posição diz que tipo: o ranque caiu = perda de posição; o ranque se manteve mas os cliques despencaram = algo pegou os cliques acima de você (AI Overview, um novo recurso SERP, ou a consulta mudou de forma). |
| PERDIDO | ranqueava antes, sem dados agora. |
| LACUNA DE CTR | ≥1.500 impressões, top 10, abaixo de 2% de CTR. Reescrever título e descrição, os ganhos mais baratos disponíveis. |
Interpretação
- Relate cliques primeiro, impressões depois. Uma propriedade grande pode balançar as impressões do portfólio o suficiente para mascarar que todo o resto cresceu.
- Separe marca de não-marca. Um site cujo conjunto de palavras-chave é apenas seu próprio nome (ou erros de grafia do concorrente) não tem motor de aquisição, por mais que o número de cliques pareça bom. Diga isso claramente no relatório.
- Um colapso de site inteiro em seu próprio termo de marca geralmente não é SEO. Verifique a propriedade antes de diagnosticar rankings:
whois <dominio> | grep -i "registrar\|updated date"além de verificar se ainda resolve. Domínios expirados, transferidos ou disputados produzem um precipício de ranqueamento que nenhum trabalho de SEO consertará. - "novo" na tabela do portfólio significa zero cliques na janela anterior, o que para um site recém-lançado é um lançamento, não uma lacuna de dados.
- Não pule consultas em idiomas que você não lê. Em sites multimercado, o crescimento geralmente está na cauda longa em idiomas não ingleses; traduza as interessantes em vez de filtrá-las.
- Uma propriedade retornando 403 é verificada para listagem, mas não para análises de pesquisa. O script a reporta em vez de escondê-la.
Notas
- Os dados do GSC têm um atraso de cerca de 3 dias; o script compensa isso automaticamente.
- Ambos os períodos são buscados por propriedade em paralelo, então uma conta de 40 propriedades leva segundos.
- As linhas de consulta são limitadas a 25.000 por período, bem acima do que qualquer site individual retorna para uma janela de 28 dias.