O crachá da sua empresa para as máquinas

Ao final você será capaz de

• Classificar qualquer tipo de dado estruturado como camada de aparência ou de compreensão, com data de verificação declarada.
• Escolher tipos e propriedades a partir da função real de cada página, priorizando identificadores registrados antes de listas de perfis sociais.
• Usar @id e relações para conectar Organization, Person, WebSite e conteúdo num único grafo que amarre a pillar e os satélites do seu cluster.
• Diferenciar validade sintática, elegibilidade e exibição efetiva.

Um leitor reconhece título, autor, empresa e data pela aparência e pelo contexto. Uma máquina precisa de marcações explícitas para interpretar com mais segurança qual trecho representa cada elemento.

Schema.org fornece um vocabulário compartilhado. JSON-LD é uma forma comum de escrever esse vocabulário em um bloco separado no código. O dado estruturado descreve a página; ele não deve inventar prêmio, avaliação, autoria, endereço ou relação ausente do conteúdo visível.

Identificadores estáveis permitem que diferentes blocos apontem para a mesma pessoa ou organização. Em vez de recriar o autor em cada artigo, a página referência o identificador canônico da pessoa, que por sua vez se relaciona à organização.

Exemplo resolvido, consultoria com vinte especialistas

Os blocos eram tecnicamente válidos em isolamento, porém não formavam um grafo coerente e repetiam dados divergentes.

Como ler o resultado. Validade sintática é apenas uma camada. Qualidade exige verdade, correspondência visual, conexão por identificadores e manutenção quando a realidade muda.

A dor que traz você até aqui costuma ter este formato. Imagine a cena, hipotética mas familiar. Numa mesma semana, Diego, head de conteúdo de uma fintech de crédito, recebe duas provocações que parecem opostas. Na segunda, um fornecedor liga oferecendo "um schema especial para IA", com preço de projeto e nenhuma fonte primária. Na quinta, o time de dev pede autorização para arrancar todo o FAQPage do site, porque o rich result de FAQ acabou e a marcação virou, segundo eles, código morto. Diego não quer decidir no chute nem contratar consultoria para cada dúvida dessas. Ele precisa de um critério único que sirva para os dois pedidos. As duas coisas se resolvem com a mesma distinção conceitual.

Vale desenhar essa diferença antes de qualquer decisão de remoção, porque ela muda a métrica, o risco e o exemplo típico de cada lado. Repare especialmente na linha de risco: no schema de aparência o risco é a feature sumir, e no schema de compreensão o risco é você publicar um dado errado sobre a sua própria entidade.

A poda não foi um episódio isolado. Em 12/06/2025 o Google descontinuou sete tipos de uma vez (Book Actions, Course Info, Claim Review, Estimated Salary, Learning Vídeo, Special Announcement e Vehicle Listing), com o Special Announcement saindo de fato em 31/07/2025. Em novembro de 2025 o banner de descontinuação de Book Actions foi retirado, confirmando que aquele tipo segue suportado. A lista se move nos dois sentidos.

O caso mais didático é o FAQPage. O Google encerrou o rich result de FAQ a partir de 07/05/2026, com banner datado de 08/05/2026, removeu o relatório do Search Console e o Teste de Resultados Aprimorados em junho de 2026, e os dados na API do Search Console saem em agosto de 2026. O tipo FAQPage continua válido no vocabulário e o Google segue lendo a marcação. Sumiu o acordeão, permaneceu o par pergunta e resposta explicitado para quem consome a página.

Esse capítulo ganhou um exemplo datado enquanto o mercado ainda discutia o assunto. Em 07/05/2026 o Google removeu o resultado aprimorado de FAQ da Busca, mas confirmou que o tipo FAQPage continua válido no schema.org e segue sendo lido para entender a página (Search Engine Journal, 10/05/2026, verificado em 19/07/2026). A retirada foi faseada, e vale registrar o calendário certo para não datar errado o próprio diagnóstico: o resultado aprimorado saiu em 07/05/2026, o relatório do Search Console e o Teste de Resultados Aprimorados saíram em junho de 2026, e os dados na API do Search Console saem em agosto de 2026, ou seja, ainda não tinham saído quando este capítulo foi verificado, em 20/07/2026. É a distinção deste capítulo acontecendo ao vivo: morreu o pixel na SERP e a marcação seguiu sendo lida. Quem arrancou o FAQPage inteiro em maio pagou duas vezes e ainda entregou ao parser uma página com menos estrutura para compreender.

Essa matriz tem prazo de validade e eu preferi imprimir a data dentro dela justamente por isso. Qualquer lista fixa de "tipos que importam" nasce vencida, inclusive esta. O que você leva deste capítulo é o protocolo que regenera a lista em quinze minutos, sempre que precisar.

Resolvida a questão da aparência, sobra a segunda parte da sua dor: o fornecedor que vende um schema especial para busca generativa. Essa venda tem uma resposta curta e uma fonte primária, o que a torna uma das poucas discussões deste mercado com desfecho limpo.

Faltava, até pouco tempo atrás, uma medição do efeito real de adicionar JSON-LD sobre citações em IA. Ela chegou em 11/05/2026, num estudo causal da Ahrefs que rastreou 1.885 páginas que adicionaram JSON-LD entre agosto de 2025 e março de 2026, pareadas contra cerca de 4.000 páginas de controle, com testes t, diferenças em diferenças e estudos de evento. Os três resultados aparecem na figura a seguir: Google AI Mode, ChatGPT e Google AI Overviews.

Com a camada de aparência arrumada e a promessa de IA desmontada, sobra o que realmente rende: identidade de entidade. A documentação de Organization structured data, com atualização registrada em 15/04/2026, declara que o recurso ajuda o Google a desambiguar a sua organização de outras nos resultados, e suporta um conjunto de identificadores registrados: iso6523Code (com prefixos ICD como 0060 para DUNS, 0088 para GLN e 0199 para LEI), duns, leiCode, naics, globalLocationNumber, taxID e vatID. Para empresa brasileira, taxID é onde o CNPJ entra.

Essa prioridade tem uma estrutura de dependência que vale ver desenhada. Cada camada só faz sentido se a de baixo estiver resolvida: presença em base pública sem consistência de nome e endereço vira ruído, e sameAs bem montado sem identificador registrado é uma pilha de links sem âncora.

Agora o recorte deste curso. Schema é um assunto grande e existe capítulo dedicado a ele em outros treinamentos da casa. Para structured data e JSON-LD em profundidade, incluindo a fronteira entre schema legítimo e schema spam, leia o capítulo "Structured Data e JSON-LD: A Camada de Entendimento", em /educacao/geo-knowledge-graph. Para acesso, renderização e implantação técnica da marcação, leia o capítulo "Etapa 2: Estruturação técnica (acesso, renderização e dados estruturados)", em /educacao/seo-geo. Para conectar a sua entidade ao Wikidata, leia o capítulo "Integrando Wikidata ao Seu Site", em /educacao/wikidata-wikipedia. Aqui a fatia é uma só: o markup do cluster, ou seja, usar about, mentions, isPartOf e hasPart para dizer que a sua pillar e os seus satélites formam um conjunto.

O bloco abaixo é o entregável deste capítulo em forma de esqueleto. Repare numa escolha deliberada: todos os placeholders gritam a palavra SUBSTITUA e nenhum deles se parece com um valor plausível. Placeholder plausível (um CNPJ inventado, um Q do Wikidata que existe e é de outra entidade) é a forma mais comum de o aluno publicar markup mentiroso sem perceber.

Cada propriedade acima está ali por um motivo específico, e você deve conseguir defender todas em uma linha

• @id: identificador estável do nó, o que permite referenciar sem redefinir.
• legalName: razão social, que desambigua de homônimos comerciais.
• taxID: CNPJ, âncora verificável num registro público que você não controla.
• sameAs: aponta para propriedades que você controla ou que são autoritativas, nunca para trinta perfis.
• about: declara qual entidade a página descreve, ligando pillar e satélites ao mesmo tema.
• hasPart e isPartOf: declaram a relação de conjunto entre pillar e satélites, nas duas direções.
• publisher: liga o conteúdo à organização responsável, que é onde os identificadores moram.

• Marcar com FAQPage um acordeão que o usuário não vê na página, esperando que o rich result volte.
• Repetir a definição completa de Organization em todas as páginas em vez de referenciar por @id.
• Colocar em sameAs qualquer perfil onde a marca já apareceu, incluindo diretórios que ninguém mantém.
• Usar about apontando para uma string de palavra-chave em vez de um nó com @id.
• Manter GraphicNovel depois da depreciação em favor de SequentialArt na release 29.4 do schema.org, de 08/12/2025.
• Criar item no Wikidata sem notabilidade só para ter o que colocar em sameAs, o que termina em deleção.

Exercício prático

1. 01Escolha um cluster real do seu site: uma pillar e dois satélites publicados.
2. 02Rode o protocolo de verificação de status para todos os tipos de schema que já existem nessas três páginas, e monte a planilha com tipo, status, data da consulta e URL da fonte.
3. 03Escreva um único bloco JSON-LD com @graph contendo Organization com ao menos um identificador registrado real, a entidade do tema, a pillar com about e hasPart, e os dois satélites com isPartOf.
4. 04Justifique cada propriedade incluída em uma linha, e liste o que você descartou e por quê.
5. 05Rode os três testes de esteira do bloco bash deste capítulo e cole o resultado.

Critérios de sucesso

• A planilha de status tem data de consulta e URL de fonte oficial em toda linha, sem exceção.
• O JSON parseia e nenhum @id referenciado ficou órfão.
• A busca por SUBSTITUA no arquivo final retorna zero resultados.
• Toda propriedade cujo valor real você não possui foi apagada, em vez de preenchida com valor plausível.
• O identificador registrado declarado em Organization confere com o registro público correspondente, verificado por você e não pelo validador.

Schema é uma declaração verificável

Dados estruturados oferecem pistas explícitas sobre o que uma página descreve. Em JSON-LD, a organização pode declarar nome, URL, logo, identificadores e perfis oficiais; uma página de perfil pode descrever uma pessoa; um artigo pode apontar para o autor e para a página principal; breadcrumbs podem representar a posição na arquitetura.

O código não deve conter uma versão mais ambiciosa da empresa do que o conteúdo visível. Se o JSON-LD declara fundador, certificação, avaliação ou serviço que a página não apresenta de forma verdadeira, o problema deixou de ser técnico e passou a ser de qualidade ou engano.

Três testes são distintos: sintaxe válida, aderência às diretrizes e resultado exibido. Uma marcação pode ser válida e ainda não ser elegível a uma aparência específica. Mesmo quando é elegível, o Google decide se e quando mostra um rich result. Dados estruturados ajudam compreensão; não compram exposição.

Template mínimo de Organization com @id estável

Guia prático: validar o mesmo bloco Organization em duas ferramentas e entender por que elas respondem coisas diferentes. O Schema Markup Validator, mantido pelo schema.org, confere o vocabulário. O Teste de pesquisa aprimorada, do Google, mostra o que a Busca reconhece para recursos de pesquisa. Uma marcação pode passar limpa na primeira e não aparecer na segunda, e isso não é erro.

As duas capturas acima usam exatamente o mesmo código. O validador do schema.org leu as onze propriedades; o teste do Google não listou item algum. Para o trabalho de entidade, a leitura que importa é a do validador somada à presença do bloco no HTML renderizado. O teste do Google entra quando o tipo gera recurso de pesquisa, como Product, Article ou Event.

Aprofundamento

A partir daqui o capítulo sai do "como fazer" e entra no "por que funciona". Se você só precisa executar, o material acima já basta.

Caso longitudinal, Episódio 7 · descobrir que um código válido descrevia a entidade errada

Quem está na sala: CIO com engenharia, SEO, conteúdo, produto e jurídico

A reunião: Revisão técnica após uma auditoria encontrar o produto marcado como organização e avaliações internas publicadas como se fossem avaliações de clientes.