receita

Receita: auditoria de conteúdo

Um inventário em CSV com sinais objetivos e uma regra de decisão: manter, atualizar, fundir ou remover.

resposta curtaUma auditoria de conteúdo começa por um inventário: cada URL com título, tamanho, estrutura, imagens sem texto alternativo, links e data de modificação. Gere esse CSV com um script WP-CLI, cruze com os dados do Search Console e decida página a página entre manter, atualizar, fundir ou remover. Os números apontam suspeitas; a decisão exige leitura humana.
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

  1. 01Gere o inventário em CSV com o script.
  2. 02Exporte do Search Console cliques e impressões por página.
  3. 03Cruze as duas tabelas pela URL.
  4. 04Aplique a regra de decisão e marque cada página.
  5. 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:

SinaisPerguntaDecisão provável
Cliques altos, dias desde modificação altoso conteúdo continua correto?atualizar e datar a revisão
Impressões, poucos cliquestí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 entradaresolve algo?ampliar, fundir ou remover
Imagens sem altacessibilidade e contextocorrigir
Zero links internos de saídaficou 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.

  1. Confira se o CSV tem o mesmo número de linhas que wp post list --post_type=post --post_status=publish --format=count.
  2. Escolha dez linhas ao acaso e confira os números abrindo o post (contagem de palavras com tolerância de alguns por cento).
  3. Verifique que acentos e vírgulas dos títulos estão intactos ao abrir em planilha com codificação UTF-8.
  4. Depois do primeiro ciclo, rode de novo e compare.

Erros comuns e como desfazer

ErroEfeitoCorreção
Apagar por palavras < 300perde respostas curtas boasdecida por utilidade
Atualizar só a datasinal falso de revisãomude o conteúdo de verdade
Cruzar URLs não padronizadaslinhas sem correspondêncianormalize antes
Fundir sem redirecionarlinks externos quebrados301 para a página mantida
Rodar em horário de picolentidãoagende

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

  1. WP-CLI eval-file, WP-CLI Handbook (2026-10-14)
  2. HTTP status codes, and network and DNS errors, Google Search Central (2026-02-04)
  3. fputcsv, PHP Manual (2026-10-14)
  4. 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.