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.
O que é o Validador de dados estruturados JSON-LD
O JSON-LD é um formato de marcação que informa ao Google, de forma legível por máquinas, o que um trecho de conteúdo da página realmente é — uma FAQ, um artigo, uma trilha de navegação, e assim por diante. Ele é escrito como JSON dentro de uma tag <script type="application/ld+json">, de modo que adiciona dados estruturados sem tocar em nada do HTML visível. Quando implementado corretamente, pode habilitar Resultados Avançados na busca, como trechos de FAQ expansíveis ou trilhas de navegação, que tendem a melhorar a taxa de cliques mesmo sem nenhuma mudança no ranking.
Esta ferramenta extrai automaticamente os blocos <script> do HTML colado (ou aceita JSON-LD bruto diretamente) e verifica cada entidade FAQPage, BreadcrumbList e do tipo Article (Article / NewsArticle / BlogPosting) em relação às propriedades obrigatórias definidas pelo Schema.org. Também sinaliza os erros clássicos que quebram silenciosamente os Resultados Avançados do Google — como acceptedAnswer.text ser um objeto em vez de uma string simples, ou valores de position que não são sequenciais. Executar essa verificação antes de publicar, ou logo após uma correção, detecta problemas mais cedo do que esperar para notá-los depois no Search Console.
Como usar o Validador de dados estruturados JSON-LD
- Obtenha o código HTML ou o JSON-LD da sua página Tanto o HTML completo obtido em "Ver código-fonte da página" quanto apenas o conteúdo de uma tag <script> funcionam como entrada.
- Cole no campo de entrada, ou busque a partir de uma URL Você pode colar o texto diretamente ou, para uma página já publicada, informar a URL e buscá-la automaticamente.
- Revise as entidades detectadas e seus resultados Se a entrada contiver vários blocos <script> ou várias entidades @type, cada uma é listada e validada separadamente.
- Corrija qualquer propriedade marcada como "Ausente" ou "Aviso" Cada propriedade aparece como OK, Aviso ou Ausente, então você pode ir direto ao ponto correspondente no seu JSON-LD original e corrigi-lo.
- Valide novamente após corrigir, antes de publicar Cole de volta o JSON-LD corrigido e confirme que todas as propriedades mostram OK antes de aplicar a mudança em produção.
Dicas para aproveitar melhor
- 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.
Quando esta ferramenta é útil
Verificar a marcação FAQPage antes de publicá-la
Detecte erros clássicos, como um acceptedAnswer.text mal estruturado, que impedem silenciosamente o trecho avançado de FAQ de aparecer, antes de publicar.
Auditar as trilhas de navegação após uma reestruturação do site
Quando categorias mudam ou URLs são alteradas, confirme de uma só vez que os valores de position do BreadcrumbList continuam na ordem correta.
Revisar o esquema Article de um post de blog
Verifique rapidamente se o headline está muito longo ou se faltam author, datePublished ou image, as propriedades recomendadas para páginas do tipo artigo.
Investigar um erro apontado pelo Teste de Resultados Avançados
Quando a ferramenta oficial do Google reporta um erro, primeiro identifique aqui exatamente qual propriedade está com problema e depois corrija a origem.
Glossário
- JSON-LD
- Uma especificação para escrever dados estruturados em formato JSON. É incorporado como um bloco independente dentro de uma tag <script type="application/ld+json">, permitindo adicionar informações voltadas a mecanismos de busca sem alterar o layout HTML existente.
- Schema.org
- Um vocabulário compartilhado para dados estruturados, mantido em conjunto por Google, Microsoft, Yahoo e outros. Define tipos (@type), como FAQPage ou Article, e as propriedades que cada um suporta.
- FAQPage
- Um tipo do Schema.org para informar ao Google uma lista de perguntas e respostas. Seu mainEntity contém um array de entidades Question, cada uma exigindo um name (o texto da pergunta) e acceptedAnswer.text (o texto da resposta).
- BreadcrumbList
- Um tipo do Schema.org que representa uma trilha de navegação — a posição da página dentro da hierarquia de um site. Seu itemListElement contém um array de entidades ListItem, cada uma exigindo position, name e item.
- Resultados Avançados
- Resultados de busca aprimorados que exibem mais do que um título e descrição simples — como um trecho de FAQ expansível ou uma trilha de navegação — e que exigem dados estruturados corretamente implementados para aparecer.
- Propriedade obrigatória
- Uma propriedade que o Google exige para exibir determinado Resultado Avançado; se estiver ausente, o Resultado Avançado simplesmente não aparecerá. Uma propriedade recomendada, por outro lado, não é estritamente obrigatória, mas melhora a forma como o resultado é exibido.
- Google Search Console
- A ferramenta oficial do Google para monitorar o desempenho de busca e o status de indexação de um site. Seus relatórios de Aprimoramentos mostram como o Google está realmente interpretando os dados estruturados das suas páginas publicadas.
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.