Configurações de cookies

Os cookies necessários mantêm o site funcionando. A análise mostra quais páginas são úteis. Você pode mudar sua escolha a qualquer momento pelo rodapé.

Política de cookies deste site — detalhes completos: categorias de cookies, como guardamos sua escolha no navegador e como retirar o consentimento.

Necessários

Funções básicas do site e sua escolha de consentimento. Sempre ativos.

Análise

Ajuda a entender como o site é usado. Carregado apenas com sua permissão.

GitHubBaixar ZIP

Verificador de hreflang

Verifique o hreflang de uma única URL ou de um conjunto inteiro de páginas: códigos de idioma e região, autorreferência, duplicatas, x-default, links de retorno e alternativas (alternates) que redirecionam, falham ou têm noindex.

Ver no GitHubInício rápido

O que faz

  • Terminal: seohead hreflang-check

Em todo o conjunto

Links de retorno e confirmação exigem todas as páginas do conjunto, porque comparam o que a página A declara sobre a página B com o que a página B declara de volta. Essas verificações funcionam sobre dados de rastreamento, como uma exportação All Hreflang do Screaming Frog, e não sobre uma única página. Elas também analisam os destinos das alternativas: se cada um responde 200, é indexável e é a própria canônica.

  • Links de retorno ausentes e pares não confirmados
  • Alternativas que redirecionam, retornam 4xx ou 5xx, ou têm noindex
  • Alternativas que não são a versão canônica da página
  • Alternativas que nenhum link interno aponta

URL única

O hreflang-check busca uma página, segue os redirecionamentos e lê os links de alternativas no HTML. Ele valida todos os códigos de idioma, script e região, identifica valores duplicados e confere se a página se lista e se existe um x-default. Ele não requisita as alternativas, então serve como uma primeira olhada rápida antes de fazer um rastreamento completo.

  • Códigos de idioma, script e região verificados contra ISO 639-1, ISO 15924 e ISO 3166-1
  • Autorreferência e valores duplicados
  • Presença de x-default
  • Uma página 4xx ou 5xx é informada como erro, não como resultado limpo

Posicionamento

Um link hreflang só conta se o parser o ler dentro do head. Um rastreamento nativo compara a posição de cada link de alternativa e sinaliza os que acabam no body, geralmente por causa de uma tag quebrada acima deles no head. Corrigir essa tag corrige a anotação.

  • Links de alternativas fora do head são informados
  • Maiúsculas não importam: en-us e en-US são o mesmo valor
  • Erros comuns, como en-UK, são detectados

Três passos, um rastreamento salvo

  1. Verifique uma URL ao vivo

    O hreflang-check busca a página, segue os redirecionamentos e lê os links de alternativas no HTML. Ele verifica códigos, autorreferência, duplicatas e x-default.

  2. Verifique o conjunto em um rastreamento

    Links de retorno, destinos quebrados ou com redirecionamento e destinos com noindex exigem todas as páginas do conjunto. Essas verificações funcionam sobre uma exportação All Hreflang do Screaming Frog, pelo seohead sf run, e não sobre uma única página.

  3. Corrija os pares e verifique de novo

    Cada problema indica a página e a alternativa envolvida. Corrija a anotação no site e execute a verificação de novo.

Verificações deste recurso

VerificaçãoO que significaGravidadeEvidência
HREFLANG_MISSING_RETURN_LINKOutra página indica esta URL no hreflang dela, mas esta página não aponta de voltaImportantPágina de origem e a alternativa que não tem o link de retorno (rastreamento)
HREFLANG_BROKEN_TARGETUma URL alternativa responde com status 3xx, 4xx ou 5xxImportantURL de destino e o seu código de status (rastreamento)
HREFLANG_NOINDEX_TARGETUma URL alternativa tem a diretiva noindexImportantURL de destino e o sinal de noindex (rastreamento)
HREFLANG_INVALID_CODEUm valor de idioma ou região não é um código válido da ISO 639-1, ISO 15924 ou ISO 3166-1, por exemplo en-UKImportantO valor hreflang bruto e a página em que ele está (URL única: “malformed hreflang code”)
HREFLANG_MISSING_SELF_REFERENCEA página tem alternativas, mas nenhuma delas é a própria URLImportantA URL da página e a lista de alternativas (URL única: “page does not self-reference”)
HREFLANG_MULTIPLE_ENTRIESO mesmo valor de idioma e região aparece mais de uma vez na mesma páginaImportantO valor repetido e os seus hrefs (URL única: “duplicate hreflang”)
HREFLANG_MISSING_XDEFAULTO conjunto não tem uma alternativa x-default de fallback para usuários cujo idioma não corresponde a nenhuma alternativaTipA página e a sua lista de alternativas (URL única: “no x-default alternate”)
Também no registro de verificações
HREFLANG_ERRORHREFLANG_INCONSISTENT_CONFIRMATIONHREFLANG_NOT_CANONICALHREFLANG_UNLINKED_TARGETHREFLANG_OUTSIDE_HEAD

Um comando

bash
seohead hreflang-check --url https://example.com/en/

Instale primeiro: guia de instalação. Todo comando também funciona como ferramenta MCP para agentes de IA.

O que você precisa

  • Uma URL de página para o hreflang-check
  • Um rastreamento ou uma exportação All Hreflang do Screaming Frog para as verificações do conjunto
  • Nenhuma chave de API

Limites

  • A verificação de uma única URL não requisita as alternativas, então não enxerga os códigos de status, o noindex nem os links de retorno delas
  • Ela lê apenas os elementos link do HTML, não o hreflang nos sitemaps nem nos cabeçalhos Link de resposta HTTP
  • As verificações do conjunto são documentadas para exportações de hreflang do Screaming Frog; uma varredura nativa não guarda dados de hreflang
  • Um código válido não prova que a página está naquele idioma

Perguntas

A verificação de uma única URL testa todas as alternativas?
Não. Ela lê os links de alternativas da própria página e verifica os códigos, as duplicatas, o x-default e a autorreferência da página. Ela não requisita cada alternativa, então destinos quebrados, com redirecionamento ou com noindex e links de retorno ausentes exigem um rastreamento.
Isso altera alguma coisa no meu site?
Não. A verificação envia apenas requisições GET de leitura. Nada é gravado no site.
Quais códigos de idioma são válidos?
Um código de idioma da ISO 639-1, opcionalmente seguido de um script da ISO 15924 e depois de uma região da ISO 3166-1 alpha-2 ou da UN M.49. Os códigos não diferenciam maiúsculas de minúsculas, então en-us e en-US são o mesmo valor. en-UK é rejeitado, porque o código do país é GB.
Ele lê o hreflang de sitemaps ou de cabeçalhos HTTP?
A verificação de URL única lê apenas os elementos link na resposta HTML. O hreflang declarado em um sitemap ou em um cabeçalho Link HTTP não é lido por este comando.
O que acontece se a página retornar erro?
A verificação informa o status HTTP e diz que não havia anotações para checar. Uma página 4xx ou 5xx nunca aparece como resultado limpo.
A falta de x-default é um erro?
É o problema mais leve. O x-default é um fallback para usuários cujo idioma não corresponde a nenhuma alternativa. É útil, mas não obrigatório, então o registro classifica como aviso, abaixo dos problemas que quebram a anotação.

Continue explorando

Do blog e do glossário

Hreflang: guia completo de SEO internacionalBlogSEO multilíngue: hreflang, estrutura e localizaçãoBlogHreflangGlossárioSEO multilíngueGlossárioDirecionamento de idiomaGlossário

Mais neste grupo · Auditoria

Auditoria técnica de SEORecursoVerificador de redirecionamentos: cadeias, loops e 302sRecursoVerificador de links quebrados com origem e posiçãoRecursoVerificador de tag canonicalRecursoValidador de dados estruturados e de schemaRecursoVerificador de title e meta descriptionRecursoVerificador de estrutura de títulosRecursoVerificador de conteúdo duplicado e rasoRecursoVerificador e otimizador de SEO para imagensRecursoAuditoria de linkagem interna e profundidade de rastreamentoRecursoPeso da página e verificações de velocidadeRecursoVerificação de HTTPS e de cabeçalhos de segurançaRecursoVisibilidade na busca por IA (GEO/AEO)Recurso

Teste no seu próprio site

Baixar ZIPTodos os recursos