fixing-metadata

Quando Usar

Use esta habilidade quando precisar auditar e corrigir metadados HTML, incluindo títulos de página, meta descrições, URLs canônicos, tags Open Graph, cartões do Twitter, favicons, dados estruturados JSON-LD e diretivas de robôs. Use ao adicionar metadados de SEO, corrigir pré-visualizações de compartilhamento social, revisar tags Open Graph, configurar canônicos...

Fluxo de Trabalho

1. Identifique páginas com metadados ausentes ou incorretos (títulos, descrições, canônicos, tags OG).
2. Audite de acordo com as regras de prioridade abaixo — corrija primeiro os problemas críticos (duplicados, indexação).
3. Garanta que o título, a descrição, o canônico e o og:url concordem entre si.
4. Verifique se os cartões sociais são renderizados corretamente em uma URL real, não em localhost.
5. Mantenha as diferenças mínimas e restritas apenas aos metadados — não refatore código não relacionado.

Quando Aplicar

Consulte estas diretrizes quando:

• adicionar ou alterar títulos de página, descrições, canônicos, robôs.
• implementar metadados Open Graph ou cartões do Twitter.
• configurar favicons, ícones de aplicativos, manifest, theme-color.
• construir componentes de SEO compartilhados ou padrões de metadados de layout.
• adicionar dados estruturados (JSON-LD).
• alterar o local, idiomas alternativos ou roteamento canônico.
• lançar novas páginas, páginas de marketing ou links compartilháveis.

Categorias de Regras por Prioridade

Referência Rápida

1. Correção e Duplicação (Crítico)

• Defina metadados em um único local por página, evite sistemas concorrentes.
• Não emita tags de título, descrição, canônico ou robôs duplicadas.
• Metadados devem ser determinísticos, sem valores aleatórios ou instáveis.
• Escape e sanitize quaisquer strings geradas por usuários ou dinâmicas.
• Cada página deve ter padrões seguros para título e descrição.

2. Título e Descrição (Alto)

• Cada página deve ter um título.
• Use um formato de título consistente em todo o site.
• Mantenha os títulos curtos e legíveis, evite excesso de palavras-chave.
• Páginas compartilháveis ou pesquisáveis devem ter uma meta descrição.
• Descrições devem ser texto simples, sem markdown ou spam de citações.

3. Canônico e Indexação (Alto)

• O canônico deve apontar para o URL preferido da página.
• Use noindex apenas para páginas privadas, duplicadas ou não públicas.
• A meta tag robots deve corresponder à intenção de acesso real.
• Pré-visualizações ou páginas de staging devem ser noindex por padrão, quando possível.
• Páginas paginadas devem ter comportamento canônico correto.

4. Cartões Sociais (Alto)

• Páginas compartilháveis devem definir o título, descrição e imagem do Open Graph.
• Imagens do Open Graph e do Twitter devem usar URLs absolutos.
• Prefira dimensões de imagem corretas e proporções estáveis.
• og:url deve corresponder ao URL canônico.
• Use um og:type sensato, geralmente website ou article.
• Defina twitter:card apropriadamente, summary_large_image por padrão.

5. Ícones e Manifest (Médio)

• Inclua pelo menos um favicon que funcione em todos os navegadores.
• Inclua apple-touch-icon quando relevante.
• O manifest deve ser válido e referenciado quando usado.
• Defina theme-color intencionalmente para evitar cromos de UI incompatíveis.
• Caminhos de ícones devem ser estáveis e armazenáveis em cache.

6. Dados Estruturados (Médio)

• Não adicione JSON-LD a menos que ele mapeie claramente para o conteúdo real da página.
• O JSON-LD deve ser válido e refletir o que está realmente renderizado.
• Não invente avaliações, revisões, preços ou detalhes de organização.
• Prefira um bloco de dados estruturados por página, a menos que seja necessário.

7. Localização e Alternativas (Baixo-Médio)

• Defina o atributo lang do HTML corretamente.
• Defina og:locale quando a localização existir.
• Adicione alternativas hreflang apenas quando as páginas realmente existirem.
• Páginas localizadas devem ter um canônico correto por local.

8. Limites da Ferramenta (Crítico)

• Prefira alterações mínimas, não refatore código não relacionado.
• Não migre frameworks ou bibliotecas de SEO, a menos que solicitado.
• Siga o padrão de metadados existente do projeto (API de metadados Next.js, react-helmet, head manual, etc.).

Orientações de Revisão

• Corrija primeiro os problemas críticos (duplicados, canônico, indexação).
• Garanta que o título, a descrição, o canônico e o og:url concordem.
• Verifique os cartões sociais em uma URL real, não em localhost.
• Prefira metadados estáveis e simples em vez de inteligentes ou dinâmicos.
• Mantenha as diferenças mínimas e restritas apenas aos metadados.

Exemplo

Solicitação do usuário:

…