Schema JSON-LD e llms.txt: implementação sem promessas

Use JSON-LD para descrever fatos que a sua página já apresenta e valide a marcação antes de publicá-la. Mantenha llms.txt quando houver um consumidor para esse índice opcional. Nenhum dos dois garante citação em IA; a entrega técnica é uma página coerente, acessível e com dados corretos.

Schema.org é um vocabulário para descrever pessoas, artigos, produtos e outras entidades. JSON-LD é um formato de dados ligados, usado para expressar essas relações. A implementação começa pela informação que você consegue comprovar, sem uma quota de tipos ou propriedades para preencher.

Por Alexandre Caramaschi, Chief Strategy Officer da Nuvini (Nasdaq: NVNI), Founder da Brasil GEO, cofundador da NAIA e cofundador da AI Brasil, ex-CMO da Semantix (Nasdaq) · Março 2026

Atualizado em 6 de outubro de 2026.

Qual marcação a página realmente precisa?

Escolha o tipo que descreve o conteúdo principal e consulte o recurso de busca que pretende atender. Um artigo pode usar Article; uma oferta de produto exige dados próprios da oferta. Nem todo tipo de Schema.org corresponde a um resultado enriquecido do Google.

O Google recomenda JSON-LD pela facilidade de manutenção, mas também aceita outros formatos de marcação. Os dados precisam refletir o conteúdo visível. A presença de schema não substitui um texto útil, a indexação da página ou uma identidade verificável.

Comece com uma página representativa. Se o seu sistema de publicação já gera marcação, confira a saída antes de instalar outro complemento. Dois geradores podem publicar autores diferentes, datas conflitantes ou ofertas duplicadas na mesma URL.

Como montar um Article que você consegue conferir?

O exemplo abaixo descreve um artigo fictício e conecta página, autora e organização por identificadores estáveis. Os endereços de example.com não são destinos para sua implementação. Substitua cada valor pelos dados da publicação e retire o que não conseguir sustentar.

No exemplo, a página mostra o título “Como escolher um filtro”, a assinatura de Ana Lima e as duas datas indicadas. A organização se chama Oficina Aurora. O sufixo depois de # distingue a entidade dentro do endereço; ele não precisa criar uma página separada.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://example.com/#organizacao",
      "name": "Oficina Aurora",
      "url": "https://example.com/"
    },
    {
      "@type": "Person",
      "@id": "https://example.com/equipe/ana-lima#pessoa",
      "name": "Ana Lima",
      "url": "https://example.com/equipe/ana-lima"
    },
    {
      "@type": "Article",
      "@id": "https://example.com/guias/filtro#artigo",
      "headline": "Como escolher um filtro",
      "datePublished": "2026-09-01",
      "dateModified": "2026-10-06",
      "inLanguage": "pt-BR",
      "mainEntityOfPage": "https://example.com/guias/filtro",
      "author": {"@id": "https://example.com/equipe/ana-lima#pessoa"},
      "publisher": {"@id": "https://example.com/#organizacao"}
    }
  ]
}
</script>

Esse é um exemplo de relações válidas, não uma lista universal de campos exigidos por cada produto de busca. Acrescente uma imagem representativa se ela existir e confira as recomendações atuais para Article. Não invente imagem, credencial, avaliação, preço ou data para eliminar um aviso.

Preserve datePublished quando revisar o texto. Use dateModified para registrar uma mudança real e apresente a atualização ao leitor. Trocar a data sem atualizar a informação cria uma aparência de novidade que o conteúdo não entrega.

Como validar código, conteúdo e página publicada?

Valide a sintaxe e a correspondência com a página em etapas separadas. O Schema Markup Validator examina o vocabulário e a estrutura. O Rich Results Test verifica recursos reconhecidos pelo Google; ele não é um teste universal de todos os tipos de Schema.org.

1. Abra a página e anote título, autor, publicação e última alteração. Confira a origem de preços ou avaliações, quando houver.
2. Inspecione o código-fonte e identifique os blocos JSON-LD existentes. Escolha o gerador responsável e remova a causa de duplicidades.
3. Adapte um bloco de marcação aos fatos visíveis. Mantenha identificadores estáveis para a mesma pessoa e organização.
4. Cole o código no Schema Markup Validator. Corrija erros de sintaxe e relações indevidas.
5. Use o Rich Results Test para o recurso pretendido. Investigue avisos individualmente; a ausência de um tipo nessa ferramenta não prova JSON-LD inválido.
6. Depois de publicar, teste a URL final. Confirme que a hospedagem entrega o mesmo conteúdo e use a inspeção de URL do Search Console quando tiver acesso.

Na revisão final, compare o JSON-LD recebido com o texto da página, não apenas com a versão no editor. Um modelo de página antigo, um cache ou um complemento podem alterar a saída. Registre a URL testada e o resultado para que a equipe consiga reproduzir a conferência.

Aprovação técnica significa que a implementação atende ao contrato verificado. A exibição de um resultado enriquecido continua sendo decisão do buscador. Uma validação também não demonstra que ChatGPT, Gemini ou outro assistente citou a página.

Como usar sameAs sem misturar entidades?

Use sameAs para apontar à mesma entidade em outro endereço, como o perfil oficial da organização. Um artigo sobre a empresa não é automaticamente sua identidade equivalente. Uma página com nome parecido pode pertencer a outra pessoa ou negócio.

Antes de declarar um identificador do Wikidata, abra o item e confira nome, descrição e referências. Verifique também se ele continua existindo. Não crie uma equivalência entre a pessoa autora e a empresa que publica o artigo; elas têm papéis diferentes.

Uma organização não precisa ter item no Wikidata para publicar dados estruturados úteis. Se não houver correspondência demonstrável, omita esse link. Uma lista curta de endereços corretos é mais fácil de manter do que uma coleção de perfis incluídos apenas para completar campos.

Onde entra o llms.txt nessa implementação?

O llms.txt entra como índice opcional de documentação para um consumidor identificado. Ele pode apontar a páginas com dados estruturados, mas não torna JSON-LD obrigatório nem exige referências recíprocas entre todos os arquivos. O Google declara ignorá-lo para visibilidade na Pesquisa.

Se um assistente da empresa usa esse índice, selecione documentos públicos, descrições curtas e links atuais. Teste o caminho inteiro até a resposta. O guia de perguntas sobre llms.txt explica a estrutura proposta e a publicação em subdiretórios.

Ao priorizar GEO (Generative Engine Optimization), a presença em respostas de IA, trate arquivos e marcação como decisões técnicas com limites. A auditoria técnica e editorial do GEO Score ajuda a organizar correções; sua pontuação não conta citações reais. Para isso, preserve respostas observadas e suas fontes.

Qual é o critério para encerrar a entrega?

Encerre a implementação quando a página publicada conservar conteúdo, identidade e marcação consistentes, com os erros relevantes resolvidos. A equipe deve conseguir mostrar o código entregue, a ferramenta usada e o responsável pela manutenção. Nenhuma promessa de posição entra nesse aceite.

Hoje, escolha um artigo e confira sua autoria e suas datas antes de acrescentar qualquer propriedade. Continue pelo curso de Search Console para ligar a validação da URL ao acompanhamento do site.

Aplicar o Search Console à revisão do site