--- title: "URL canônica: qual versão da página vale | Grupo Marfre" description: "URL canônica é a versão da página que vale quando há cópias. Veja a tag canonical, o espelho .md, o sitemap e as variações com barra, www e http." canonical: https://grupomarfre.com.br/sites-agenticos/canonical/ alternate_html: https://grupomarfre.com.br/sites-agenticos/canonical/ language: pt-BR last_updated: 2026-10-27 type: guia --- # URL canônica: qual versão da página vale **Resposta rápida:** URL canônica é o endereço que você declara como a versão oficial de uma página que existe em mais de um endereço. Ela vai na tag link rel=“canonical” e evita que cópias disputem entre si. Na régua do Grupo Marfre, a canônica do espelho em Markdown é o HTML, e o .md fica fora do sitemap. URL canônica é o endereço que representa a versão oficial de uma página. Quando o mesmo conteúdo abre em mais de um endereço, a canônica diz às máquinas qual deles vale. Sem essa indicação, quem lê o site por máquina precisa adivinhar, e a cópia errada pode ser a que circula. A regra prática: cada conteúdo tem um único endereço canônico, e todas as outras versões apontam para ele ou redirecionam para ele. ## Como se declara a tag canonical? A declaração fica no `` da página, com o endereço completo e absoluto: ```html ``` A página canônica aponta para si mesma (canonical autorreferente). As variações apontam para a versão que vale. O endereço deve ser idêntico ao usado no sitemap e nos links internos. ## Por que o espelho .md aponta o HTML como canônico? O espelho em Markdown é uma cópia do mesmo conteúdo. Se ele concorresse com o HTML, seria conteúdo duplicado. Por isso, na régua do Grupo Marfre, o `.md` declara o HTML como canônica no frontmatter, leva `X-Robots-Tag: noindex` e não entra no sitemap. O `.md` sai da mesma fonte do HTML, gerado e nunca redigido à parte, com os campos `title`, `description`, `canonical`, `alternate_html`, `language`, `last_updated` e `type`. Exemplo fictício: ```yaml --- title: Limpeza de pele description: Como funciona a limpeza de pele na Clínica Exemplo. canonical: https://www.exemplo.com.br/servicos/limpeza-de-pele/ alternate_html: https://www.exemplo.com.br/servicos/limpeza-de-pele/ language: pt-BR last_updated: 2026-10-27 type: service --- ``` Veja os detalhes em [espelho em Markdown por página](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/) e em [frontmatter YAML no espelho](https://grupomarfre.com.br/sites-agenticos/frontmatter-do-markdown/). ## O que acontece com Googlebot, Bingbot e robôs de IA? Pelo método do Grupo Marfre, o `.md` é servido a quem manda `Accept: text/markdown`, a quem acrescenta `?mode=agent` e ao user-agent de robô de IA. Googlebot e Bingbot recebem o HTML, que é a canônica. Toda resposta leva `Vary: Accept, Accept-Encoding, User-Agent` e um cabeçalho `Link` apontando o `.md`, o llms.txt e o sitemap. Mais em [negociação de conteúdo](https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/). ## Barra final, www e http contam como versões diferentes? Sim. Para uma máquina, cada combinação abaixo é um endereço distinto: | Variação | Exemplo fictício | | --- | --- | | http | [http://exemplo.com.br/servicos/](http://exemplo.com.br/servicos/) | | https sem www | [https://exemplo.com.br/servicos/](https://exemplo.com.br/servicos/) | | https com www | [https://www.exemplo.com.br/servicos/](https://www.exemplo.com.br/servicos/) | | sem barra final | [https://www.exemplo.com.br/servicos](https://www.exemplo.com.br/servicos) | Escolha uma combinação e use-a em todo lugar: canonical, links internos e sitemap. Redirecione as demais com [301](https://grupomarfre.com.br/sites-agenticos/redirecionamentos-301/). O sitemap deve listar só a versão canônica, com [lastmod real](https://grupomarfre.com.br/sites-agenticos/sitemap-com-lastmod/). ## Como conferir se a canônica está certa? Rode dois pedidos e compare o resultado: ```bash curl -s https://www.exemplo.com.br/servicos/ | grep -i canonical curl -s -D - -o /dev/null -H "Accept: text/markdown" https://www.exemplo.com.br/servicos/ ``` O primeiro deve mostrar a própria URL. O segundo mostra os cabeçalhos de um GET e deve trazer o `Vary` com `Accept` e o `Link` para o `.md`. Outras receitas estão em [como testar a camada agêntica com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/). ## Perguntas frequentes ### A canonical substitui o redirecionamento 301? Não. A canonical indica a versão preferida, mas o endereço alternativo continua abrindo. O 301 leva o visitante e o robô para o endereço certo. Para variações de http, www e barra, o redirecionamento é o caminho principal. ### A página precisa de canonical se não tem cópia? Convém declarar mesmo assim, apontando para si mesma. Isso protege contra variações criadas sem querer, como parâmetros no final do endereço. ### O espelho .md deve ter canonical próprio? Não. Na régua do Grupo Marfre, o campo `canonical` do `.md` aponta para o HTML. O espelho existe para leitura por agentes, não para ser indexado. ## Leia também ### [Espelho em Markdown de cada página: o que é e como gerar](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/) Espelho em Markdown de cada página: o que é, como nomear o arquivo .md, gerar da mesma fonte do HTML, o que tirar e como evitar conteúdo duplicado. ### [Frontmatter YAML no espelho Markdown: os campos que importam](https://grupomarfre.com.br/sites-agenticos/frontmatter-do-markdown/) Frontmatter YAML no espelho Markdown: os 7 campos (title, description, canonical, alternate\_html, language, last\_updated, type), exemplo e erros de formato. ### [Negociação de conteúdo: servir Markdown a quem pede Accept: text/markdown](https://grupomarfre.com.br/sites-agenticos/negociacao-de-conteudo-markdown/) Negociação de conteúdo em Markdown: como servir o .md a quem manda Accept: text/markdown, ?mode=agent ou user-agent de IA, e testar tudo com curl. ### [Redirecionamentos 301 limpos: o que o agente segue e o que quebra](https://grupomarfre.com.br/sites-agenticos/redirecionamentos-301/) Redirecionamento 301 para site agêntico: cadeia, 301 x 302, barra final, http para https e www. Veja o que o agente segue e como testar com curl -sIL. ### [Sitemap com lastmod real: por que importa e o erro da data cosmética](https://grupomarfre.com.br/sites-agenticos/sitemap-com-lastmod/) Sitemap com lastmod real: liste só HTML canônico, atualize a data quando o conteúdo mudar, deixe o .md de fora e envie ao Search Console e ao Bing. ### [Agente de IA: o que é](https://grupomarfre.com.br/sites-agenticos/agente-de-ia/) Agente de IA é um sistema que recebe um objetivo e executa os passos sozinho com ferramentas. Veja a diferença para chatbot e o efeito no seu site. --- ## Sobre o Grupo Marfre Grupo Marfre Automação e Tecnologia LTDA (CNPJ 49.685.676/0001-55): agência de marketing digital e inteligência artificial com base em Contagem/MG, que atende o Brasil inteiro de forma remota. - Endereço: Alameda das Cotovias, 75, Cabral, Contagem - MG, Brasil - WhatsApp: (31) 93618-7272, https://wa.me/5531936187272 - E-mail: contato@grupomarfre.com.br - Instagram: https://instagram.com/marfregrupo - Serviços: gestão de tráfego pago (Meta Ads e Google Ads), site agêntico (site pronto pra assistentes de IA lerem), site que vira contato, SEO e Google, IA no WhatsApp, CRM e automação - Serviço de site agêntico: https://grupomarfre.com.br/servicos/site-agentico/ · serviço de gestão de tráfego: https://grupomarfre.com.br/servicos/gestao-de-trafego/ - Guias: https://grupomarfre.com.br/sites-agenticos/ e https://grupomarfre.com.br/gestao-de-trafego/ - Método em 4 etapas: Diagnóstico, Estratégia, Execução, Otimização - Segmentos já atendidos: clínica, consultório, advocacia, loja, igreja - Preço e escopo não são publicados: são definidos por diagnóstico, caso a caso - Todas as páginas em Markdown: https://grupomarfre.com.br/llms.txt · conteúdo completo: https://grupomarfre.com.br/llms-full.txt Página HTML equivalente: https://grupomarfre.com.br/sites-agenticos/canonical/