Docsbook
Visão geral

GEO — Otimização para Mecanismos Generativos

O GEO do Docsbook é o conjunto de sinais no nível da página que ajudam um mecanismo generativo — Perplexity, busca do ChatGPT, Google AI Overviews, Claude — a citar sua documentação e atribuir a citação a você. Ative o GEO na aba administrativa SEO / GEO ou chame update_geo via MCP, e todas as páginas do workspace passarão a incluí-los na próxima renderização. Isso não é limitado pelo plano — todos os planos têm acesso.

O GEO trata de ser citado dentro de uma resposta gerada. Seus dois vizinhos abrangem superfícies diferentes: SEO trata de obter uma boa posição em uma lista de links azuis, e AEO trata de caixas de respostas e assistentes de voz, que são construídos a partir de marcações explícitas FAQPage e HowTo.

O que um mecanismo generativo realmente faz com a sua página?#

Não apenas uma coisa — um pipeline, e cada etapa pode eliminar você. Um crawler busca a página. Um mecanismo de recuperação classifica trechos, não documentos inteiros: o Google descreve seu sistema de classificação de trechos como aquele que identifica "seções individuais ou 'trechos' de uma página da web para entender melhor o grau de relevância de uma página para uma pesquisa" (Google Search Central, guia dos sistemas de classificação). Em seguida, algumas fontes que sobreviveram são colocadas em uma janela de contexto — a configuração do artigo sobre GEO usa "apenas as 5 principais fontes obtidas do mecanismo de pesquisa do Google para cada consulta" (GEO, KDD 2024) — e um modelo escreve uma resposta com base nelas, escolhendo o que citar e a quem dar crédito.

Duas consequências decorrem disso, e tudo o que vem abaixo depende delas. Qualquer coisa que impeça que você seja buscado ou recuperado torna a redação irrelevante. Qualquer coisa que torne um trecho recuperado mais fácil de extrair e atribuir é algo que o GEO pode realmente mudar.

O que o Docsbook adiciona a uma página quando o GEO está ativado?#

Três coisas, todas visíveis no HTML da página, além dos wrappers semânticos ao redor delas.

Um bloco TL;DR após o H1#

O Docsbook insere um breve resumo imediatamente após o H1 inicial, renderizado como <aside class="tldr" role="note" aria-label="Summary">. O texto é escolhido nesta ordem:

  1. Um campo tldr: explícito no frontmatter da página.
  2. Caso contrário, o primeiro parágrafo real do documento. Títulos, citações em bloco, itens de lista, blocos de código delimitados e linhas compostas apenas por imagens são ignorados durante a busca.

O texto escolhido é limpo antes de ser exibido: a sintaxe de links, o código inline, as marcas de ênfase e as tags HTML brutas são removidos, e os espaços em branco são reduzidos. O resultado é limitado a 280 caracteres, truncado no último limite entre palavras se esse limite estiver além da metade do texto, com a pontuação final removida e uma única elipse adicionada.

Vale conhecer dois comportamentos, pois são eles que impedem que o bloco se torne ruído:

  • Um primeiro parágrafo com menos de 40 caracteres não produz nenhum TL;DR. Um fragmento é pior do que nada.
  • Quando o TL;DR vem do lead, o lead é removido do corpo. A mesma frase nunca aparece duas vezes seguidas; quando o TL;DR vem do frontmatter, o parágrafo de abertura permanece exatamente onde você o escreveu.

Uma data de última modificação visível#

Com o GEO ativado, uma linha com o texto Atualizado em 25 de maio de 2026 é renderizada no final do artigo, com a data envolvida em um elemento <time dateTime="…"> real, para que um analisador obtenha tanto o valor de máquina quanto o valor legível. A data é a data do committer do commit mais recente que modificou esse arquivo no seu repositório, com fallback para a data do autor. O Docsbook armazena em cache essa consulta por uma hora e, se o GitHub não responder, a linha é omitida em vez de ser presumida — uma data incorreta é pior do que nenhuma data.

O mesmo histórico de commits preenche datePublished no JSON-LD, usando o mais antigo dos 100 commits mais recentes que modificaram o arquivo.

Um autor Person no JSON-LD#

Cada página contém um objeto TechArticle. Sem o GEO, seu author é uma referência ao Organization do seu workspace. Com o GEO ativado, ele se torna uma pessoa:

{
  "@type": "Person",
  "name": "Jane Doe",
  "url": "https://github.com/janedoe",
  "sameAs": ["https://github.com/janedoe"]
}

O nome vem do frontmatter author: quando você o define; caso contrário, vem do autor do último commit desse arquivo. url e sameAs são preenchidos a partir do frontmatter authorUrl: ou do perfil do autor no GitHub e simplesmente ficam ausentes quando nenhum dos dois existe. Se não houver um nome de nenhuma das duas fontes, o objeto usa como fallback a referência Organization, em vez de emitir um Person vazio.

Contêineres semânticos#

O corpo é renderizado dentro de <article>, e o bloco TL;DR contém role="note" e um rótulo acessível — lido tanto por tecnologias assistivas quanto por analisadores. Com o AEO também ativado, .tldr é o primeiro seletor na especificação speakable da página, portanto o bloco que um modelo lê primeiro é o bloco que um assistente de voz lê em voz alta.

Como verifico se o GEO está fazendo alguma coisa?#

Use a ferramenta MCP audit_geo. Ela não executa nenhum modelo — todos os números nela são obtidos por consulta — portanto não pode inventar uma descoberta. Em uma chamada, ela:

  • lê seu robots.txt e o verifica em relação a sete agentes assistentes nomeados (uma lista datada, atualmente válida em 2026-08-29), separando agentes de indexação de pesquisa de rastreadores de treinamento, porque bloquear o treinamento é uma decisão e bloquear o agente de indexação de pesquisa enquanto se espera obter citações geralmente é um acidente;
  • busca cada página amostrada duas vezes no mesmo minuto — uma vez como um navegador e outra como OAI-SearchBot — para detectar uma CDN que fornece uma página a uma pessoa e um desafio a um assistente;
  • verifica se o texto principal está presente no HTML bruto (pelo menos 200 palavras, sem execução de JavaScript);
  • verifica se a página informa uma data;
  • verifica se /llms.txt, /llms-full.txt e /sitemap.xml existem.

Uma sondagem que expira ou encontra um erro 404 é registrada como nulo com um motivo, nunca como uma falha — uma verificação inacessível reduz o número de verificações, não sua pontuação.

Por que estes sinais e não outros#

Regra Por que o sistema se comporta dessa forma Fonte
Faça com que cada seção seja independente A recuperação atribui pontuações a trechos, não a páginas Guia dos sistemas de classificação do Google
Adicione citações, estatísticas e fontes citadas Medido para aumentar a parcela de uma resposta gerada atribuída a uma fonte. Adição de citações, Citar fontes e Adição de estatísticas são os três principais métodos do artigo, relatados como "uma melhoria relativa de 30–40% na métrica de Contagem de palavras ajustada à posição" em um benchmark de 10 mil consultas, sendo o melhor deles de 41% GEO, KDD 2024
Diga quem escreveu O Google pergunta se as páginas "contêm uma assinatura, quando seria esperado" e "recomenda veementemente adicionar informações precisas sobre a autoria" Criação de conteúdo útil
Use Person com um url que identifique o autor Orientação do Google para artigos: "Use o tipo Person para pessoas" e crie um link para "uma página da Web que identifique exclusivamente o autor" Dados estruturados de artigos
Não espere um arquivo mágico "Não há requisitos adicionais para aparecer nas Visões gerais criadas por IA ou no Modo IA, nem outras otimizações especiais necessárias" Recursos de IA do Google
Não faça excesso de palavras-chave O mesmo benchmark classifica o excesso de palavras-chave entre os métodos "Sem desempenho", com uma pontuação abaixo da linha de base não modificada — e, em um mecanismo ativo, "10% pior que a linha de base" GEO, KDD 2024

Limites e questões em aberto#

O quanto isso influencia é pequeno e condicional. Uma análise crítica de 45 estudos de GEO realizada em 2026 conclui que os ganhos fundamentais são "válidos dentro de seu contexto experimental, mas condicionais à presença prévia de uma fonte em um contexto fixo", e que "nenhuma técnica analisada demonstra um efeito causal estável, longitudinal e multiplataforma sobre a descobribilidade orgânica ou o comportamento posterior" (arXiv 2607.14035, janela de nov. de 2023 a jul. de 2026). O Docsbook não informará um aumento na taxa de citações, porque nenhum foi estabelecido.

Ainda em questão: a atualidade aumenta a taxa de citações? O que é verificável é que o Google executa "vários sistemas de 'a consulta merece atualidade'" para o ranqueamento da Pesquisa (guia dos sistemas de ranqueamento), e que uma página sem data não fornece a um modelo nada a que atribuir atualidade. O que não é verificável é a afirmação comum de que uma data visível aumenta a frequência com que um assistente cita você: nenhuma fonte primária mede isso. Trate a data como higiene, não como uma alavanca, até que alguém publique uma medição.

As respostas não são estáveis o suficiente para testes A/B manuais. Auditorias independentes resumidas na mesma análise: Schulte et al. (2026), em quatro mecanismos e 45 dias, "observam pontuações diárias de Jaccard no nível da fonte de aproximadamente 0,34–0,42"; Kirsten et al. (2026), em 4.706 consultas nos EUA e na Alemanha, descobrem que "a sobreposição de páginas ao longo de dois meses é de 18% para as Visões gerais de IA, em comparação com 45% para o Google orgânico". Execute uma verificação mais de uma vez antes de acreditar em um ganho ou em uma perda.

Detalhes dependentes da versão. A data visível é renderizada em inglês dos EUA (May 25, 2026), independentemente do idioma da página. datePublished é derivado de no máximo os 100 commits mais recentes que alteraram o arquivo; portanto, em uma página muito antiga, ele corresponde ao commit mais antigo dessa janela, não ao primeiro de fato. O autor obtido do git é quem alterou o arquivo por último, que pode ser alguém que corrigiu um erro de digitação — defina author: explicitamente quando o byline for importante.

A opção GEO não chega a um domínio personalizado. Os três sinais nesta página são emitidos pelo caminho de renderização hospedado pelo Docsbook. Uma página servida em seu próprio domínio não recebe nenhum bloco de TL;DR nem uma linha Updated visível, e recebe um único nó TechArticle cujo autor é sempre um Person nomeado de acordo com o login do proprietário do repositório no GitHub — esteja o GEO ativado ou desativado, independentemente do frontmatter author:. Ativar o GEO não muda nada que um leitor ou rastreador veja atualmente em um domínio personalizado. Consulte Limites de SEO para saber o que mais difere nesse caso.

O que o GEO não pode fazer. Ele não indexa uma página não indexada, não desbloqueia um rastreador que seu robots.txt bloqueia e não torna legível uma página renderizada no lado do cliente. Esses são problemas de SEO, e audit_geo os relata como críticos exatamente por esse motivo.

Ativando#

  1. Abra o painel de administração do seu workspace (FloatWidget) → aba SEO / GEO.
  2. Ative o GEO. Sem restrição de plano nem configuração por página (preços).
  3. Adicione uma linha tldr: às cinco páginas que você mais deseja que sejam citadas. Essas duas edições são toda a primeira etapa.
  • Sinais de citação — as regras de escrita, cada uma com o comportamento de recuperação que a justifica.
  • llms.txt — o índice de máquina no nível do site e o valor real de suas evidências.
  • SEO — indexação, URLs canônicas, sitemap: a etapa anterior para que tudo isso importe.
  • AEOFAQPage, HowTo e marcação speakable.
  • Chat de IA — o assistente que responde no seu próprio site.
  • Como o Docsbook comprova o que afirma — a regra segundo a qual estas páginas são escritas.

Esta página foi útil?