ForHosting KIT · SEO

Verifique conflitos de canonical e riscos entre domínios

Digite o endereço da página e o da sua tag canonical e saiba na hora se coincidem: no exemplo, uma página de produto terminada em #details coincide, porque os fragmentos são removidos antes da comparação. Uma canonical em outro domínio é marcada como risco alto. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

URL da página: https://www.example.com/products/blue-widget#details
URL canônico: https://www.example.com/products/blue-widget

Você obtém

URL da página normalizado: https://www.example.com/products/blue-widget
URL canônico normalizado: https://www.example.com/products/blue-widget
Risco: none

Uma tag canonical pode parecer válida e, mesmo assim, afastar silenciosamente os buscadores da página que você pretende indexar. Este verificador compara a URL da página com o endereço declarado na tag, informa se coincidem após uma normalização segura e destaca como alto risco qualquer domínio de destino diferente. Assim, você pode revisar alterações de template, migrações e erros de publicação antes que prejudiquem os sinais de indexação.

O que significa um conflito de canonical

A tag canonical informa aos buscadores qual URL deve representar uma página quando vários endereços exibem material igual ou muito parecido. Uma canonical autorreferente normalmente repete a URL da página e oferece aos rastreadores um endereço preferencial inequívoco. Existe conflito quando a URL enviada e o valor canonical geram textos normalizados diferentes.

A diferença pode ser proposital, como quando uma URL de rastreamento consolida sinais em uma página limpa, mas merece revisão porque pode transferir autoridade para fora do endereço atual. O resultado traz as duas URL analisadas, as formas comparadas sem fragmentos, indicadores de correspondência e conflito e uma mensagem clara. A ferramenta não rastreia destinos nem decide se dois conteúdos são equivalentes; ela responde de modo determinístico se a canonical identifica a URL fornecida.

Isso atende a verificações de implantação, auditorias, fluxos editoriais e testes automatizados que exigem uma resposta transparente.

Como as URL são validadas e comparadas

Os dois campos são interpretados como URL; valores malformados, caminhos relativos, esquemas não aceitos, campos ausentes e endereços com credenciais incorporadas são rejeitados como entrada inválida. Essa regra impede que um trecho HTML, um host isolado ou um caminho como /produtos/item seja tratado como destino completo. Na comparação, a análise padrão normaliza detalhes como maiúsculas no host e portas padrão explícitas.

Os fragmentos são removidos porque apontam para uma posição no documento, não para outro documento. Esquema, host, caminho, consulta e porta não padrão continuam relevantes. As formas normalizadas retornadas mostram exatamente o que foi comparado e ajudam você a entender a divergência.

Por que outro domínio recebe alto risco

Uma canonical direcionada a outro host pode ser legítima em artigos sindicados, conteúdo licenciado ou migrações cuidadosamente controladas. Também pode ser um erro grave de produção provocado por configuração de homologação, domínio antigo, template copiado ou marcação comprometida. Por isso, qualquer mudança de host é classificada como entre domínios e recebe risco alto, mesmo quando intencional.

Risco alto indica prioridade de revisão, não certeza de erro. Confirme que os responsáveis entendem a consolidação, que o destino é a versão autorizada e que redirecionamentos, sitemaps, links internos e hreflang apoiam a decisão. Divergências no mesmo domínio recebem alerta porque também podem consolidar a URL em categoria, produto, idioma ou variante incorreta.

Uma correspondência não apresenta risco. Use a verificação ao publicar, migrar, alterar rotas ou templates; na integração contínua, bloqueie conflitos inesperados e exija aprovação para cada resultado entre domínios.

Casos de uso

Detectar vazamento para homologação

Compare uma página de produção com sua canonical e sinalize imediatamente um host esquecido de homologação ou visualização.

Testar templates após a implantação

Confira pares representativos depois de mudar o CMS ou as rotas e encontre alterações indevidas de caminho, consulta, esquema ou host.

Revisar sinais de migração

Identifique declarações entre domínios durante uma mudança e valide cada resultado de alto risco com o mapa aprovado.

Perguntas frequentes

Por que uma canonical entre domínios tem alto risco?

Ela pode consolidar conteúdo sindicado ou migrado, mas também enviar sinais a homologação, domínio antigo ou outro proprietário. Todo resultado exige revisão.

Uma divergência sempre significa erro?

Não. Variantes com parâmetros, páginas duplicadas, distribuição e migrações podem usar outra canonical intencionalmente. A divergência pede revisão.

O que conta como coincidência?

As duas URLs precisam ficar idênticas depois de uma normalização segura: maiúsculas no domínio e portas padrão explícitas são ajustadas e o fragmento após # é removido. Protocolo, domínio, caminho, a parte depois do ponto de interrogação e porta não padrão continuam contando.

Variantes com www, https ou barra final contam como iguais?

Não. Etiquetas de rastreamento, o www, a diferença entre http e https e a barra final são comparados como estão escritos, porque reescrevê-los poderia esconder um erro real do modelo de página. Só maiúsculas no domínio, portas padrão e fragmentos são normalizados.

Por que um dos meus endereços é recusado?

Porque não é um endereço completo válido: um caminho relativo, um protocolo diferente de http ou https, um valor vazio ou malformado, ou um endereço com usuário e senha embutidos. Os dois precisam ser absolutos para a comparação ser segura.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/seo/canonical-conflict-check

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/seo/canonical-conflict-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_url":"https://www.example.com/products/blue-widget","canonical_url":"https://www.example.com/products/blue-widget"}'

const res = await fetch("https://api.kit.forhosting.com/seo/canonical-conflict-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "page_url": "https://www.example.com/products/blue-widget",
    "canonical_url": "https://www.example.com/products/blue-widget"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/seo/canonical-conflict-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "page_url": "https://www.example.com/products/blue-widget",
    "canonical_url": "https://www.example.com/products/blue-widget"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/canonical-conflict-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"page_url":"https://www.example.com/products/blue-widget","canonical_url":"https://www.example.com/products/blue-widget"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"page_url":"https://www.example.com/products/blue-widget","canonical_url":"https://www.example.com/products/blue-widget"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/canonical-conflict-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "page_url": "https://www.example.com/products/blue-widget",
  "canonical_url": "https://www.example.com/products/blue-widget"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "seo.canonical_conflict_check",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

Como as URL são validadas e comparadas

Informe o endereço HTTP ou HTTPS absoluto da página e o valor absoluto encontrado na tag canonical. O verificador não remove parâmetros, unifica hosts www, força HTTPS nem considera barras finais equivalentes. Essas transformações poderiam esconder inconsistências reais.

Perguntas técnicas

O que conta como correspondência?

As URL HTTP ou HTTPS analisadas devem ser idênticas após a normalização padrão e a remoção de fragmentos. Caminhos, consultas, esquemas e hosts continuam significativos.

O verificador acessa alguma URL?

Não. Ele apenas valida e compara de forma determinística; não inspeciona conteúdo, redirecionamentos, status HTTP, regras robots nem a canonical do destino.

Valores canonical relativos são aceitos?

Não. O valor precisa ser uma URL HTTP ou HTTPS absoluta para explicitar o destino sem inventar um endereço base.

Quanto custa a verificação pela API?

Cada solicitação pela API custa US$ 0,002. A versão no navegador executa gratuitamente a mesma comparação determinística no dispositivo.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que significa um conflito de canonical

Como as URL são validadas e comparadas

Por que outro domínio recebe alto risco

Casos de uso

Detectar vazamento para homologação

Testar templates após a implantação

Revisar sinais de migração

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Erros

Notas técnicas

Como as URL são validadas e comparadas

Perguntas técnicas

obrigado