Pular para o conteúdo
Skillpedia
SEO48 mil · #4130

seo-hreflang

Faz seu agente verificar e corrigir o SEO para diferentes idiomas e regiões. Ele encontra erros e gera o código correto. Use para sites com conteúdo em várias línguas.

O que ela faz

Esta ferramenta ajuda a garantir que seu site mostre a versão correta do idioma e da região para cada visitante. Ela verifica se as 'tags hreflang' estão configuradas corretamente, o que é essencial para sites com conteúdo em vários idiomas ou para diferentes países.

Quando usar

  • ✓Quando você tem um site em vários idiomas e quer ter certeza de que a versão certa é mostrada.
  • ✓Ao configurar um site para diferentes países e regiões.
  • ✓Se você está tendo problemas com o Google mostrando seu site no idioma errado.

Exemplo do que pedir para a IA

“Verifique minhas tags hreflang para o meu site de e-commerce.”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/seo-hreflang/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/seo-hreflang/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

A ferramenta analisa seu site para encontrar erros comuns nas tags hreflang. Ela verifica se as páginas se referem umas às outras corretamente e se os códigos de idioma e região estão certos.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add sickn33/agentic-awesome-skills --skill seo-hreflang

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/seo-hreflang/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

Hreflang e SEO Internacional

Quando Usar

  • Use ao validar ou gerar hreflang para sites multilíngues ou multirregionais.
  • Use quando o usuário mencionar SEO internacional, tags de idioma, x-default ou problemas de hreflang.
  • Use ao auditar alternâncias de localidade em implementações de HTML, cabeçalhos ou sitemap.

Valide implementações de hreflang existentes ou gere tags de hreflang corretas para sites multilíngues e multirregionais. Suporta implementações em HTML, cabeçalho HTTP e sitemap XML.

Verificações de Validação

1. Tags de Auto-referência

  • Cada página deve incluir uma tag hreflang apontando para si mesma
  • O URL de auto-referência deve corresponder exatamente ao URL canônico da página
  • Tags de auto-referência ausentes fazem com que o Google ignore todo o conjunto de hreflang

2. Tags de Retorno

  • Se a página A aponta para a página B com hreflang, a página B deve apontar de volta para a página A
  • Cada relação hreflang deve ser bidirecional (A→B e B→A)
  • Tags de retorno ausentes invalidam o sinal de hreflang para ambas as páginas
  • Verifique se todas as versões de idioma se referem umas às outras (malha completa)

3. Tag x-default

  • Obrigatório: designa a página de fallback para idiomas/regiões não correspondentes
  • Geralmente aponta para a página seletora de idioma ou versão em inglês
  • Apenas um x-default por conjunto de alternâncias
  • Deve também ter tags de retorno de todas as outras versões de idioma

4. Validação de Código de Idioma

  • Deve usar códigos de duas letras ISO 639-1 (por exemplo, en, fr, de, ja)
  • Erros comuns:
    • eng em vez de en (ISO 639-2, não válido para hreflang)
    • jp em vez de ja (código incorreto para japonês)
    • zh sem qualificador de região (ambíguo; use zh-Hans ou zh-Hant)

5. Validação de Código de Região

  • O qualificador de região opcional usa ISO 3166-1 Alpha-2 (por exemplo, en-US, en-GB, pt-BR)
  • Formato: language-REGION (idioma em minúsculas, região em maiúsculas)
  • Erros comuns:
    • en-uk em vez de en-GB (UK não é um código ISO 3166-1 válido)
    • es-LA (América Latina não é um país; use países específicos)
    • Região sem prefixo de idioma

6. Alinhamento de URL Canônico

  • As tags hreflang devem aparecer apenas em URLs canônicos
  • Se uma página tiver rel=canonical apontando para outro lugar, o hreflang nessa página é ignorado
  • O URL canônico e o URL hreflang devem corresponder exatamente (incluindo barras finais)
  • Páginas não canônicas não devem estar em nenhum conjunto de hreflang

7. Consistência de Protocolo

  • Todos os URLs em um conjunto de hreflang devem usar o mesmo protocolo (HTTPS ou HTTP)
  • Mistura de HTTP/HTTPS em conjuntos de hreflang causa falhas de validação
  • Após a migração para HTTPS, atualize todas as tags hreflang para HTTPS

8. Suporte Cross-Domain

  • Hreflang funciona em diferentes domínios (por exemplo, example.com e example.de)
  • Hreflang cross-domain requer tags de retorno em ambos os domínios
  • Verifique se ambos os domínios estão verificados no Google Search Console
  • Implementação baseada em sitemap recomendada para configurações cross-domain

Erros Comuns

Problema Gravidade Correção
Tag de auto-referência ausente Crítico Adicione hreflang apontando para o URL da mesma página
Tags de retorno ausentes (A→B mas sem B→A) Crítico Adicione tags de retorno correspondentes em todas as alternâncias
x-default ausente Alto Adicione x-default apontando para a página de fallback/seletora
Código de idioma inválido (por exemplo, eng) Alto Use códigos de duas letras ISO 639-1
Código de região inválido (por exemplo, en-uk) Alto Use códigos ISO 3166-1 Alpha-2
Hreflang em URL não canônico Alto Mova o hreflang apenas para o URL canônico
Inconsistência de protocolo HTTP/HTTPS em URLs Médio Padronize todos os URLs para HTTPS
Inconsistência de barra final Médio Corresponda exatamente ao formato do URL canônico
Hreflang em HTML e sitemap Baixo Escolha um método (sitemap preferido para sites grandes)
Idioma sem região quando necessário Baixo Adicione qualificador de região para conteúdo geo-segmentado

Métodos de Implementação

Método 1: Tags de Link HTML

Ideal para: Sites com menos de 50 variantes de idioma/região por página.

<link rel="alternate" hreflang="en-US" href="https://example.com/page" />
<link rel="alternate" hreflang="en-GB" href="https://example.co.uk/page" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/page" />
<link rel="alternate" hreflang="x-default" href="https://example.com/page" />

Coloque na seção <head>. Cada página deve incluir todas as alternâncias, incluindo a si mesma.

Método 2: Cabeçalhos HTTP

Ideal para: Arquivos não HTML (PDFs, documentos).

Link: <https://example.com/page>; rel="alternate"; hreflang="en-US",
      <https://example.com/fr/page>; rel="alternate"; hreflang="fr",

…
Perguntas frequentes

O que são 'tags hreflang'?

São códigos especiais que você adiciona ao seu site para dizer aos motores de busca como o Google qual versão do idioma ou região de uma página mostrar para um usuário específico.

Por que 'x-default' é importante?

A tag 'x-default' é um plano B. Ela indica qual página mostrar se nenhuma outra versão de idioma ou região corresponder ao visitante.

Posso usar hreflang em sites com domínios diferentes?

Sim, você pode usar hreflang para conectar versões do seu site em diferentes domínios (ex: seu-site.com e seu-site.de), mas é preciso configurar corretamente as referências entre eles.

Detalhes

Descrição original do autor

Hreflang and international SEO audit, validation, and generation. Detects common mistakes, validates language/region codes, and generates correct hreflang implementations. Use when user says "hreflang", "i18n SEO", "international SEO", "multi-language", "multi-region", or "language tags".

repo: sickn33/agentic-awesome-skills

Popularidade

Estrelas no GitHub
48 mil
Posição no ranking
#4130
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas