Receita: auditoria de conteúdo
Um inventário em CSV com sinais objetivos e uma regra de decisão: manter, atualizar, fundir ou remover.
Neste texto
Que problema esta receita resolve?
Sites com centenas de posts não têm quem diga quais páginas ainda servem. Conteúdo desatualizado, duplicado, fino ou sem estrutura convive com os melhores artigos e dilui o conjunto. Sem inventário, as decisões viram impressão. O inventário não decide por você, mas coloca todas as páginas na mesma régua e mostra onde olhar primeiro.
A lógica vem de plugins de auditoria de conteúdo e de análise de leitura que Camillo Dantas desenvolveu; eles não são vendidos. A receita entrega o método e o código.
Quando usar e quando não usar
Use antes de uma reformulação de blog, de uma migração ou de uma campanha de atualização, e uma vez por semestre em sites com publicação contínua.
Não use:
- para apagar páginas por critério numérico único. Um post curto pode ser a melhor resposta à pergunta que ele resolve;
- como nota de qualidade. O script mede forma, não verdade nem utilidade;
- sem os dados de desempenho. Tamanho ou idade sozinhos não dizem se a página funciona.
Pré-requisitos
- WP-CLI com acesso ao site.
- Exportação do desempenho por página do Search Console (últimos 12 meses), em CSV.
- Planilha para o cruzamento.
- Nível: intermediário.
Passo a passo
- 01Gere o inventário em CSV com o script.
- 02Exporte do Search Console cliques e impressões por página.
- 03Cruze as duas tabelas pela URL.
- 04Aplique a regra de decisão e marque cada página.
- 05Execute em lotes e registre o que mudou.
O script de inventário
Salve como auditoria.php e rode wp eval-file auditoria.php > inventario.csv. Ele lê o conteúdo salvo de cada post publicado e calcula sinais simples:
<?php
$ids = get_posts( array(
'post_type' => 'post',
'post_status' => 'publish',
'numberposts' => -1,
'fields' => 'ids',
) );
$saida = fopen( 'php://output', 'w' );
fputcsv( $saida, array(
'url', 'titulo', 'palavras', 'h2', 'imagens', 'imagens_sem_alt',
'links_internos', 'links_externos', 'dias_desde_modificacao', 'tem_resumo',
) );
$host = wp_parse_url( home_url(), PHP_URL_HOST );
foreach ( $ids as $id ) {
$html = get_post_field( 'post_content', $id );
$texto = wp_strip_all_tags( strip_shortcodes( $html ) );
$palav = preg_match_all( '/\p{L}[\p{L}\p{N}\'-]*/u', $texto );
preg_match_all( '/<h2[\s>]/i', $html, $h2 );
preg_match_all( '/<img\s[^>]*>/i', $html, $imgs );
$sem_alt = 0;
foreach ( $imgs[0] as $tag ) {
if ( ! preg_match( '/\salt=["\'][^"\']+["\']/i', $tag ) ) {
$sem_alt++;
}
}
$internos = 0;
$externos = 0;
if ( preg_match_all( '/<a\s[^>]*href=["\']([^"\']+)["\']/i', $html, $links ) ) {
foreach ( $links[1] as $href ) {
$h = wp_parse_url( $href, PHP_URL_HOST );
if ( null === $h || $h === $host ) {
$internos++;
} else {
$externos++;
}
}
}
$dias = (int) floor( ( time() - get_post_modified_time( 'U', true, $id ) ) / DAY_IN_SECONDS );
fputcsv( $saida, array(
get_permalink( $id ),
get_the_title( $id ),
$palav,
count( $h2[0] ),
count( $imgs[0] ),
$sem_alt,
$internos,
$externos,
$dias,
has_excerpt( $id ) ? 'sim' : 'nao',
) );
}
fclose( $saida );
Sobre o código: fputcsv cuida de aspas e vírgulas dentro dos títulos; a contagem de palavras usa uma expressão Unicode (\p{L}), que reconhece acentos; get_post_modified_time( 'U', true, $id ) devolve o carimbo UTC da última modificação; strip_shortcodes evita contar marcações de shortcode como texto. Conteúdo gerado dinamicamente por blocos ou shortcodes não aparece no post_content e, portanto, não é contado. Se o seu tema monta o conteúdo assim, aplique apply_filters( 'the_content', $html ) antes de analisar, aceitando que seja mais lento.
Em sites com milhares de posts, divida em lotes com offset ou rode fora do horário de pico.
Cruzamento com o Search Console
No relatório de Desempenho, aba Páginas, exporte os últimos 12 meses (cliques, impressões, CTR, posição). Na planilha, una pela URL com PROCV ou XLOOKUP. Padronize antes: mesma barra final, mesmo protocolo, sem parâmetros.
A regra de decisão
Use as colunas como filtro de suspeitas, depois leia a página:
| Sinais | Pergunta | Decisão provável |
|---|---|---|
| Cliques altos, dias desde modificação altos | o conteúdo continua correto? | atualizar e datar a revisão |
| Impressões, poucos cliques | título ou resposta fraca? | reescrever título e abertura |
| Sem cliques, assunto coberto por outra página | é redundante? | fundir na melhor página e redirecionar |
| Poucas palavras, sem cliques, sem links de entrada | resolve algo? | ampliar, fundir ou remover |
| Imagens sem alt | acessibilidade e contexto | corrigir |
| Zero links internos de saída | ficou isolada? | linkar para páginas relacionadas |
| Sem links de entrada | é órfã? | receber links de páginas do mesmo tema |
Aplique "remover" com cautela: se a página tem links externos ou tráfego, redirecione com 301 para a mais próxima (veja a receita de redirecionamentos); se não tem nada disso e não ajuda ninguém, 404 ou 410 é aceitável. O Google trata ambos como "o conteúdo não existe".
Como testar
Critério de sucesso: todas as páginas do inventário têm uma decisão registrada; as ações executadas aparecem na planilha com data; o inventário seguinte (três a seis meses depois) mostra menos imagens sem alt, menos órfãs e menos páginas desatualizadas.
- Confira se o CSV tem o mesmo número de linhas que
wp post list --post_type=post --post_status=publish --format=count. - Escolha dez linhas ao acaso e confira os números abrindo o post (contagem de palavras com tolerância de alguns por cento).
- Verifique que acentos e vírgulas dos títulos estão intactos ao abrir em planilha com codificação UTF-8.
- Depois do primeiro ciclo, rode de novo e compare.
Erros comuns e como desfazer
| Erro | Efeito | Correção |
|---|---|---|
| Apagar por palavras < 300 | perde respostas curtas boas | decida por utilidade |
| Atualizar só a data | sinal falso de revisão | mude o conteúdo de verdade |
| Cruzar URLs não padronizadas | linhas sem correspondência | normalize antes |
| Fundir sem redirecionar | links externos quebrados | 301 para a página mantida |
| Rodar em horário de pico | lentidão | agende |
O script não escreve no banco. Para desfazer ações da auditoria (remoções e fusões), restaure da lixeira (WordPress guarda por 30 dias por padrão) ou do backup.
Checklist final
- Inventário completo.
- Dados do Search Console cruzados.
- Decisão registrada em cada linha.
- Alterações com data.
- Redirecionamentos criados para o que saiu.
- Nova rodada agendada.
Para aprofundar
A atualização do que fica é tratada em conteúdo evergreen. A revisão das respostas curtas está em FAQ revisado. O método de auditoria completo é ensinado no mini-curso Auditoria de SEO na prática, e a lógica de qualidade de conteúdo no mini-curso E-E-A-T para redatores. Plugins de origem: camillodantas.com.br/plugins.
Fontes
- WP-CLI eval-file, WP-CLI Handbook (2026-10-14)
- HTTP status codes, and network and DNS errors, Google Search Central (2026-02-04)
- fputcsv, PHP Manual (2026-10-14)
- Link best practices for Google, Google Search Central (2025-12-10)
Não sabe por onde começar?
Compare as opções e escolha a trilha pelo seu objetivo.