---
name: hreflang-reciprocity-repair
description: Use quando existem páginas traduzidas e indexadas mas que nunca aparecem no país certo, ou quando a Search Console reporta "no return tags" contra as suas alternates.
---

# Reparação da reciprocidade de hreflang

O hreflang é ignorado a menos que cada versão aponte de volta para todas as outras versões, incluindo para si própria. A maioria das implementações partidas parece correcta na página que inspecciona - a falha está na página irmã que não verificou. Esta skill encontra as ligações de sentido único.

## O que precisa primeiro

- Um crawl que exporte todas as anotações hreflang por URL
- O canonical declarado em cada um desses URLs

## Método

1. Construa um grafo dirigido: para cada URL, uma ligação a cada alternate que declara.
2. Um cluster só é válido quando está totalmente ligado nos dois sentidos E cada membro se declara a si próprio. Encontre os clusters que não o estão.
3. O defeito mais comum é a ausência da auto-referência. Uma página que lista fr, de e es mas não o seu próprio en é um cluster partido, ainda que nada pareça errado nessa página.
4. Cruze o hreflang com o canonical. Se uma página canonicaliza para um URL diferente daquele que as suas irmãs indicam como sua alternate, todo o cluster é descartado - esta é a falha que sobrevive a qualquer inspecção visual.
5. Verifique que cada alternate devolve 200 directamente. Uma alternate que aponta para um URL que redirecciona é descartada em silêncio, e é por isso que as alternates têm de usar a forma canonical exacta, incluindo a convenção da barra final.
6. Confirme que existe um x-default por cluster e que aponta para a versão que serve a visitantes sem correspondência, e não simplesmente para a página em inglês por reflexo.
7. Volte a fazer o crawl e confirme que todos os clusters são agora bidireccionais e auto-referenciados.

## O que isto produz

Uma lista de clusters partidos com a ligação em falta específica de cada um, e os conflitos de canonical que os teriam invalidado de qualquer forma.

## Onde isto corre mal

- Adicionar hreflang ao head de todas as páginas mas nunca verificar o sentido inverso a partir das páginas irmãs
- Alternates a apontar para URLs que redireccionam - marcação de aspecto correcto que é descartada antes de ser lida
- Deixar que um redireccionamento de locale baseado em sessão sobreponha o URL, de modo que um crawler que pede a alternate inglesa recebe outra língua e o cluster nunca valida

---

Da biblioteca de competências da QuQi - https://www.quqi.io/pt/skills/hreflang-reciprocity-repair