Communitygithub.com

Gerador de Blueprint Web

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

O que é Gerador de Blueprint Web?

Esta skill, chamada `web-blueprint-generator`, transforma as hipóteses geradas pelo agregador de padrões de SEO local (`local-seo-pattern-aggregator`) em um blueprint detalhado e estruturado da web. Em vez de gerar páginas diretamente, ela primeiro define o plano arquitetônico: o mapa de URLs, os schemas JSON-LD específicos para cada tipo de página (home, serviço principal, serviço por bairro), os padrões de títulos e headings, seções obrigatórias e um plano completo de internal linking. Isso garante consistência, otimização para SEO local e eficiência na geração de landing pages. Após a execução, os arquivos gerados (mapa de URLs, templates de página, schemas, plano de links internos, orçamento Lighthouse) são consumidos diretamente por outras skills como `landing-generator-servico-barrio` e `landing-qa-runner`, formando um pipeline automatizado e profissional para criação de sites agênticos.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Freskan23/clase-1-agentes-ia-webs/tree/HEAD/03-skills/web-blueprint-generator

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação


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 ← do local-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

  1. 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)
  2. 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 → Service com areaServed: PostalAddress + BreadcrumbList + FAQPage.
    • CTA (telefônico sempre visível se os vencedores o tiverem).
  3. 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óximas consistente.
  4. Plano de conteúdo mínimo por página: comprimento, FAQ obrigatória, prova social, NAP.
  5. 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-area fica 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).

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas