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
- Pergunte ao usuário sobre seu nicho, negócio e objetivos
- Pergunte se ele precisa de um banco de dados (para formulários de contato, leads, reservas, etc.)
- Pesquise o nicho — o que está ranqueando, quais palavras-chave importam, quais lacunas de conteúdo existem
- Proponha uma estrutura de site com lista de páginas, estratégia de conteúdo e palavras-chave alvo
- Obtenha a aprovação do usuário antes de construir
Fase 2: Configuração do Projeto
- Crie o projeto Astro
- Instale e configure as integrações (React, Tailwind, sitemap)
- Configure o layout base, componentes de SEO e sistema de design
Fase 3: Construa Cada Página
- Leia
references/taste-skill.mdpara as regras de design - Se o usuário quiser imagens geradas, leia
references/image-generation.mde gere imagens para cada página - Crie cada página com conteúdo real e pesquisado
- SEO completo em cada página — meta tags, tags OG, dados estruturados, HTML semântico
- Implemente os componentes interativos (formulários, navegação, etc.)
Fase 4: Coleções de Conteúdo e Banco de Dados
- Configure as coleções de conteúdo Astro para postagens de blog, serviços, etc.
- Se um banco de dados for solicitado: configure Turso, crie esquemas, construa rotas de API
- Construa um painel de administração para dados do banco de dados, se aplicável
Fase 5: Preparação para Implantação
- Gere sitemap, robots.txt
- Configure a implantação (Vercel/Netlify)
- 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:
- Qual é o seu nicho/negócio? — "Sou um encanador em Dublin" ou "Vendo velas artesanais online"
- Qual é o objetivo principal do site? — Geração de leads, e-commerce, portfólio, blog, landing page de SaaS
- Quantas páginas você deseja? — Pequeno (5-10 páginas) ou com muito conteúdo (15-30+ páginas com blog)
- Você precisa de um banco de dados? — Para armazenar envios de formulários, reservas, dados de usuário, etc. Se sim, configure Turso.
- Você deseja imagens geradas? — "Posso gerar imagens de stock personalizadas para o seu site usando Gemini. Se desejar, adicione sua
GEMINI_API_KEYao arquivo.env." - Você tem um domínio? — Necessário para URLs canônicas/sitemap. Use um espaço reservado se ainda não foi comprado.
- 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áginareferences/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 deh-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
.tsxcomclient:visibleouclient: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.
- Crie o cliente de banco de dados em
src/lib/turso.ts - Defina esquemas com Drizzle ORM
- Crie rotas de API em
src/pages/api/para manipulação de formulários - 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), adicioneexport const prerender = false;em cada arquivo. - Ilhas React precisam de diretivas de hidratação —
client:loadouclient:visible. - As coleções de conteúdo são baseadas em arquivos. Postagens de blog e serviços residem como arquivos
.mdemsrc/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 comreferences/image-generation.md. Caso contrário, use divs estilizadas de espaço reservado com texto alternativo adequado.