# Verificador de dados estruturados Digite o endereço de uma página para ler o JSON-LD dela como um navegador o vê depois que os scripts rodam. O verificador lista todos os tipos de schema.org, encontra blocos que os mecanismos de busca não conseguem interpretar e compara cada item com as propriedades obrigatórias e recomendadas da documentação do Google. ## O que esta ferramenta verifica - Erros de sintaxe JSON: Cada bloco JSON-LD é interpretado como um mecanismo de busca o interpretaria. Um bloco com uma vírgula ou aspas sobrando é informado com a mensagem do parser, porque os mecanismos de busca ignoram o bloco inteiro. - O contexto schema.org: Blocos sem "@context": "https://schema.org" são sinalizados, já que os mecanismos de busca não conseguem saber qual vocabulário eles usam. - Todos os itens, inclusive @graph: Itens no nível superior e dentro de @graph, além do mainEntity e do breadcrumb de uma página, cada um com seu tipo e seu nome ou título. - As propriedades obrigatórias do Google: Itens Product, Article, Breadcrumb, Organization, empresa local, Event, Video, Recipe, app de software, vaga de emprego e nome do site (WebSite) são comparados com o que o Google marca como obrigatório. - Propriedades recomendadas: O que o Google recomenda para cada resultado avançado, como image e availability para produtos, ou datePublished e author para artigos. - Resultados avançados descontinuados: Itens FAQPage e HowTo são listados com uma observação: o Google não mostra mais esses resultados avançados, então a marcação não vai gerar nenhum. - Marcação adicionada por JavaScript: A página roda no Chrome antes de lermos, então o JSON-LD inserido por scripts ou por um gerenciador de tags é incluído. ## O que ela não consegue verificar - Garantir um resultado avançado. O Google decide se vai mostrá-lo; uma marcação válida só torna a página qualificada. - Verificar todas as regras dos guias do Google. Algumas dependem dos valores, como tamanho de imagem e formatos de preço e data; o Teste de pesquisa aprimorada do Google é a referência. - Verificar as propriedades de microdados ou RDFa. Eles são listados apenas por tipo. - Confirmar que a marcação corresponde ao que a página mostra. O Google exige isso, e só uma pessoa pode comparar as duas coisas. - Testar mais do que a página que você digitar. ## Por que isso importa Os dados estruturados descrevem uma página para máquinas de forma padronizada: isto é um produto com este preço, isto é um artigo deste autor, esta é a organização por trás do site. O Google os usa para entender as páginas e para mostrar resultados avançados, como preços, avaliações e breadcrumbs. Os erros deles são silenciosos. Um bloco JSON-LD quebrado parece normal na página, e uma propriedade obrigatória ausente faz, sem alarde, um item deixar de ser qualificado para o resultado avançado. O Search Console informa parte disso, mas só para páginas que o Google já rastreou. Não é um atalho para as respostas de IA. O Google diz que os AI Overviews e o Modo IA não precisam de nenhuma marcação schema.org especial. O que conta é a marcação ser válida e corresponder ao que a página mostra. ## Como interpretar os resultados - JSON válido ou não pode ser lido: Se o bloco pode ser interpretado. Um bloco que não pode ser lido é ignorado por completo, não importa o que contenha. - Faltam propriedades obrigatórias: O item não pode ganhar o resultado avançado até que elas sejam adicionadas, e o Search Console vai listá-lo como inválido. - Propriedades recomendadas a adicionar: O item é qualificado; essas propriedades podem deixar o resultado mais rico. Só adicione valores verdadeiros e que apareçam na página. - Completo: As propriedades obrigatórias e recomendadas estão presentes. Os valores ainda precisam estar corretos. - Sem verificações de resultado avançado: Um tipo válido, como WebPage ou ImageObject, para o qual o Google não tem nenhum resultado avançado com propriedades obrigatórias. - O Google não mostra mais este resultado avançado: FAQ (desde 7 de maio de 2026) e How-to (desde setembro de 2023). Manter a marcação não causa nenhum problema. - a / b: Qualquer uma das propriedades atende ao requisito, por exemplo offers / review / aggregateRating para um produto. ## Como corrigir os problemas mais comuns - Uma vírgula sobrando ou aspas sem escape: São os erros de sintaxe mais comuns. Cole o bloco em um validador de JSON para encontrar a posição, e escape as aspas duplas dentro de valores de texto com uma barra invertida. - Product sem offers, review ou avaliação: O snippet de produto do Google precisa de um name mais offers, review ou aggregateRating. As plataformas de loja virtual costumam gerar offers com preço e disponibilidade; se a sua não gera, verifique o tema ou o seu app de SEO. - Uma avaliação sem contagem: aggregateRating precisa de ratingValue mais ratingCount ou reviewCount. Só marque avaliações que os visitantes podem ver na página: as diretrizes do Google não permitem marcação para conteúdo que não está visível. - Dois plugins, dois conjuntos de marcação: Temas, plugins de SEO e apps podem adicionar, cada um, seus próprios dados Product ou Organization. Duplicatas com valores diferentes não ajudam ninguém: mantenha uma única fonte e desative as outras. - Itens de breadcrumb sem endereço: Cada ListItem precisa de uma URL em item (exceto o último, que pode ser a página atual) e de um name, e a lista precisa de pelo menos dois itens. - Nome do site e organização na página inicial: Adicione WebSite com name e url na página inicial para informar ao Google o nome do seu site, e Organization com url, logo e links sameAs para os seus perfis oficiais. ## Perguntas frequentes ### O que é JSON-LD? Uma forma de escrever dados estruturados como um objeto JSON dentro de um elemento script, separado do HTML visível. O Google recomenda esse formato quando a sua configuração permite, porque é o mais fácil de adicionar e manter. ### Por que não vejo resultados avançados depois de adicionar a marcação? O Google precisa rastrear a página de novo e, mesmo assim, decide a cada pesquisa se vai mostrar um resultado avançado. O Google não garante nenhum, nem para uma marcação que passa nos testes dele. ### Dados estruturados melhoram o ranking? A documentação do Google descreve os dados estruturados como uma forma de entender o conteúdo e de habilitar resultados avançados, não como um fator de ranking. Os resultados avançados podem deixar um resultado mais visível. ### Ainda vale a pena adicionar marcação de FAQ? Não para os resultados avançados do Google: o Google parou de mostrá-los em 7 de maio de 2026. A marcação continua sendo schema.org válido, então não é preciso removê-la, mas não a adicione esperando um resultado avançado. ### Preciso de marcação schema para aparecer nos AI Overviews ou no ChatGPT? O Google diz que os AI Overviews e o Modo IA não precisam de nenhuma marcação schema.org especial. Outros serviços de IA não publicam requisitos. Conteúdo claro com marcação válida e precisa é o caminho seguro. ### Qual é a diferença em relação ao Teste de pesquisa aprimorada do Google? O Teste de pesquisa aprimorada é a referência do Google e também verifica valores. Este verificador lista todos os itens da página em linguagem simples, mostra o que falta em cada um e leva ao guia correspondente. ## Fontes - [Google Search Central: introdução à marcação de dados estruturados](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data) - [Google Search Central: diretrizes gerais de dados estruturados](https://developers.google.com/search/docs/appearance/structured-data/sd-policies) - [Google Search Central: galeria de dados estruturados da Pesquisa](https://developers.google.com/search/docs/appearance/structured-data/search-gallery) - [Google Search Central: recursos de IA e o seu site](https://developers.google.com/search/docs/appearance/ai-features) - [Google Search Central: atualizações mais recentes da documentação](https://developers.google.com/search/updates) - [Google: Teste de pesquisa aprimorada](https://search.google.com/test/rich-results) - [Schema.org: Schema Markup Validator](https://validator.schema.org/)