Communitygithub.com

Construtor de Sites Astro para SEO

Construa sites completos e otimizados para SEO usando Astro com Tailwind CSS, coleções de conteúdo e banco de dados opcional Turso. Use esta skill sempre que o usuário quiser criar um site, construir um site que ranqueie no Google, iniciar um projeto Astro, fazer uma landing page, construir um site empresarial, criar um blog ou qualquer projeto web onde SEO é importante.

O que é Construtor de Sites Astro para SEO?

Esta skill constrói sites Astro completos e prontos para implantação, projetados para ranquear bem no Google. Ela segue um fluxo de trabalho de 5 fases: descoberta e pesquisa, configuração do projeto, construção de cada página com design e SEO, implementação de coleções de conteúdo e banco de dados (Turso), e preparação para implantação com auditoria final de SEO. A skill prioriza conteúdo real e pesquisado, design premium (com regras para evitar aparência genérica de IA) e otimização técnica completa, incluindo meta tags, dados estruturados, sitemaps e robots.txt. Ela é acionada para qualquer projeto web (landing pages, blogs, sites empresariais) onde o usuário mencione Astro, SEO ou simplesmente a necessidade de um site moderno.

Funciona com✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/IncomeStreamSurfer/astro-builder-skill/tree/HEAD/skill

Perguntar na sua IA favorita

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

Documentação

O que Construtor de Sites Astro para SEO faz?

Você constrói sites Astro completos e prontos para implantação, projetados para ranquear no Google. Todo site inclui meta tags adequadas, dados estruturados, HTML semântico, imagens otimizadas, sitemaps e conteúdo real e pesquisado — não texto de espaço reservado.

Cada frontend que você produzir deve ser premium e não genérico. Leia references/taste-skill.md antes de escrever qualquer código de UI — ele contém as regras de design que impedem a saída genérica de "IA mal feita".

Stack Tecnológico

  • Astro — Framework estático por padrão, zero JS por padrão, perfeito para SEO
  • React — Componentes interativos via ilhas Astro (formulários, navegação, animações)
  • Tailwind CSS — Todo o estilo. Sem padrões shadcn — personalize tudo de acordo com as regras da taste-skill
  • Coleções de Conteúdo Astro — Conteúdo Markdown/MDX type-safe para postagens de blog, serviços, depoimentos
  • Turso + Drizzle — Banco de dados SQLite de borda (opcional, para formulários/dados dinâmicos)

Visão Geral do Fluxo de Trabalho

Cada projeto segue esta sequência. Não pule etapas.

Fase 1: Descoberta e Pesquisa

  1. Pergunte ao usuário sobre seu nicho, negócio e objetivos
  2. Pergunte se ele precisa de um banco de dados (para formulários de contato, leads, reservas, etc.)
  3. Pesquise o nicho — o que está ranqueando, quais palavras-chave importam, quais lacunas de conteúdo existem
  4. Proponha uma estrutura de site com lista de páginas, estratégia de conteúdo e palavras-chave alvo
  5. Obtenha a aprovação do usuário antes de construir

Fase 2: Configuração do Projeto

  1. Crie o projeto Astro
  2. Instale e configure as integrações (React, Tailwind, sitemap)
  3. Configure o layout base, componentes de SEO e sistema de design

Fase 3: Construa Cada Página

  1. Leia references/taste-skill.md para as regras de design
  2. Se o usuário quiser imagens geradas, leia references/image-generation.md e gere imagens para cada página
  3. Crie cada página com conteúdo real e pesquisado
  4. SEO completo em cada página — meta tags, tags OG, dados estruturados, HTML semântico
  5. Implemente os componentes interativos (formulários, navegação, etc.)

Fase 4: Coleções de Conteúdo e Banco de Dados

  1. Configure as coleções de conteúdo Astro para postagens de blog, serviços, etc.
  2. Se um banco de dados for solicitado: configure Turso, crie esquemas, construa rotas de API
  3. Construa um painel de administração para dados do banco de dados, se aplicável

Fase 5: Preparação para Implantação

  1. Gere sitemap, robots.txt
  2. Configure a implantação (Vercel/Netlify)
  3. Auditoria final de SEO de cada página

Fase 1: Descoberta e Pesquisa

Pergunte ao Usuário

Antes de escrever qualquer código, entenda o projeto:

  1. Qual é o seu nicho/negócio? — "Sou um encanador em Dublin" ou "Vendo velas artesanais online"
  2. Qual é o objetivo principal do site? — Geração de leads, e-commerce, portfólio, blog, landing page de SaaS
  3. Quantas páginas você deseja? — Pequeno (5-10 páginas) ou com muito conteúdo (15-30+ páginas com blog)
  4. Você precisa de um banco de dados? — Para armazenar envios de formulários, reservas, dados de usuário, etc. Se sim, configure Turso.
  5. Você deseja imagens geradas? — "Posso gerar imagens de stock personalizadas para o seu site usando Gemini. Se desejar, adicione sua GEMINI_API_KEY ao arquivo .env."
  6. Você tem um domínio? — Necessário para URLs canônicas/sitemap. Use um espaço reservado se ainda não foi comprado.
  7. Alguma preferência de design? — Cores, estilo, branding existente

Pesquise o Nicho

Use pesquisa na web para encontrar:

  • O que está ranqueando atualmente para as palavras-chave alvo — os 5-10 principais resultados
  • Lacunas de conteúdo — quais perguntas não estão sendo bem respondidas
  • Palavras-chave de cauda longa — frases específicas com menos concorrência
  • Sinais de SEO local se for um negócio local
  • Estruturas de sites concorrentes — quais páginas eles têm, o que estão perdendo

Proponha a Estrutura do Site

Com base na pesquisa, crie uma proposta concreta. Exemplo para um encanador:

Páginas Propostas:
1. Home — "Encanador Dublin | Serviços de Encanamento de Emergência 24/7"
2. Serviços — Visão geral de todos os serviços
3. Serviços/Encanamento-Emergencia — Landing page direcionada
4. Serviços/Reformas-Banheiro — Landing page direcionada
5. Serviços/Reparo-Caldeira — Landing page direcionada
6. Sobre — Sinais de confiança, equipe, qualificações
7. Blog — Conteúdo contínuo para SEO
8. Blog/[slug] — Postagens individuais segmentando palavras-chave de cauda longa
9. Contato — Formulário + mapa + telefone
10. Áreas que Atendemos — Páginas de SEO local
11. Depoimentos — Prova social

Palavras-chave Alvo: encanador emergência dublin, encanador perto de mim dublin, reparo caldeira dublin...
Estratégia de Conteúdo: Postagens semanais no blog segmentando consultas "como consertar [problema comum]"

Obtenha a aprovação do usuário antes de prosseguir.


Fase 2: Configuração do Projeto

Leia references/astro-setup.md para comandos e configuração exatos.

1. Crie o Projeto

npm create astro@latest [project-name] -- --template minimal --install --no-git
cd [project-name]

2. Instale as Integrações

npx astro add react tailwind sitemap
npm install @astrojs/check typescript
npm install @fontsource/geist-sans @fontsource/geist-mono  # Fontes premium de acordo com taste-skill

3. Se um Banco de Dados For Solicitado

Leia references/turso-setup.md para configuração completa do Turso.

npm install @libsql/client drizzle-orm

4. Estrutura do Projeto

src/
├── components/
│   ├── SEOHead.astro
│   ├── Header.astro
│   ├── Footer.astro
│   ├── Navigation.tsx    # Ilha React
│   └── ContactForm.tsx   # Ilha React
├── content.config.ts     # Esquemas de coleção de conteúdo (NÃO em content/)
├── content/
│   ├── blog/
│   ├── services/
│   └── testimonials/
├── layouts/
│   └── BaseLayout.astro
├── lib/
│   ├── turso.ts          # Se banco de dados
│   └── utils.ts
├── pages/
│   ├── index.astro
│   ├── about.astro
│   ├── contact.astro
│   ├── blog/
│   │   ├── index.astro
│   │   └── [...slug].astro
│   └── api/              # Rotas de API (se banco de dados)
├── styles/
│   └── globals.css
└── middleware.ts
astro.config.mjs

Fase 3: Construa Cada Página — Design + SEO

Antes de escrever qualquer página, leia ambos:

  • references/seo-checklist.md — Regras de SEO para cada página
  • references/taste-skill.md — Regras de design para evitar saída genérica

O Componente SEOHead

Crie src/components/SEOHead.astro — vai no <head> de cada página. Lida com:

  • Tag de título (única por página, palavra-chave primária, menos de 60 caracteres)
  • Meta descrição (única, CTA, menos de 160 caracteres)
  • URL canônica
  • Tags Open Graph
  • Tags Twitter Card
  • Dados estruturados JSON-LD

Veja references/seo-checklist.md para o código exato do componente.

Regras de Redação de Conteúdo

  • Escreva para humanos primeiro, mecanismos de busca em segundo.
  • Cada página segmenta um cluster de palavras-chave específico. Palavra-chave primária no título, H1, primeiro parágrafo, meta descrição, slug da URL.
  • Hierarquia de cabeçalhos adequada. Um H1. H2s para seções. H3s para subseções. Nunca pule níveis.
  • Links internos. Cada página linka para 2-3+ outras páginas. Texto âncora descritivo.
  • Texto alternativo de imagem. Cada imagem recebe texto alternativo descritivo com palavras-chave naturais.
  • Comprimento do conteúdo. Páginas de serviço: 800-1500 palavras. Postagens de blog: 1500-3000 palavras. Home: 500-1000 palavras.
  • Marcação Schema. Cada página recebe JSON-LD apropriado.

Regras de Design (da taste-skill)

Estas são inegociáveis para cada página que você construir:

  • Tipografia: Use Geist, Satoshi, Outfit ou Cabinet Grotesk. NUNCA Inter. Títulos: text-4xl md:text-6xl tracking-tighter leading-none.
  • Cores: Máximo 1 cor de destaque, saturação < 80%. Sem gradientes roxo/azul de IA. Bases neutras (Zinc/Slate).
  • Layout: Nenhum herói centralizado quando DESIGN_VARIANCE > 4. Use layouts de tela dividida, assimétricos ou alinhados à esquerda.
  • Cards: Apenas quando a elevação comunica hierarquia. Nenhum layout genérico de 3 colunas de cards.
  • Espaçamento: min-h-[100dvh] em vez de h-screen. Grid em vez de matemática flexbox. max-w-7xl mx-auto.
  • Estados: Cada componente interativo precisa de estados de carregamento, vazio e erro.
  • Sem porcaria de IA: Sem emojis, sem "João da Silva", sem "Empresa Ltda", sem palavras de preenchimento como "perfeito" ou "transformador".

Ilhas Astro para Interatividade

  • Conteúdo estático (títulos, texto, imagens) — componentes .astro, zero JS
  • Elementos interativos (formulários, navegação móvel, animações de rolagem) — React .tsx com client:visible ou client:load
  • Animações: Para movimento (MOTION_INTENSITY > 5), use Framer Motion em ilhas React isoladas. Física de mola: type: "spring", stiffness: 100, damping: 20.

Leia references/tailwind-components.md para padrões de componentes (navegação, formulários, FAQ, etc.)


Fase 4: Coleções de Conteúdo e Banco de Dados

Coleções de Conteúdo Astro

Leia references/content-collections.md para a configuração completa. As coleções de conteúdo substituem um CMS — o conteúdo existe como arquivos Markdown em src/content/ com esquemas type-safe.

IMPORTANTE: Defina os esquemas em src/content.config.ts (NÃO em src/content/config.ts — o caminho antigo lança LegacyContentConfigError no Astro v5+). Cada coleção deve ter um loader (use glob() de astro/loaders).

Defina os esquemas em src/content.config.ts:

  • Postagens do blog: título, descrição, pubDate, imagem, tags, autor, rascunho
  • Serviços: título, descrição, ícone, ordem, destaque
  • Depoimentos: nome, função, citação, classificação

Consulte coleções em páginas com getCollection() e getEntry().

Banco de Dados Turso (Se Solicitado)

Leia references/turso-setup.md para configuração completa. O Turso lida com dados dinâmicos — envios de formulários, leads, reservas, inscrições em newsletters.

  1. Crie o cliente de banco de dados em src/lib/turso.ts
  2. Defina esquemas com Drizzle ORM
  3. Crie rotas de API em src/pages/api/ para manipulação de formulários
  4. Construa um painel de administração para visualizar dados enviados

Painel de Administração (Se Banco de Dados)

Construa em /admin usando ilhas React com tabelas e cards estilizados com Tailwind. Usa:

  • Middleware para autenticação básica
  • Rotas de API para buscar dados do Turso
  • Apresentação de dados limpa e de bom gosto (de acordo com as regras taste-skill — sem grades de cards genéricas)

Fase 5: Preparação para Implantação

Sitemap e Robots.txt

@astrojs/sitemap gera automaticamente o sitemap. Defina site em astro.config.mjs.

robots.txt dinâmico em src/pages/robots.txt.ts:

import type { APIRoute } from 'astro';

const getRobotsTxt = (siteURL: string) => `User-agent: *
Allow: /
Disallow: /admin
Sitemap: ${siteURL}sitemap-index.xml`;

export const GET: APIRoute = ({ site }) => {
  return new Response(getRobotsTxt(site?.toString() || ''));
};

Configuração de Implantação

Leia references/deployment.md para configurações do Vercel/Netlify.

Para sites com rotas de API ou Turso, adicione um adaptador, mas mantenha a saída estática padrão. Marque rotas de servidor individuais com export const prerender = false;:

import vercel from '@astrojs/vercel';

export default defineConfig({
  // NÃO use output: 'hybrid' — foi removido no Astro v5.
  // O padrão é 'static'. Rotas renderizadas no servidor optam por sair individualmente.
  adapter: vercel(),
});

Em cada rota de API ou página renderizada no servidor:

// src/pages/api/contact.ts
export const prerender = false; // Esta rota é executada no servidor

export const POST: APIRoute = async ({ request }) => {
  // ...
};

Auditoria Final de SEO

Audite cada página contra references/seo-checklist.md:

  • Título, descrição, URL canônica exclusivos por página
  • Todas as imagens têm texto alternativo
  • JSON-LD válido
  • Links internos funcionam
  • Responsivo para dispositivos móveis (teste as regras de substituição móvel da taste-skill)
  • Sitemap inclui todas as páginas
  • robots.txt correto

Notas Importantes

  • NÃO use output: 'hybrid' — foi removido no Astro v5. Use a saída 'static' padrão. Para rotas renderizadas no servidor (endpoints de API, manipuladores de formulários), adicione export const prerender = false; em cada arquivo.
  • Ilhas React precisam de diretivas de hidratação — client:load ou client:visible.
  • As coleções de conteúdo são baseadas em arquivos. Postagens de blog e serviços residem como arquivos .md em src/content/. O Turso é apenas para dados dinâmicos (envios de formulários).
  • Pesquise antes de construir. A fase de pesquisa de nicho determina a qualidade do SEO.
  • Conteúdo real vence. Escreva conteúdo substancial e útil. Sem lorem ipsum.
  • Design premium sempre. Siga as regras da taste-skill. Cada página deve parecer uma construção de agência de $10k, não uma saída genérica de IA.
  • A geração de imagens é opcional. Se o usuário fornecer uma GEMINI_API_KEY, gere imagens personalizadas de acordo com references/image-generation.md. Caso contrário, use divs estilizadas de espaço reservado com texto alternativo adequado.

Habilidades Relacionadas