name: web-blueprint-generator
description: Converte as hipóteses do local-seo-pattern-aggregator em um blueprint da web — arquitetura de URLs, schema JSON-LD por tipo de página, seções recorrentes, headings e plano de internal linking. É o plano antes da geração de páginas. Use SEMPRE que o usuário solicitar "desenhe a arquitetura", "quais páginas devo ter", "como estruturar a web", "blueprint para [keyword]" ou após local-seo-pattern-aggregator. Saída: arquivos planos prontos para serem executados pelo landing-generator-servico-barrio.
📚 Itinerário YinyangSEO Academy · Aula 1 — Sites agênticos e SEO eficiente. Esta skill faz parte do repositório da Aula 1. Clone ou baixe o repositório inteiro e forneça-o ao seu agente como contexto antes de executá-la. O repositório é atualizado durante o curso.
O que Gerador de Blueprint Web faz?
De padrões detectados a plano do site. Antes de gerar páginas, defina quais páginas, com qual estrutura, qual schema e qual internal linking. Sem essa camada, o agente improvisa cada landing page e o resultado é inconsistente.
Entradas
data/patterns/{kw}/{date}/hypotheses.md← dolocal-seo-pattern-aggregator.- Negócio alvo · nome, NAP, USP, lista de serviços reais, lista de zonas a cobrir.
- Stack · padrão Astro (também: Next.js, MDX puro).
- Restrições · idioma, número máximo de páginas, orçamento Lighthouse.
Processo
- Mapa de URLs a partir de padrões + zonas:
- Home (
/) - Serviços principais (
/servicos/{slug}/) - Serviço × bairro (
/{servico}/{bairro}/) — o coração do SEO local - Sobre nós, contato, legais
- Blog (opcional)
- Home (
- Para cada tipo de página, definir:
- Padrão de Title e padrão de meta description (com variáveis:
{servico},{bairro},{cidade},{telefone}). - Padrão de H1, H2, H3.
- Seções obrigatórias (extraídas das hipóteses HIGH do aggregator).
- Schema JSON-LD por tipo:
- Home →
LocalBusiness+Organization. - Serviço principal →
Service+BreadcrumbList. - Serviço × bairro →
ServicecomareaServed: PostalAddress+BreadcrumbList+FAQPage.
- Home →
- CTA (telefônico sempre visível se os vencedores o tiverem).
- Padrão de Title e padrão de meta description (com variáveis:
- Plano de internal linking:
- Home → todos os serviços principais.
- Principal → todos os seus bairros.
- Serviço × bairro → outros bairros do mesmo serviço + serviço principal + serviços relacionados.
- Bloco
áreas próximasconsistente.
- Plano de conteúdo mínimo por página: comprimento, FAQ obrigatória, prova social, NAP.
- Orçamento Lighthouse (herdado dos padrões do top 3): LCP, CLS, TBT, bundle JS.
Ferramentas
- LLM para redigir padrões com variáveis.
- schema-dts para validar JSON-LD contra tipos oficiais.
- astro-seo ou
next-sitemap(referência para gerar sitemaps automáticos).
Saída
blueprint/{negocio-slug}/
├── url-map.yaml ← lista completa de URLs a gerar
├── page-templates/
│ ├── home.md ← template com vars {{...}}
│ ├── service-pillar.md
│ └── service-area.md
├── schema-templates/
│ ├── home.jsonld
│ ├── service-pillar.jsonld
│ └── service-area.jsonld
├── internal-linking.yaml
├── lighthouse-budget.json
└── README.md ← como usar este blueprint
url-map.yaml exemplo:
home: /
services:
- slug: chaveiro-24h
bairros: [centro, vila-madalena, pinheiros, moema]
- slug: abertura-portas
bairros: [centro, vila-madalena, pinheiros]
legals:
- aviso-legal
- politica-privacidade
- cookies
Qualidade / QA
- Verificar que cada
service-areafica acessível em ≤ 3 cliques a partir da home. - Não gerar combinações serviço × bairro que excedam o limite do usuário (avisar e pedir priorização).
- Validar JSON-LD com schema-dts antes de passar para o gerador.
Para que é usado depois
→ Entrada direta de landing-generator-servico-barrio (gera o código real) e landing-qa-runner (que verifica o orçamento).