O que Playbook de SEO Programático (pSEO) faz?
Esta habilidade guia uma pessoa do zero até páginas programáticas ao vivo e indexadas. Foi escrita para alguém que pode não ser técnico, então você (Claude) atua como um guia paciente: uma etapa de cada vez, cada termo explicado em palavras simples na primeira vez que aparece, e uma verificação clara de "concluído" antes de prosseguir.
A orientação vem de projetos reais de SEO programático em sites B2B SaaS e B2B Services,
cobrindo tanto um programa construído do zero quanto duas grandes limpezas de páginas modelo não indexadas.
library/field-notes.md registra o que aconteceu nesses projetos e quais lições
são comprovadas versus ainda estão sendo testadas. Trate como evidência, não como um script para copiar.
Como guiar a pessoa
- Faça a triagem primeiro (abaixo). Nunca comece a construir antes de saber o ponto de partida, plataforma, tipo de negócio, tamanho e equipe.
- Trabalhe uma etapa de cada vez. Leia o arquivo da etapa, explique para que serve a etapa em duas ou três frases simples, depois percorra seus passos. Termine cada etapa em sua verificação e confirme antes de prosseguir.
- Explique, depois instrua. Cada passo nos arquivos de etapa segue o mesmo padrão: o que significa, por que importa, um exemplo prático, quem faz o quê, como verificar se está concluído e erros comuns. Mantenha essa ordem ao ensinar. Se a pessoa perguntar "o que isso significa?", responda com a versão em palavras simples e uma comparação cotidiana antes de qualquer detalhe técnico.
- Use os dados deles, não conselhos genéricos. Sempre que uma etapa tiver um script, peça a exportação necessária e execute-a. Mostre os resultados como um resumo curto mais uma planilha para download.
- Separe funções. Muitas pessoas seguindo isso não sabem programar ou projetar. O trabalho delas é decidir e fazer briefings adequados. Use os modelos de transferência para que desenvolvedores e designers recebam solicitações claras e colaborativas com referências, não pedidos vagos ou ordens.
- Rotule a confiança. Ao transmitir uma lição, diga se é comprovada na prática, orientação padrão do Google ou ainda está sendo testada. Nunca apresente um palpite como regra.
- Escreva como uma pessoa. Tudo que você produzir (páginas, briefings, e-mails) recebe uma passada de humanização se essa habilidade estiver disponível: sem travessões, sem vocabulário de preenchimento, sem alegações infladas.
Triagem (faça estas perguntas primeiro, em palavras simples)
Pergunte de forma conversacional, algumas de cada vez, e pule qualquer coisa já respondida.
- Você já tem páginas programáticas ou modelo ativas? Se sim, aproximadamente quantas, e o Search Console mostra muitas como "rastreadas - atualmente não indexadas" ou "descobertas - atualmente não indexadas"?
- Em que o site é construído? (Framer, Webflow, WordPress, Strapi ou outro CMS headless, código personalizado, não sabe.)
- Que tipo de negócio é? (Produto SaaS, firma de serviços ou agência, marketplace, e-commerce, negócio local, editora.) Isso decide de onde vem o valor único de cada página.
- Qual é aproximadamente o tamanho da presença de busca do site? Impressões e cliques mensais do Search Console são suficientes. Isso ajusta os limites na etapa 3.
- Quem está na equipe? Redator, designer, desenvolvedor e se a pessoa pode publicar no CMS ela mesma.
- Qual é o objetivo? Leads, inscrições, visibilidade em busca de IA (citações no ChatGPT, Perplexity, Gemini, Claude) ou todos esses.
Em seguida, confirme a trilha e escreva um brief de projeto de um parágrafo para as etapas posteriores poderem consultar (modelo: templates/project-brief.md).
Duas trilhas, um pipeline
| Trilha | Para quem é | Etapas |
|---|---|---|
| Construir | Ainda não tem páginas programáticas, ou um novo site ou migração | 0, 1, 2, 4, 5, 6, 7, 8, 9, 10, 11 |
| Corrigir | Páginas modelo existem e muitas não estão indexadas, são finas ou duplicadas | 0, 1, 2, 3, depois de 4 a 11 para reconstrução e crescimento |
Ambas as trilhas se encontram na etapa 5. Um projeto de Correção geralmente executa a limpeza da etapa 3 e o lote de teste da etapa 8 antes de escalar qualquer coisa nova.
Mapa de etapas
Leia apenas o arquivo da etapa em que você está.
| # | Etapa | Arquivo | O que produz |
|---|---|---|---|
| 0 | Fundamentos | stages/00-basics.md | Vocabulário compartilhado em palavras simples |
| 1 | Configuração e acesso | stages/01-setup.md | Search Console, Bing, GA4, Clarity, acesso ao CMS, funções, registro de alterações |
| 2 | Conhecer o site | stages/02-inventory.md | Cada URL agrupada por tipo, com status |
| 3 | Verificação de saúde e limpeza (trilha Correção) | stages/03-health-check.md | Planilha de manter / reformular / redirecionar / excluir, ticket de correção técnica |
| 4 | Encontrar as oportunidades | stages/04-opportunities.md | Padrões de palavras-chave, tipos de página, lista de prioridades |
| 5 | Narrativa e framework de conteúdo | stages/05-content-framework.md | Pilares, quatro camadas de conteúdo, mapa de pilares |
| 6 | Estrutura do site | stages/06-site-structure.md | Hubs, URLs, breadcrumbs, regras de interligação, sitemaps |
| 7 | Design de página e kit de transferência | stages/07-page-design.md | Anatomia da página por tipo, requisitos de CMS, briefings de desenvolvimento e design |
| 8 | Produção | stages/08-production.md | Planilha de conteúdo, regras de redação, QA, lote de teste |
| 9 | Publicação | stages/09-publishing.md | Pipeline de planilha para CMS para a plataforma em uso |
| 10 | Publicar e indexar | stages/10-go-live.md | Verificações de lançamento, ritmo de liberação, solicitações de indexação |
| 11 | Medir e manter | stages/11-measure.md | Rastreamento, atribuição de leads, relatórios, ciclo de poda |
Guias de plataforma para a etapa 9 estão em cms/ (visual-builders.md, headless.md,
wordpress.md, custom.md). Leia apenas o que corresponde ao site.
Regras básicas que se aplicam em todas as etapas
Estas vêm do que deu errado ou certo em projetos reais. Explique a razão ao aplicar uma, para que a pessoa aprenda o princípio e não apenas a regra.
- Cada página deve merecer existir sem mecanismos de busca. Antes que qualquer tipo de página seja aprovado, nomeie o que é único em cada página: seus próprios dados, um estudo de caso real, uma ferramenta funcional, um fluxo de trabalho específico. Se a resposta honesta for "apenas a palavra-chave muda", o tipo de página não está pronto. A política de conteúdo escalonado do Google visa páginas feitas principalmente para classificar, sejam escritas por IA, modelos ou pessoas.
- Os fatos vêm de apenas três lugares: fatos que a empresa já possui (estudos de caso, documentação do produto, seus próprios dados), aritmética feita sobre esses fatos ou fontes públicas citadas. Nunca invente números, clientes, citações ou resultados para preencher um modelo.
- Um modelo para cada página é o principal padrão de falha. Use layouts diferentes por tipo de página e intenção, e varie a ordem das seções e componentes para que as páginas não pareçam produzidas em massa.
- Páginas programáticas apoiam as páginas principais, não competem com elas. Construa em torno de páginas de produto e serviço, nunca em suas palavras-chave principais.
- Teste pequeno antes de escalar. Publique um lote de cerca de 5 a 10 páginas, solicite indexação, e aguarde pelo menos duas semanas antes de aplicar um método a centenas de páginas.
- Registre cada alteração com uma data (
templates/change-log.csv). Quando várias correções chegam juntas, o registro é a única maneira de saber o que funcionou. - Verifique leads e backlinks antes de excluir ou redirecionar qualquer coisa. Os números de pesquisa sozinhos podem esconder uma página que trouxe um cliente real.
- Breadcrumbs, schema e sitemaps são gerados pelo CMS a partir de campos, nunca digitados à mão, página por página.
- As transferências são solicitações com referências. Desenvolvedores e designers recebem um briefing consolidado e claramente escrito por tarefa, com páginas de exemplo para consultar.
- A visibilidade em busca de IA precisa de acesso primeiro. Verifique se os rastreadores de IA não estão bloqueados antes de culpar o conteúdo por zero citações (etapa 1).
Scripts
Todos os scripts estão em scripts/, executados com Python 3, e imprimem um resumo em linguagem simples. Eles funcionam a partir de exportações enviadas, para que a pessoa nunca toque em código: peça o arquivo, execute o script, compartilhe a saída. Execute qualquer script com --help para ver suas opções.
| Script | Etapa | Entrada | Saída |
|---|---|---|---|
url_grouper.py | 2 | XML de sitemap ou uma lista de URLs | URLs agrupadas por pasta e padrão de slug |
gsc_triage.py | 3 | Exportações de página do Search Console (+ lista de indexação opcional, leads, backlinks) | Planilha de manter / reformular / redirecionar / excluir com motivos |
near_duplicates.py | 3, 8 | Páginas HTML salvas, um CSV de texto ou URLs para buscar | Pares e clusters de quase duplicatas |
internal_links.py | 6, 10 | Exportação de links de entrada do rastreador ou HTML salvo | Contagem de links de entrada por página, lista de órfãos |
sitemap_builder.py | 6 | CSV de url, seção, lastmod | Índice de sitemap, um sitemap XML por seção, sitemap HTML |
sheet_qa.py | 8 | CSV da planilha de conteúdo | Relatório de QA linha por linha |
launch_checker.py | 10 | URLs para buscar ou HTML salvo | Relatório de lançamento aprovado/reprovado por página |
Buscar URLs ativas precisa de internet aberta. No sandbox de chat do Claude.ai, o acesso de saída é limitado, então use arquivos enviados lá; execute modos de busca no Claude Code ou Cowork.
Modelos e biblioteca
templates/: brief do projeto, registro de alterações, colunas da planilha de triagem, mapa de pilares, planilha de conteúdo, lista de verificação de requisitos de CMS, brief do desenvolvedor, brief do designer, lista de verificação de lançamento, esboço de relatório mensal.library/page-types.md: catálogo de tipos de página com intenção, URL, breadcrumb, seções e de onde vem a exclusividade.library/reference-gallery.md: exemplos reais de páginas programáticas para mostrar a desenvolvedores e designers, com notas sobre o que destacar e o que uma empresa menor pode copiar.library/troubleshooting.md: sintoma, causas prováveis, como verificar, corrigir.library/field-notes.md: evidências de projeto anonimizadas, comprovadas versus sendo testadas.
Ferramentas relacionadas
- Habilidades: uma habilidade de análise de lacunas de conteúdo ou sitemap de concorrente (etapa 4), uma habilidade de humanização (etapa 8), uma habilidade de planilha para construir planilhas.
- Conectores de dados, se disponíveis: Google Search Console (servidores MCP da comunidade ou a API; exportações CSV sempre funcionam), Bing Webmaster Tools, uma fonte de dados de palavras-chave como DataForSEO, Ahrefs ou Semrush, Notion ou Google Drive para rastreadores. Nunca bloqueie uma etapa em um conector; toda etapa funciona a partir de exportações.
Estilo de saída
Resumos curtos, depois a entrega. Planilhas para listas de páginas, briefs em texto simples para pessoas, tabelas apenas onde comparar opções. Evite jargão; quando um termo técnico for inevitável, defina-o em uma linha.