| name | site-seo-and-sitemap |
| description | Maintain SEO metadata and sitemap/robots generation for this Next.js site. Use when changing titles/descriptions/OG images, canonical URLs, NEXT_PUBLIC_SITE_URL, next-seo configuration, or when adding sitemap.xml/robots.txt via next-sitemap. |
site-seo-and-sitemap
Guia prático para manter SEO consistente no build e em produção.
Objetivo
- Garantir metas (title/description/canonical/OG/Twitter) coerentes em todas as páginas.
- Manter sitemap e robots coerentes com a URL pública final.
Quando usar (gatilhos)
- “Atualize Open Graph”, “corrija canonical”, “melhore SEO”, “adicione sitemap/robots”.
- Mudanças em
NEXT_PUBLIC_SITE_URL, src/data/SeoConfig.js, src/layouts/AppLayout.js, next-sitemap.config.js.
- Problemas em preview/prod: OG com URL errada, ícones quebrados, canonical vazio.
Exemplos de prompt
- “A imagem de preview do LinkedIn está errada; corrija OG.”
- “Gere
sitemap.xml e robots.txt no build.”
- “Padronize title/description/canonical por página.”
Inputs (o que pedir ao usuário)
- URL pública final (ex.:
https://josenaldo.github.io).
- Para mudanças por página: quais rotas e quais títulos/descrições.
Princípios e regras
Crítico (não negociar)
NEXT_PUBLIC_SITE_URL deve existir no build (local e CI). Ele alimenta SeoConfig e OG images.- Canonical e OG devem ser URLs absolutas em produção.
- Arquivos gerados (
sitemap.xml, robots.txt) precisam cair em public/ para serem servidos em produção.
Padrões recomendados
- Centralizar defaults em
src/data/SeoConfig.js (via DefaultSeo em _app.js).
- Para páginas específicas, usar
NextSeo no layout/página (já existe em AppLayout).
Workflow (faça em ordem)
- Confirmar URL do site
- Definir/validar
NEXT_PUBLIC_SITE_URL.
- Para dev local, considerar
.env.local (não commitar secrets).
- Revisar defaults
- Conferir
src/data/SeoConfig.js: canonical, openGraph.url, images.url, ícones em additionalLinkTags.
- Revisar por página
- Onde existir
AppLayout, garantir title, description, image coerentes.
- Evitar meta duplicada/ruim em
_app.js (o Head do template do Next pode conflitar com DefaultSeo).
- Sitemap e robots
- Config em
next-sitemap.config.js já existe.
- Se
sitemap.xml/robots.txt não estiverem sendo gerados, adicionar execução do next-sitemap no pipeline (por exemplo, postbuild).
- Validar
- Rodar
npm run build e verificar se os arquivos finais estão no output publicado.
Saída esperada
- Patch com ajustes em SEO (config/layout) e instruções claras para setar
NEXT_PUBLIC_SITE_URL.
- Se solicitado, incluir ajuste no build para gerar sitemap/robots.
Checklist
Consulte também
web-design-guidelines (skill instalada)
