Pular para o conteúdo principal
PERGUNTA DE REFERÊNCIA · DADOS ESTRUTURADOS

Schema.org para IA: escolha, exemplo e validação

Schema.org oferece um vocabulário para descrever páginas, pessoas, organizações e outros elementos. JSON-LD é uma forma de publicar essas relações. Em GEO (Generative Engine Optimization), use a marcação para representar fatos verificáveis e atender a consumidores conhecidos. Código válido não comprova autoridade, seleção por um assistente ou aumento de citações.

Por Alexandre Caramaschi · Atualizado em .

Qual informação a marcação deve representar?

Comece pelo conteúdo que o visitante encontra. Um artigo tem título, autoria e assunto; uma oferta tem produto e condições; uma organização tem uma identidade própria. Escolha os tipos que descrevem essa realidade e confira quais recursos o consumidor pretendido reconhece.

As políticas de dados estruturados do Google exigem correspondência com a página e informação atualizada. Acrescentar uma avaliação, prêmio ou preço apenas no JSON-LD cria uma divergência. A marcação pode ajudar a qualificar conteúdo para recursos documentados, sem garantir que eles sejam exibidos.

Para recursos generativos da Pesquisa Google, não existe um schema especial obrigatório. O guia prático de JSON-LD ajuda a organizar a implementação sem transformar quantidade de propriedades em medida de qualidade.

Como ligar artigo, autora e organização?

O exemplo a seguir descreve uma publicação fictícia da Oficina Aurora, assinada por Ana Lima. Cada entidade tem um identificador próprio. Os endereços de example.com são demonstrativos e precisam ser substituídos por URLs reais e verificadas em uma implementação.

{
  "@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#pessoa",
      "name": "Ana Lima"
    },
    {
      "@type": "Article",
      "@id": "https://example.com/guias/instalacao#artigo",
      "headline": "Como preparar a instalação do equipamento A",
      "mainEntityOfPage": "https://example.com/guias/instalacao",
      "author": {"@id": "https://example.com/equipe/ana#pessoa"},
      "publisher": {"@id": "https://example.com/#organizacao"}
    }
  ]
}

Esse exemplo mínimo ensina as relações. Requisitos de um recurso específico, como a apresentação de artigos num buscador, devem ser conferidos na documentação correspondente. Só acrescente datas e imagens verdadeiras; preserve a data de publicação original ao atualizar o texto.

Na prática, um CMS ou plugin pode emitir outro bloco com dados diferentes. Inspecione a página final e resolva conflitos na fonte que os gera. Repetir uma entidade por referência ao mesmo @id é diferente de declarar duas organizações com identidades conflitantes.

Quando usar sameAs?

A propriedade sameAs aponta para uma página que identifica inequivocamente o mesmo sujeito. Confira quem o perfil representa: pessoa e empresa têm identidades distintas. Um artigo de imprensa sobre a organização não é automaticamente um perfil equivalente à organização.

Abra cada destino e confira nome, contexto e vínculo antes de declará-lo. Não crie identificadores acadêmicos ou itens em bases públicas só para completar uma lista. O roteiro de auditoria de entidade mostra como investigar homônimos e relações incorretas.

Como validar o que foi publicado?

  1. Liste o tipo escolhido e os fatos visíveis que sustentam suas propriedades.
  2. Leia todos os blocos JSON-LD da página, incluindo os inseridos pelo CMS e por plugins.
  3. Use o validador do Schema.org para investigar sintaxe, tipos e relações.
  4. Quando houver um recurso do Google pertinente, use o Rich Results Test e consulte os requisitos desse recurso.
  5. Confira manualmente os valores: autoria, nomes, URLs, datas, condições e imagens. Validador não confirma a verdade do negócio.
  6. Publique a mudança autorizada e repita a conferência na URL servida, preservando a versão e as pendências.

Um teste de resultados enriquecidos pode não reconhecer um tipo que existe no vocabulário Schema.org. Isso não torna o JSON inválido. A pergunta relevante é se a marcação está correta e se atende a um uso documentado.

FAQPage e QAPage servem para qualquer pergunta?

Para a experiência QAPage do Google, os usuários precisam poder enviar respostas à pergunta. Um guia editorial com título interrogativo não atende a essa condição. Nesta página, WebPage e Article descrevem o conteúdo e sua autoria. A análise sobre FAQPage em 2026 explica a escolha e a manutenção de perguntas úteis.

Critério de aceite: os identificadores representam os sujeitos corretos, a marcação acompanha o conteúdo e a URL final foi conferida. A equipe sabe qual sistema mantém cada bloco. A presença em respostas de IA, caso seja o objetivo, exige uma observação separada com perguntas e fontes registradas.

Use o curso Autoridade Temática e SEO de Entidades, de Alexandre Caramaschi, para relacionar a estrutura técnica às informações que o público precisa encontrar.

Fontes e aprofundamento

Dados desta página para agentes de IA
# Schema.org para IA: escolha, exemplo e validação

- Endereço: https://brasilgeo.ai/conteudos/perguntas/schema-org-para-ia/
- Objetivo: Use Schema.org para descrever fatos e relações do conteúdo. Veja um exemplo JSON-LD e um roteiro de validação sem prometer citação por IA.
- Tipo: pergunta
- Atualizada em: 2026-11-18
- Publicada em: 2026-05-20
- Autoria: Alexandre Caramaschi
- Idioma: pt-BR
- Indexável: sim

## Seções
1. Qual informação a marcação deve representar?
2. Como ligar artigo, autora e organização?
3. Quando usar sameAs?
4. Como validar o que foi publicado?
5. FAQPage e QAPage servem para qualquer pergunta?
6. Fontes e aprofundamento

## Links principais
- [Home](https://brasilgeo.ai/)
- [Conteúdos](https://brasilgeo.ai/conteudos/)
- [Perguntas](https://brasilgeo.ai/conteudos/perguntas/)
- [roteiro de auditoria de entidade](https://brasilgeo.ai/conteudos/artigos/auditoria-entidade-digital-guia-geo-2026)
- [Alexandre Caramaschi](https://alexandrecaramaschi.com/) (externo)
- [políticas de dados estruturados do Google](https://developers.google.com/search/docs/appearance/structured-data/sd-policies) (externo)
- [sameAs](https://schema.org/sameAs) (externo)
- [validador do Schema.org](https://validator.schema.org/) (externo)
- [Rich Results Test](https://search.google.com/test/rich-results) (externo)
- [Autoridade Temática e SEO de Entidades, de Alexandre Caramaschi](https://alexandrecaramaschi.com/educacao/autoridade-tematica) (externo)
- [Schema.org: Article](https://schema.org/Article) (externo)
- [Google: requisitos de QAPage](https://developers.google.com/search/docs/appearance/structured-data/qapage) (externo)
- [Google: fundamentos de recursos generativos](https://developers.google.com/search/docs/fundamentals/ai-optimization-guide) (externo)

## Para agentes
- JSON com os mesmos dados no elemento script#pagina-para-agentes (esquema pagina-brasilgeo-para-agentes/v1).
- JSON-LD da página no <head>: WebPage, Article, BreadcrumbList.
- Índice do site para agentes: https://brasilgeo.ai/llms.txt