Criar páginas otimizadas em escala no WordPress para SEO programático: guia técnico

Como transformar uma planilha com 50 mil combinações de serviço + cidade em páginas WordPress que realmente ranqueiam — sem derrubar o servidor nem cair em penalidade de conteúdo duplicado?

A resposta não está em instalar um plugin “gerador de páginas” e torcer para o Google indexar. Está em arquitetura: custom post types bem modelados, templates que injetam dados únicos por URL, pipeline de inserção que respeita limites do banco e monitoramento contínuo de cobertura no Search Console.

Modelagem de dados: a base que evita retrabalho

Antes de escrever uma linha de código para geração, defina o modelo de dados. Cada página programática precisa de: entidade principal (serviço/produto), modificadores geográficos (cidade, bairro, região), atributos únicos (preço médio, tempo de execução, especificações técnicas) e identificadores estáveis (slug canônico, ID externo).

Registre um Custom Post Type (CPT) dedicado — nunca use post ou page nativos. Exemplo mínimo no functions.php ou plugin:

function registrar_cpt_servico_local() {
    $labels = [
        'name' => 'Serviços Locais',
        'singular_name' => 'Serviço Local',
    ];
    $args = [
        'labels' => $labels,
        'public' => true,
        'publicly_queryable' => true,
        'show_ui' => true,
        'show_in_rest' => true,
        'has_archive' => true,
        'rewrite' => ['slug' => 'servico', 'with_front' => false],
        'supports' => ['title', 'editor', 'thumbnail', 'custom-fields'],
        'taxonomies' => ['cidade', 'categoria_servico'],
        'capability_type' => 'post',
    ];
    register_post_type('servico_local', $args);
}
add_action('init', 'registrar_cpt_servico_local');

Crie taxonomias hierárquicas para cidade (estado > cidade > bairro) e categoria_servico. Isso permite URLs como /servico/encanamento/sp/sao-paulo/jardins/ e facetas de navegação naturais.

URLs semânticas e rewrite rules customizadas

O WordPress gera permalinks baseados na estrutura do CPT, mas SEO programático exige controle granular. Registre rewrite rules que mapeiam padrões de URL para query vars internas:

function rewrite_servico_local() {
    add_rewrite_tag('%servico%', '([^/]+)');
    add_rewrite_tag('%cidade%', '([^/]+)');
    add_rewrite_tag('%bairro%', '([^/]+)');
    add_rewrite_rule(
        '^servico/([^/]+)/([^/]+)/([^/]+)/?$',
        'index.php?post_type=servico_local&servico=$matches[1]&cidade=$matches[2]&bairro=$matches[3]',
        'top'
    );
}
add_action('init', 'rewrite_servico_local');

Após deploy, flushe as rewrite rules uma vez (Settings > Permalinks > Save). Evite flush_rewrite_rules() em produção — é caro.

Template dinâmico: um arquivo, milhares de variações

Crie single-servico_local.php no tema (ou child theme). O template não contém HTML estático — ele busca dados via get_post_meta, taxonomias e campos customizados (ACF ou nativo) e monta a página:

<?php
$servico = get_queried_object();
$cidade = get_the_terms($servico, 'cidade')[0]->name ?? '';
$bairro = get_post_meta($servico->ID, 'bairro', true);
$preco_medio = get_post_meta($servico->ID, 'preco_medio', true);
$tempo_execucao = get_post_meta($servico->ID, 'tempo_execucao', true);
?>
<article class="servico-local">
  <header>
    <h1><?= esc_html($servico->post_title) ?></h1>
    <nav class="breadcrumb" aria-label="Navegação">
      <a href="/">Início</a> ›
      <a href="/servico/">Serviços</a> ›
      <a href="/servico/<?= urlencode($servico->servico_slug) ?>/"><?= esc_html($servico->servico_nome) ?></a> ›
      <a href="/servico/<?= urlencode($servico->servico_slug) ?>/<?= urlencode($cidade) ?>/"><?= esc_html($cidade) ?></a> ›
      <span><?= esc_html($bairro) ?></span>
    </nav>
  </header>
  <div class="dados-principais">
    <dl>
      <dt>Preço médio</dt><dd><?= esc_html($preco_medio) ?></dd>
      <dt>Tempo estimado</dt><dd><?= esc_html($tempo_execucao) ?></dd>
      <dt>Atendimento em</dt><dd><?= esc_html($bairro) ?>, <?= esc_html($cidade) ?></dd>
    </dl>
  </div>
  <section class="conteudo-unico">
    <?= apply_filters('the_content', $servico->post_content) ?>
  </section>
  <section class="faq-local" itemscope itemtype="https://schema.org/FAQPage">
    <!-- FAQ gerado dinamicamente por localização -->
  </section>
</article>

O segredo: post_content único por página. Não clone o mesmo texto. Use a planilha de origem para gerar parágrafos com dados reais — “Em Jardins, o preço médio de desentupimento de pia é 180, reais 15% acima da média da zona oeste”. Isso é o que separa SEO programático de doorway pages.

Pipeline de inserção em massa sem derrubar o site

Para 10k+ páginas, não use a REST API — latência HTTP e autenticação tornam lento. Use WP-CLI ou script PHP standalone que carrega wp-load.php e roda wp_insert_post em lote:

wp post create --post_type=servico_local --post_status=publish --porcelain \
  --post_title="Desentupimento de pia em Jardins, São Paulo" \
  --post_content="Conteúdo único gerado via template..." \
  --tax_input[cidade]="sao-paulo" \
  --tax_input[categoria_servico]="encanamento" \
  --meta_input='{"bairro":"Jardins","preco_medio":"180 reais","tempo_execucao":"45 min"}'

Otimizações críticas no script PHP:

1. wp_defer_term_counting(true) antes do loop, wp_defer_term_counting(false) depois
2. wp_suspend_cache_invalidation(true) durante inserção
3. set_time_limit(0) e ini_set('memory_limit', '512M')
4. Commit a cada 500 posts: wp_cache_flush() + gc_collect_cycles()
5. Log progresso e erros em arquivo, não no banco

Para volumes acima de 100k, considere static site generation (SSG) com Next.js ou Astro consumindo WordPress headless via GraphQL — o WP vira apenas CMS de dados, o front escala horizontalmente.

Sitemaps particionados e canonical automático

O WordPress 5.5+ gera sitemaps nativos, mas o limite de 50k URLs por arquivo exige particionamento. Filtre via hook:

function particionar_sitemap_servicos($args, $post_type) {
    if ($post_type === 'servico_local') {
        $args['posts_per_page'] = 2000; // 25 sitemaps para 50k posts
    }
    return $args;
}
add_filter('wp_sitemaps_posts_query_args', 'particionar_sitemap_servicos', 10, 2);

Canonical tags evitam duplicação quando a mesma página é acessada por URLs diferentes (ex: com/sem trailing slash, parâmetros UTM). No functions.php:

function canonical_servico_local() {
    if (is_singular('servico_local')) {
        $canonical = get_permalink();
        echo '<link rel="canonical" href="' . esc_url($canonical) . '" />' . "\n";
    }
}
add_action('wp_head', 'canonical_servico_local', 5);

Cache, monitoramento e o papel da equipe Pagi

Em escala, cache de objeto (Redis) é obrigatório — armazena termos, metas e queries caras. Configure no wp-config.php:

define('WP_REDIS_HOST', '127.0.0.1');
define('WP_REDIS_PORT', 6379);
define('WP_REDIS_DATABASE', 0);

No nível de página, Nginx FastCGI Cache ou Varnish servem HTML estático para usuários não-logados. Invalide cache via hook save_post_servico_local disparando purge na URL.

Monitore com dashboard admin customizado: posts publicados vs. indexados (Search Console API), erros 404 por padrão de URL, Core Web Vitals por template (CrUX API), e alertas se indexação cair >10% em 7 dias.

Conclusão prática

SEO programático no WordPress funciona quando você trata geração de páginas como engenharia de dados, não como “criação de conteúdo”. Modele o CPT, controle as URLs, injete unicidade real no template, insira em lote com otimizações de banco e monitore indexação como métrica de produto. O resto é ajuste fino.

Checklist prático

Perguntas frequentes

Na hora de estruturar presença orgânica de verdade, equipe Pagi mostra como criar páginas otimizadas em escala para o Google.