Validador de dados estruturados JSON-LD
Cole HTML ou JSON-LD bruto para validar dados estruturados FAQPage, BreadcrumbList e Article. Veja instantaneamente propriedades obrigatórias ausentes e erros comuns dos resultados avançados do Google.
Dicas
- Em FAQPage, acceptedAnswer.text deve ser sempre uma string simples. Colocar um objeto ou array ali faz com que os Resultados Avançados do Google não consigam interpretá-lo.
- Em BreadcrumbList, mantenha position como uma sequência iniciando em 1. Lacunas ou duplicatas impedem que seja reconhecido como uma trilha de navegação válida.
- Mantenha o headline do Article com cerca de 110 caracteres ou menos, uma diretriz aproximada do Google; títulos mais longos podem ser truncados nos resultados de busca.
- Você pode colar uma página HTML inteira: a ferramenta extrai automaticamente o conteúdo de qualquer bloco <script type="application/ld+json">. Colar apenas o JSON bruto também funciona.
- Se uma página tiver vários blocos de dados estruturados, mantê-los cada um em sua própria tag <script> facilita a manutenção e a depuração.
Perguntas frequentes
Curiosidade — Por que o JSON-LD substituiu o Microdata e o RDFa
O JSON-LD (JSON for Linking Data) surgiu como um formato de dados vinculados padronizado por um grupo comunitário do W3C no início dos anos 2010. Diferente das notações mais antigas de dados estruturados, Microdata e RDFa, que incorporam marcação diretamente nos atributos dos elementos HTML, o JSON-LD vive inteiramente dentro de uma tag <script> como um bloco independente de JSON. Isso significa que dados estruturados podem ser adicionados, editados ou removidos sem tocar em nada do layout HTML ao redor. O Google passou a favorecer o JSON-LD como formato recomendado por volta de 2015, e sua documentação atual de resultados avançados é escrita quase inteiramente pensando na sintaxe do JSON-LD.
As próprias seções de perguntas frequentes deste site funcionam da mesma forma: os autores escrevem cada pergunta e resposta uma única vez, e um bloco JSON-LD do tipo FAQPage correspondente é gerado automaticamente nos bastidores. Não é preciso escrever o mesmo conteúdo duas vezes — uma para o acordeão legível por humanos e outra para o esquema legível por máquinas — de modo que os dois nunca ficam dessincronizados, como costuma acontecer com marcação duplicada manualmente.
Mesmo um JSON sintaticamente válido pode falhar nos Resultados Avançados se faltar uma propriedade exigida pelo Schema.org, ou uma propriedade recomendada pelo Google. Campos profundamente aninhados como acceptedAnswer.text são um caso clássico de erro de estrutura. Executar uma verificação como esta antes de publicar detecta esses erros mais cedo do que esperar para notar um erro depois no relatório de Aprimoramentos do Search Console.