SEO programático · ·
Distribuir conteúdo sem confundir a versão principal
Escolher onde publicar e como indicar a versão de referência, compreendendo os limites da consolidação de endereços.
Este capítulo faz parte do curso gratuito SEO programático.
Republicar uma peça em outro domínio exige decidir como a cópia será descoberta e indexada. Declarar a origem ajuda a comunicar a relação entre as versões, mas não garante que o Google escolha a original. Quando o objetivo é evitar competição na busca com uma cópia sindicada, o guia oficial de canonicalização recomenda que o parceiro bloqueie a indexação dessa cópia; se o controle não estiver disponível, a equipe precisa avaliar o risco antes de distribuir.
O caso de abertura é um risco de duplicação e atribuição incorreta. O roteiro antigo deste curso previa publicar no Medium via API. O aluno chegava no passo de gerar o integration token e a plataforma simplesmente não emitia mais. O tutorial não estava errado quando foi escrito, envelheceu. E é esse envelhecimento silencioso, sem aviso, sem erro de compilação, sem alerta no painel, que faz de qualquer API de terceiro uma dependência de risco.
# Sonda executada em 19/07/2026. Rode você mesmo, leva dez segundos.
curl -s -i https://api.medium.com/v1/me
# HTTP/2 401
# {"errors":[{"message":"An access token is required.","code":6000}]}
curl -s -i https://api.medium.com/v1/me \
-H "Authorization: Bearer token-que-nao-existe"
# HTTP/2 401
# {"errors":[{"message":"Token was invalid.","code":6003}]}Leia essas duas respostas com cuidado, porque a interpretação preguiçosa leva ao diagnóstico errado nas duas direções.
O host está de pé. Ele diferencia ausência de token (código 6000) de token inválido (código 6003), o que só acontece quando existe camada de autenticação funcionando por trás. Uma API morta de verdade devolve 404, 410, DNS que não resolve ou timeout. Esta devolve erro bem formado.
Ao mesmo tempo, o repositório oficial Medium/medium-api-docs foi arquivado pelo proprietário em 02/03/2023, está em modo somente leitura, e exibe o aviso literal "The Medium API is no longer supported. We do not recommend using it." Sobre autenticação via navegador, o mesmo README declara "We don't allow any new integrations with our API." A emissão de novos integration tokens parou, com corte reportado em 1 de janeiro de 2025, e a documentação do n8n registra o mesmo comportamento: credenciais antigas continuam visíveis, novas integrações não podem ser configuradas.
O status correto tem três partes e nenhuma delas sozinha descreve a situação: oficialmente descontinuada, infraestrutura respondendo, fechada para novos usuários. Quem já tem token provavelmente ainda publica. Quem começa hoje não consegue a credencial, e portanto não tem projeto.
Ver como texto
Escada de quatro checagens de saúde de uma API de terceiro, aplicada ao Medium em 19 de julho de 2026: repositório oficial arquivado, changelog sem sucessor, emissão de credencial nova interrompida e sonda HTTP devolvendo 401 bem formado. Ao pé da figura, as duas respostas reais da sonda e o veredito de três partes.
O Hashnode envelheceu do mesmo jeito, por outro caminho. O changelog oficial de 13/05/2026 diz literalmente: "Reads used to be free. They aren't anymore. Queries against your publication now require Pro, the same as publishing." O Hashnode Pro foi lançado em 11/06/2026 como assinatura por publicação, com preço por assento, e desbloqueia domínio customizado, acesso à API GraphQL, modo headless, webhooks, backup no GitHub e importação em massa. Publicações que já usavam webhooks, domínio customizado ou backup no GitHub antes do lançamento mantiveram acesso por grandfathering. Consequência direta: qualquer material que apresente o Hashnode como opção gratuita de sindicação via API está errado desde 13/05/2026, inclusive material publicado esta semana que foi copiado de material antigo.
O DEV.to, rodando sobre o Forem, segue aberto e é o destino principal deste módulo. Base em https://dev.to/api, autenticação por header api-key gerado nas configurações da sua conta, e um header de versão que quase todo tutorial esquece: Accept: application/vnd.forem.api-v1+json.
Esse header não é decoração. A v0 está deprecada e será removida em release futura, então código que não declara a v1 está escrito contra uma superfície com data de validade. A sonda de 19/07/2026 em GET https://dev.to/api/articles retornou HTTP 200.

Fonte: developers.google.com · Captura em 29/10/2026 · trecho de página pública
Ver como texto
Captura da documentação oficial: métodos de consolidação e limites do sinal de URL preferida.
# Exemplo completo: publica no DEV.to com canonical para o seu domínio.
# Substitua DEVTO_API_KEY pela chave gerada em dev.to/settings/extensions.
curl -s -X POST https://dev.to/api/articles \
-H "api-key: $DEVTO_API_KEY" \
-H "Accept: application/vnd.forem.api-v1+json" \
-H "Content-Type: application/json" \
-d '{
"article": {
"title": "Gasolina no interior de SP: o que a semana da ANP mostrou",
"published": true,
"series": "Radar de Preço de Combustível",
"tags": ["brasil", "dados", "seo"],
"canonical_url": "https://seu-dominio.com.br/analises/2026-07-17-gasolina-interior-sp",
"body_markdown": "A série histórica semanal da ANP fechou na sexta.\n\nO preço médio da gasolina comum em Ribeirão Preto ficou em R$ X,XX...\n\nDados: ANP, série histórica de preços de combustíveis, coleta da semana de 12 a 18/07/2026."
}
}'
# Resposta esperada: HTTP 201 com o JSON do artigo criado,
# incluindo "id", "url" e o "canonical_url" que você enviou, ecoado de volta.
# Confira o eco: se ele voltar nulo, o canonical não foi aplicado.Duas coisas acontecem nesse 201 e as duas são o ponto da aula.
A primeira é que a peça passou a existir em dois lugares na web com o mesmo texto. A segunda é que o campo canonical_url declara qual dos dois é o original. Ele registra a preferência pela URL original, mas é um sinal, não uma ordem para o Google. Duplicação por si só não prova spam, e o canonical não garante que a cópia deixe de competir na busca. A política de distribuição precisa registrar se o parceiro permite bloquear a indexação da cópia e o que a equipe aceita quando esse controle não existe.
Para atualizar a peça depois, e você vai precisar, porque dado semanal envelhece, o caminho é PUT /api/articles/{id} com o mesmo formato de corpo. O mesmo endpoint promove um rascunho para publicado, o que abre o fluxo que costuma ser o mais saudável: criar com published: false, revisar na interface, publicar depois.
Ver como texto
Comparação lado a lado da mesma peça publicada em dois lugares. À esquerda, sem canonical: nenhuma declaração liga o satélite ao hub e a escolha da versão indexada fica com o buscador. À direita, com canonical: o satélite declara o hub como original e o hub acumula o histórico.
# Atualiza a peca ja publicada (corrige numero, promove rascunho, ajusta canonical).
# O {id} vem do campo "id" da resposta 201 do POST.
curl -s -X PUT https://dev.to/api/articles/1234567 \
-H "api-key: $DEVTO_API_KEY" \
-H "Accept: application/vnd.forem.api-v1+json" \
-H "Content-Type: application/json" \
-d '{
"article": {
"published": true,
"canonical_url": "https://seu-dominio.com.br/analises/2026-07-17-gasolina-interior-sp",
"body_markdown": "Versao corrigida com o dado da semana seguinte...\n"
}
}'
# Resposta esperada: HTTP 200 com o artigo atualizado.A página da v1 do Forem não documenta publicamente nenhum limite de taxa. Isso não significa que não exista, significa que você vai descobrir empiricamente, provavelmente em produção, provavelmente num lote. Trate como limite desconhecido: serialize as chamadas, respeite Retry-After quando vier, e implemente backoff exponencial com teto a partir do primeiro 429 ou 5xx. Publicar uma peça por semana não encosta em limite nenhum. Migrar cinquenta peças de acervo numa tarde encosta.
// sindicar.mjs - Node 22+, sem dependência externa (fetch nativo).
// Publica uma peça no DEV.to com canonical para o hub e backoff no erro.
const API = "https://dev.to/api/articles";
const KEY = process.env.DEVTO_API_KEY;
const HUB = "https://seu-dominio.com.br";
if (!KEY) throw new Error("Defina DEVTO_API_KEY no ambiente.");
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
async function publicar(peca, tentativa = 1) {
const resp = await fetch(API, {
method: "POST",
headers: {
"api-key": KEY,
Accept: "application/vnd.forem.api-v1+json",
"Content-Type": "application/json",
},
body: JSON.stringify({
article: {
title: peca.titulo,
published: true,
series: "Radar de Preço de Combustível",
tags: peca.tags,
// o canonical sempre aponta para o hub, nunca para o satelite
canonical_url: HUB + "/analises/" + peca.slug,
body_markdown: peca.markdown,
},
}),
});
if (resp.status === 201) {
const artigo = await resp.json();
if (artigo.canonical_url !== HUB + "/analises/" + peca.slug) {
throw new Error("Canonical nao foi ecoado como enviado: " + artigo.canonical_url);
}
return artigo;
}
// limite de taxa nao documentado: trate 429 e 5xx com backoff exponencial
if ((resp.status === 429 || resp.status >= 500) && tentativa <= 5) {
const cabecalho = Number(resp.headers.get("retry-after"));
const espera = Number.isFinite(cabecalho) && cabecalho > 0
? cabecalho * 1000
: Math.min(2 ** tentativa * 1000, 60000);
console.warn("HTTP " + resp.status + ", aguardando " + espera + "ms");
await sleep(espera);
return publicar(peca, tentativa + 1);
}
throw new Error("Falha " + resp.status + ": " + (await resp.text()));
}
const leituraSemanal = {
titulo: "Gasolina no interior de SP: o que a semana da ANP mostrou",
slug: "2026-07-17-gasolina-interior-sp",
tags: ["brasil", "dados", "seo"],
markdown: "A série histórica semanal da ANP fechou na sexta...",
};
const artigo = await publicar(leituraSemanal);
console.log("Publicado:", artigo.url, "| canonical:", artigo.canonical_url);Repare no que o script faz depois do 201: ele confere se o canonical_url voltou exatamente como foi enviado, e falha se não voltou. Essa verificação existe porque a falha de sindicação é silenciosa por natureza. A peça publica, o post fica bonito, você recebe curtidas, e o canonical simplesmente não está lá. Você só descobre semanas depois, quando a versão do satélite aparece na busca no lugar da sua.
Sobre o mecanismo de canonicalização em si, você já viu a hierarquia de sinais em [Escolher quais páginas devem aparecer na busca](#indexacao-seletiva-em-render) e ela não muda aqui. Na sindicação, a cópia é deliberada. Os campos canonical_url do DEV.to e originalArticleURL do Hashnode comunicam uma preferência de origem; confira o HTML servido e a seleção observada no Search Console. Se impedir duplicação na busca for requisito, o acordo com o parceiro precisa incluir o controle de indexação, pois canonical sozinho não entrega essa garantia.
Ver como texto
Mapa de hub e satélites: o domínio próprio ao centro como canônico de toda peça, e ao redor os cinco destinos de sindicação, cada um etiquetado com o estado real do seu acesso em 19 de julho de 2026. As setas de canonical correm de fora para dentro, cheias nos destinos abertos e apagadas nos destinos pagos, fechados ou sem API.
A geometria dessa figura carrega a decisão de arquitetura do módulo. O acervo é o ativo, e o acervo mora no hub. Os satélites são superfícies de distribuição alugadas, sujeitas a mudança unilateral de política, como o Medium e o Hashnode acabaram de demonstrar em janelas de dezoito meses. O valor de cada satélite nas respostas de IA também muda sem aviso: em agosto de 2026, a participação do Reddit nas citações do ChatGPT caiu de cerca de 3,83% para 0,52% em poucos dias, segundo a Promptwatch, enquanto no Google a queda foi gradual. A escolha de satélite é por plataforma e com data.
A régua prática de ligação, que sobreviveu de versões anteriores deste curso porque é barata e não depende de nenhuma tese: cada peça sindicada carrega dois a três links para peças relacionadas do seu acervo e ao menos um link para outra plataforma onde você publica. Isso dá ao leitor caminho de saída dentro do seu material, e dá ao rastreador mais de uma porta de entrada para o hub.

Fonte: developers.google.com · Captura em 29/10/2026 · trecho de página pública
Ver como texto
Captura da documentação oficial: exemplo de diretiva e necessidade de acesso para o rastreador.
Uma ressalva que separa este curso do material de mercado. Circula a tese de que multiplicar fontes de publicação aumenta a chance de citação por motor generativo. É um mecanismo plausível, e há razão para achar que faça sentido: mais superfícies indexadas significam mais candidatos a entrar no conjunto de recuperação. Mas isso é raciocínio sobre o mecanismo, não resultado medido. Não existe estudo que isole a variável "sindicou em N plataformas" e meça o efeito sobre citação. Sindique porque distribui conteúdo para leitores reais e porque o custo marginal é próximo de zero depois que o script existe. Se você vender a um cliente que sindicar garante citação em LLM, está vendendo o que não pode entregar.
Etapa do projeto Radar. Sua entrega neste módulo tem duas partes.
Parte 1, a peça sindicada. Escreva uma leitura semanal do movimento de preços, derivada do acervo que você já tem: o que subiu, o que caiu, qual município destoou da média do estado, sempre citando a série histórica semanal da ANP como fonte, com a semana de coleta explícita. Publique via API do DEV.to com canonical_url apontando para a versão no seu domínio, que precisa existir e responder 200 antes de você rodar o script.
Parte 2, o mapa de hub e satélites. Documente, num arquivo do repositório, para cada destino que você considerou: nome, estado do acesso na data em que você verificou, custo de entrada, se aceita canonical e por qual campo, e a data da verificação. Esse arquivo tem data porque vai envelhecer, e a data é o que permite saber quando ele envelheceu.
Critérios de aceite
- A peça publicada no satélite retorna
canonical_urligual à URL do hub, conferido na resposta da API e não na interface. - A URL do hub responde 200 e é a mesma que está no seu sitemap, sem redirecionamento no meio.
- A peça carrega de dois a três links internos e ao menos um link para outra plataforma sua.
- O mapa de destinos tem data de verificação por linha.
Antes de aprovar qualquer plano de sindicação, cobre quatro respostas de quem executa. Qual destino é usado hoje e por qual campo o canonical é declarado (no DEV.to, canonical_url). O que impede os destinos descartados, verificado na documentação oficial e numa sonda HTTP, e não em tutorial. O que acontece na indexação se o canonical faltar, e qual verificação no script pega o erro no mesmo minuto. E, se alguém prometer citação em IA por sindicar em cinco plataformas, qual estudo isola esse efeito, porque nenhum isolou até aqui.
O guia abaixo serve a quem aprova distribuição fora do site próprio, seja o CMO que ouviu a proposta da agência, seja o gerente de conteúdo que vai operar. Ele destrava uma decisão: sindicar, com quais satélites e sob qual controle.

Fonte: developers.google.com · Captura em 29/10/2026 · trecho de página pública
Ver como texto
Captura da documentação oficial: exemplos de links e textos descritivos.
Guia de implementação: sindicar sem perder a autoria
Cinco passos, do mapa de destinos à revisão trimestral.
Passo 1: Montar o mapa de hub e satélites com data
Liste cada destino com estado de acesso, custo de entrada, campo de canonical e data da checagem.
Deu certo quando: Toda linha do mapa tem data de verificação e campo de canonical nomeado.
Erro comum: Copiar a lista de destinos de um tutorial antigo sem checar se a API ainda aceita novos usuários.
Passo 2: Sondar a API antes de escrever código
Confira documentação oficial, changelog, emissão de credencial nova e uma chamada HTTP de teste.
Deu certo quando: As quatro checagens estão registradas com resultado e data.
Erro comum: Ler um 401 bem formado como prova de que a API serve para quem começa hoje.
Passo 3: Publicar primeiro no hub
A peça original existe no seu domínio, responde 200 e está no sitemap antes de qualquer cópia.
Deu certo quando: A URL do hub responde 200 sem redirecionamento no meio.
Erro comum: Sindicar uma URL que ainda não existe ou que redireciona.
Passo 4: Sindicar com verificação automática do canonical
O script confere se o canonical voltou na resposta da API exatamente como foi enviado.
Deu certo quando: O script falha na hora quando o eco do canonical vem nulo ou diferente.
Erro comum: Conferir o canonical só na interface da plataforma, semanas depois.
Passo 5: Revisar os destinos a cada trimestre
Repita as quatro checagens por destino e atualize a data no mapa.
Deu certo quando: Existe lembrete no calendário e o mapa mostra a revisão do trimestre.
Erro comum: Descobrir que a plataforma fechou só quando o pipeline quebra.
No fim você tem: Uma rotina de distribuição em que cada cópia declara a origem, cada destino tem data de verificação e nenhuma dependência de terceiro morre em silêncio.
| Etapa | Quem faz | Prazo e esforço | Como conferir |
|---|---|---|---|
| Mapa de hub e satélites | Gerente de conteúdo | Meio dia; sem custo de licença | Arquivo com uma linha datada por destino |
| Sonda da API | Desenvolvedor | 1 hora por destino | Quatro checagens registradas com resultado |
| Publicação no hub | Gerente de conteúdo | Rotina semanal já existente | URL responde 200 e consta do sitemap |
| Script com verificação do canonical | Desenvolvedor | 1 a 2 dias na primeira vez | Teste com canonical errado faz o script falhar |
| Revisão trimestral | Analista de SEO | 2 horas por trimestre | Data da revisão atualizada no mapa |
Laboratório: diagnosticar uma cópia que disputa a URL do produto. A ConectaCampanha, empresa fictícia deste exercício, encontra a página de um parceiro na busca no lugar da própria explicação de integração. O campo canonical foi enviado pela API, mas isso ainda não prova qual URL o Google selecionou. Antes de alterar todas as páginas, compare uma dupla e registre o estado observado.
Comparar intenção editorial e canonical escolhida
Execute apenas nas propriedades que sua equipe pode consultar. A ausência de acesso à propriedade do parceiro é uma lacuna de observação, não um resultado zero.
Passo 1: Monte a dupla de URLs
Anote original, cópia, data de publicação e qual versão deve receber o visitante. Abra as duas e confira conteúdo, redirecionamentos e canonical no HTML.
Deu certo quando: A ficha distingue a intenção da equipe do que o servidor entrega.
Erro comum: Concluir que o Google respeitou o canonical porque a API devolveu o valor correto.
Passo 2: Inspecione o original no Search Console
Cole a URL na barra de inspeção, abra os detalhes de indexação e compare a canônica declarada pelo usuário com a selecionada pelo Google, quando disponíveis. Registre a data do último rastreamento.
Deu certo quando: Você consegue dizer qual é o estado indexado observado.
Erro comum: Usar o teste de URL publicada para afirmar qual canonical já está no índice.
Passo 3: Separe cópia deliberada de páginas que deveriam ser distintas
Se duas integrações do seu domínio foram agrupadas, compare a informação central. Corrija sinais inconsistentes e inclua as diferenças verificadas que justificam páginas próprias.
Deu certo quando: A correção corresponde ao problema encontrado.
Erro comum: Trocar somente título, cor ou nome do aplicativo e manter o mesmo conteúdo principal.
Passo 4: Escolha a política de republicação
Se a prioridade é impedir que a cópia sindicada concorra na busca, combine com o parceiro o bloqueio de indexação da cópia. Se isso não for possível, avalie publicar apenas um resumo útil com link para o original.
Deu certo quando: O acordo registra o controle disponível e o risco aceito.
Erro comum: Prometer que rel=canonical impede a indexação da cópia.
Passo 5: Registre a correção e reavalie
Guarde evidência do HTML corrigido. Use a solicitação de indexação nas URLs prioritárias e confira novamente após novo rastreamento; registre se o estado continua antigo.
Deu certo quando: A ficha separa correção publicada, rastreamento e seleção observada.
Erro comum: Reenviar a mesma URL repetidamente e interpretar a falta de mudança imediata como falha.
No fim você tem: Entregável: ficha da dupla de URLs com canonical declarada, seleção observada, correção e responsável pela reavaliação.
| Evidência | Decisão | Critério para encerrar |
|---|---|---|
| Canonical aponta por engano para outra integração | Corrigir o template e conferir as rotas afetadas | HTML, links internos e sitemap coerentes com a versão pretendida |
| Duas páginas próprias têm conteúdo central equivalente | Consolidar ou acrescentar informação real que justifique separação | A decisão atende a uma necessidade distinta, sem criar diferença artificial |
| Cópia integral em parceiro pode competir com o original | Negociar bloqueio de indexação ou trocar a cópia por resumo | Controle e responsabilidade documentados com o parceiro |
| Correção publicada, mas ainda não rastreada | Manter registro e reavaliar após o rastreamento | Comparação entre estado anterior e nova observação, sem prazo garantido |
Fonte: Procedimento didático apoiado no guia Google de canonicalização, atualizado em 21/08/2026 e consultado em 17/10/2026.
O changelog do Google de 10/07/2026 esclareceu o tempo de reavaliação: páginas corrigidas podem permanecer agrupadas como duplicadas por até duas semanas. Isso descreve um comportamento possível, não um prazo de indexação garantido. O guia também recomenda bloquear a indexação da cópia quando o objetivo é evitar duplicação por parceiros de sindicação.
Peça hoje o mapa de destinos com data por linha e o resultado da sonda de cada API. Confira na primeira peça sindicada: a resposta da API precisa ecoar o canonical_url igual à URL do hub, e essa URL precisa responder 200. Se em três meses o mapa não tiver revisão datada, suspenda a sindicação até ela existir.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
- CursoSEO e GEO para quem decide
- Entenda por que sua página aparece ou some do Googlesugerido pelo grafoApresenta os conceitos “Canonical”, “Indexação” e “Crawling”, usados em “Distribuir conteúdo sem confundir a versão principal”.
- Consulte um termo e veja como usá-losugerido pelo grafoApresenta o conceito “Internal linking”, usado em “Distribuir conteúdo sem confundir a versão principal”.
- SEO e GEO para quem decideQuando duas páginas suas disputam a mesma buscaExaminar conexões de Quando duas páginas suas disputam a mesma busca
- Vibecoding para SEOPublicar sem quebrar: prévia, verificação e volta atrásExaminar conexões de Publicar sem quebrar: prévia, verificação e volta atrás
- Bastidores: como este portal produz e confere os cursosComo aprovar uma mudança e confirmar que ela está no arExaminar conexões de Como aprovar uma mudança e confirmar que ela está no ar
- Autoridade temáticaDar uma função clara a cada páginaExaminar conexões de Dar uma função clara a cada página
Terminou a leitura?
Você está aqui: capítulo 11 de 21
0 de 21 concluídos
- Próximo · Capítulo 12 de 21 · 35 minAcompanhar o acervo no Search ConsoleLer o capítulo 12 sem concluir
Marque como concluído para o capítulo contar no seu painel e no certificado.
- Anterior · Capítulo 10 de 21 · 41 minEscolher quais páginas devem aparecer na buscaVoltar para o capítulo 10
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
- 09Construir um modelo de página que responda bem
- 10Escolher quais páginas devem aparecer na busca
- 11Distribuir conteúdo sem confundir a versão principal
- 12Acompanhar o acervo no Search Console
- 13Avaliar o que favorece a presença nas respostas de IA