Docsbook
Visão geral

SEO de documentação multilíngue: hreflang e URLs

A maioria da documentação de produtos em 2026 está disponível apenas em inglês. As equipes que traduzem corretamente capturam tráfego orgânico que os sites disponíveis apenas em inglês nunca alcançam — pesquisas em japonês, espanhol, alemão e mandarim com a mesma intenção de compra.

Este post é o guia prático de SEO para publicar documentação em 15 idiomas sem prejudicar o Google ou as buscas por IA.

Resumo#

  • Cada idioma deve estar em um URL separado (/ja/, /es/, /de/)
  • Adicione tags hreflang para que os mecanismos de pesquisa saibam qual é a tradução de qual conteúdo
  • Use o atributo lang no elemento <html>
  • A tradução por IA em 2026 é boa o suficiente para documentação (não para textos de marketing)
  • Uma única fonte canônica em inglês, traduções por IA por cima — nunca duplique as fontes

A regra fundamental#

Um URL por par (página, idioma).

Errado:

docs.yourcompany.com/quick-start?lang=ja
docs.yourcompany.com/quick-start (with cookies)

Correto:

docs.yourcompany.com/quick-start
docs.yourcompany.com/ja/quick-start
docs.yourcompany.com/es/quick-start

Sem URLs separadas, não há nada para um mecanismo de pesquisa indexar por idioma: um URL contém um documento no índice, portanto, o idioma que ele viu é o único que pode obter uma boa classificação. Todos os outros locais ficam invisíveis para as pesquisas no próprio idioma, por melhor que seja a tradução.

configuração de hreflang#

Cada página precisa de tags <link rel="alternate" hreflang="..."> apontando para cada tradução.

<link rel="alternate" hreflang="en" href="https://docs.yourcompany.com/quick-start">
<link rel="alternate" hreflang="ja" href="https://docs.yourcompany.com/ja/quick-start">
<link rel="alternate" hreflang="es" href="https://docs.yourcompany.com/es/quick-start">
<link rel="alternate" hreflang="x-default" href="https://docs.yourcompany.com/quick-start">

x-default diz ao Google: "se nenhuma outra localidade corresponder, mostre isto." Geralmente, a versão em inglês.

O Docsbook gera hreflang automaticamente quando você ativa um idioma em Configurações → Idiomas.

Quando a tradução por IA é boa o suficiente#

Três fatores:

Tipo de conteúdo Qualidade da tradução por IA Recomendação
Documentação de referência (API, configuração) Alta Usar IA
Tutoriais e guias práticos Alta Usar IA, com uma revisão humana superficial
Páginas de destino de marketing Média Revisão humana necessária
Textos de marca (slogans, missão) Baixa Tradução humana
Exemplos de código N/A Manter original
Mensagens de erro Alta quando a terminologia é consistente Usar IA

A qualidade da tradução por LLM para conteúdo técnico melhorou significativamente entre 2023 e 2026. Especificamente para documentação, a tradução automática tem vantagens estruturais em relação a um processo humano, e não apenas uma vantagem de preço:

  • Consistência terminológica. Um modelo aplica o mesmo termo ao mesmo conceito em mil páginas; um grupo rotativo de tradutores humanos apresenta variações, e essa inconsistência permanece invisível até que um leitor registre um bug sobre ela.
  • Velocidade. Quinze idiomas em minutos, em vez de um ciclo de orçamento e agendamento para cada idioma.
  • Custo de revisão. A verdadeira despesa da tradução humana não está na primeira versão, mas em todas as posteriores: altere um parágrafo e você pagará novamente por palavra, em todos os idiomas. A tradução automática recalcula a página alterada. É por isso que a documentação traduzida fica desatualizada em um processo humano e permanece atualizada em um processo automático.

O que os humanos ainda fazem melhor:

  • Localização cultural (formatos de data, exemplos, voz da marca)
  • Textos jurídicos de alto risco
  • Slogans de marketing

Para documentação, a relação custo-benefício pende fortemente para a tradução por IA em 2026.

Cada idioma indexado separadamente#

Três sinais são importantes:

  1. Padrão de URL — /ja/ subdiretório ou ja.yourdomain.com subdomínio (subdiretório é mais fácil)
  2. Tags hreflang — bidirecionais, apontam em ambas as direções entre todas as versões
  3. Atributo lang — <html lang="ja"> na versão japonesa
  4. Entradas do sitemap — cada idioma recebe sua própria entrada com anotações xhtml:link

O Google então classifica cada idioma nos resultados de pesquisa do respectivo locale. Um usuário no Japão pesquisando em japonês vê /ja/. Um usuário na Espanha pesquisando em espanhol vê /es/.

O que os mecanismos de busca de IA fazem com as traduções#

Três comportamentos observados:

ChatGPT#

O ChatGPT citará uma página traduzida se a consulta estiver nesse idioma. Perguntar ao ChatGPT "ドキュメンテーションプラットフォームを比較してください" (compare as plataformas de documentação em japonês) retorna fontes em japonês, incluindo versões japonesas da documentação.

Perplexity#

Assim como o ChatGPT — o Perplexity corresponde estritamente o idioma da consulta ao idioma da fonte. Se você traduzir bem, ganha um canal de citação por idioma.

Gemini#

O Google Gemini usa o índice subjacente do Google. Os mesmos sinais de hreflang e localidade que ajudam as Visões gerais de IA do Google ajudam o Gemini.

Como o Docsbook oferece suporte a vários idiomas#

Três etapas para ativar um idioma:

  1. Painel → Configurações → Idiomas → selecionar idioma → ativar
  2. A IA traduz todo o conjunto de documentos para esse idioma; a execução da tradução é contabilizada em dólares no saldo do projeto
  3. A página aparece em /{language-code}/{path} com hreflang e lang definidos corretamente

15 idiomas compatíveis: EN, ES, FR, DE, PT, IT, RU, ZH, JA, KO, AR, HI, TR, PL, NL.

Você também pode enviar suas próprias traduções por meio da ferramenta MCP upload_translation ou da interface de administração, caso tenha um tradutor humano.

Modos de tradução#

Três modos disponíveis:

  • Automático — o Docsbook AI traduz tudo automaticamente
  • Manual — fila de traduções pendentes; você revisa antes de publicar
  • Externo — envie um webhook para seu próprio pipeline de tradução (seu TMS, seus tradutores)

O modo externo é destinado a equipes que já têm uma memória de tradução e querem continuar usando-a. A ferramenta MCP set_translation_mode alterna entre os modos.

Erros que prejudicam o SEO multilíngue#

  • Alternância por parâmetros de consulta (?lang=ja) — o Google não indexa essas páginas como páginas separadas
  • Detecção de idioma baseada em cookies — o mesmo problema: apenas um URL é indexado
  • Ausência de tags hreflang — o Google trata as traduções como conteúdo duplicado
  • hreflang unidirecional — ambas as páginas devem referenciar uma à outra
  • Ausência do atributo lang — leitores de tela e rastreadores usam o inglês como fallback

Economia de custos#

Traduzir 200 páginas para 14 idiomas adicionais:

Tradução humana DIY Tradução com IA da Docsbook
Custo Por palavra, cotado por idioma e pago novamente a cada revisão Medido a cada execução de tradução em relação ao saldo do projeto
Tempo Meses Horas
Custo de atualização Cobrado novamente por palavra sempre que a página de origem é alterada Recalculado quando a origem é alterada
Indexação SEO Configuração manual de hreflang Automática por localidade
Ideal para Conteúdo jurídico, regulamentado e de marketing que precisa ser aprovado por uma pessoa Conteúdo de referência e tutoriais que mudam com frequência

A tradução automática não é estritamente melhor. Ela é melhor naquilo que acaba com a maioria dos projetos de tradução: não a primeira versão, mas a vigésima revisão.

Comece gratuitamente — sem cartão de crédito

Próximos passos#

Updated

Esta página foi útil?

Desenvolvido por Docsbook