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
Mensagem pronta para colar
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-hreflangOu 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.mdConteú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:
engem vez deen(ISO 639-2, não válido para hreflang)jpem vez deja(código incorreto para japonês)zhsem qualificador de região (ambíguo; usezh-Hansouzh-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-ukem vez deen-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=canonicalapontando 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".
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #4130
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
competitive-platform-analysis
Ajuda a entender seus concorrentes. Ele identifica, classifica e filtra empresas concorrentes antes de qualquer análise mais profunda.
affaan-m/ECC
competitive-report-structure
Cria relatórios completos sobre concorrentes. Junta informações para mostrar o cenário geral, recomendações e ajuda a alinhar a equipe.
affaan-m/ECC
lead-intelligence
Ajuda seu agente a encontrar e contatar pessoas importantes. Ele analisa leads, sugere abordagens e gerencia o contato por e-mail e redes sociais.
affaan-m/ECC