Validador de schema markup: verifique os dados estruturados de uma página ou de um site inteiro
Os dados estruturados dizem aos buscadores do que trata uma página de um jeito que eles conseguem ler sem adivinhar: isto é um produto, este é o preço, este é o autor. Um validador de schema markup lê essa marcação e diz se ela é lida sem erros, se usa o vocabulário corretamente e se está completa o bastante para um recurso da busca. Uma página é fácil de testar. Um site com milhares de páginas geradas por templates precisa do mesmo teste em todo lugar.
O que um validador de schema markup verifica
A validação acontece em quatro níveis, e cada um pega um tipo diferente de problema:
- Sintaxe. O JSON-LD é lido sem erros? Cada propriedade de microdata está dentro de um item? Uma vírgula faltando ou uma aspa sem escape pode deixar um bloco inteiro ilegível.
- Vocabulário. Os tipos e as propriedades são termos reais do Schema.org, usados nos tipos a que pertencem? Uma propriedade com erro de grafia é JSON válido, mas não significa nada.
- Requisitos dos recursos. O Google documenta propriedades obrigatórias e recomendadas para cada resultado avançado que suporta. A marcação pode ser Schema.org válido e ainda assim não ter uma propriedade de que o Google precisa para um snippet de produto ou uma listagem de evento.
- Correspondência com a página. As diretrizes de dados estruturados do Google pedem que a marcação descreva conteúdo que os visitantes conseguem ver. Um preço na marcação que não está na página, ou um headline diferente do visível, é um problema de qualidade que nenhuma verificação de sintaxe vai encontrar.
A maioria das ferramentas de página única cobre os três primeiros. O quarto precisa da marcação e da página renderizada lado a lado.
O validador do Schema.org e o Teste de pesquisa aprimorada do Google
Duas ferramentas gratuitas testam uma página de cada vez, e elas respondem a perguntas diferentes. A introdução aos dados estruturados do Google recomenda o Teste de pesquisa aprimorada enquanto você desenvolve.
| Schema Markup Validator | Teste de pesquisa aprimorada | |
|---|---|---|
| Desenvolvido por | Schema.org | |
| Páginas por teste | 1 | 1 |
| URL ou código colado | ✓ | ✓ |
| JSON-LD, microdata, RDFa | ✓ | ✓ |
| Todo o vocabulário do Schema.org | ✓ | – |
| Elegibilidade para resultados avançados do Google | – | ✓ |
| Propriedades obrigatórias ausentes | – | ✓ |
| Prévia do resultado | – | ✓ |
O Schema Markup Validator substituiu a antiga Ferramenta de teste de dados estruturados do Google. Use-o para saber se a marcação é Schema.org correto, inclusive tipos que alimentam painéis de conhecimento ou respostas de IA mas não têm resultado avançado. Use o Teste de pesquisa aprimorada quando o objetivo for um recurso específico do Google. Nenhum dos dois testa um site inteiro de uma vez. O SEO ProCheck mostra como depurar resultados avançados com falha com os dois.
JSON-LD, microdata e RDFa
O Google lê os três formatos e diz que todos servem igualmente quando válidos, mas recomenda o JSON-LD porque ele fica em um bloco script, separado do HTML, e é o mais fácil de manter correto em todos os templates. Um bloco Product mínimo fica assim:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"image": "https://www.example.com/shoe.jpg",
"offers": {
"@type": "Offer",
"price": "89.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
</script>
Microdata e RDFa colocam os mesmos fatos em atributos do HTML visível. Isso mantém a marcação perto do conteúdo, mas uma mudança de template no HTML pode quebrá-la sem ninguém perceber. Seja qual for o formato, use um por item; descrever o mesmo produto duas vezes em dois formatos é pedir para os dois discordarem.
Erros comuns em dados estruturados
- JSON quebrado. Uma vírgula sobrando no final, uma aspa curva colada de um documento ou uma quebra de linha crua dentro de uma string.
- @context ou @type ausente. Sem eles, um parser não sabe o que o bloco descreve.
- Propriedades obrigatórias ausentes. Veja a tabela abaixo.
- Marcação que discorda da página. Um preço que mudou na página, mas não na marcação.
- Valores desatualizados. Uma oferta cujo priceValidUntil já passou, ou um dateModified anterior ao datePublished.
Propriedades obrigatórias de alguns recursos comuns, da galeria de recursos da busca do Google:
| Tipo | Obrigatórias para o Google |
|---|---|
| Snippet de produto | name, mais offers, review ou aggregateRating |
| Event | name, startDate, location |
| Recipe | name, image |
| BreadcrumbList | itemListElement: name, position, item |
| Article | 0 (todas recomendadas) |
Algumas marcações são válidas, mas já não rendem o que rendiam:
| Marcação | Mudança | Desde |
|---|---|---|
| data-vocabulary.org | Sem suporte | 2021 |
| HowTo | Sem resultado avançado | Setembro de 2023 |
| FAQPage | Só sites governamentais e de saúde | Agosto de 2023 |
| FAQPage | Sem resultado avançado | Maio de 2026 |
Por que uma página não basta
Os dados estruturados quase sempre são gerados por templates. Quando quebram, quebram em todas as páginas que o template serve, ou no subconjunto em que um campo está vazio. Testar a página de produto que você por acaso abriu não vai mostrar que 300 produtos não têm preço porque o campo de preço deles é uma faixa, ou que os artigos de um autor não têm marcação de autor.
Três coisas só aparecem em um site inteiro:
- Cobertura. Quais grupos de páginas têm marcação, e quais páginas dentro de um grupo não têm o que as irmãs têm.
- Casos-limite. Campos vazios, caracteres estranhos e valores que só alguns registros têm.
- Desvio. Marcação que era válida no lançamento e deixou de ser depois de um release. A documentação do Google recomenda acompanhar os relatórios de resultados avançados depois de cada deploy exatamente por isso.
Como validar o schema markup em um site inteiro
- Rastreie o site e extraia os dados estruturados de cada página HTML. Se parte da marcação é injetada por JavaScript, renderize as páginas também, como descrito no guia de crawler de SEO para JavaScript.
- Corrija primeiro os erros de sintaxe. Nada mais pode ser verificado em um bloco que não é lido.
- Agrupe as páginas por template e liste os tipos que cada grupo tem. Procure páginas sem um tipo que a maior parte do grupo tem.
- Verifique as propriedades obrigatórias dos recursos que você quer, e depois as recomendadas.
- Compare a marcação com o texto visível: nomes, headlines e preços devem aparecer na página.
- Faça uma conferência por amostragem no Teste de pesquisa aprimorada, uma página por template, para confirmar o que o Google vê.
- Acompanhe o Search Console depois de cada release: os relatórios de resultados avançados e a Inspeção de URL mostram o que o Google encontrou no próprio rastreamento.
Os dados estruturados são um passo do checklist de auditoria de SEO técnico, e uma marcação limpa também ajuda os sistemas de IA a ler uma página, como explica o guia de crawler de SEO com IA.
Valide os dados estruturados com a Neova
A categoria Dados estruturados da Neova marca o schema markup de cada página como válido, com avisos ou com erros, acrescenta uma coluna Tipos de Schema e dá um veredito para cada tipo no painel da URL. Ela lê JSON-LD, microdata e RDFa de cada página HTML do crawl. Algumas das verificações:
- Dados estruturados com erros de sintaxe, para JSON-LD que não é lido ou não tem @context ou @type
- Dados estruturados sem propriedades obrigatórias ou diferentes do texto visível, para os recursos que o Google documenta
- Dados estruturados sem as propriedades recomendadas, que também sinaliza marcação data-vocabulary.org
- Preço de Product nos dados estruturados não aparece na página HTML e Data priceValidUntil da oferta já passou
- Datas em conflito nos dados estruturados, no lastmod do sitemap ou no Last-Modified
- Tipo de dados estruturados comum no grupo de páginas está ausente e Página HTML sem a marcação de resultado avançado que o grupo de páginas dela tem
- Marcação Organization ou Person sem propriedades de identificação
- Página HTML sem dados estruturados, que também lê o HTML renderizado quando o crawl o renderizou
- O resultado rico é inválido, a partir da Inspeção de URL no Google Search Console
Como a Neova encontra os grupos de páginas pelo HTML, um problema de template aparece como um grupo com a mesma sinalização, e não como milhares de linhas separadas. Dúvidas sobre tipos e formatos são respondidas no FAQ de schema markup do SEO ProCheck. Veja os Recursos ou baixe a Neova; o plano Free rastreia 1.000 URLs com todas as verificações.
Perguntas
O que é um validador de schema markup?
Uma ferramenta que lê os dados estruturados de uma página, em JSON-LD, microdata ou RDFa, e verifica se eles são lidos sem erros, se usam corretamente os tipos e as propriedades do Schema.org e, em algumas ferramentas, se têm o que um recurso da busca exige.
Qual é a diferença entre o Schema Markup Validator e o Teste de pesquisa aprimorada?
O Schema Markup Validator, em validator.schema.org, verifica a marcação contra todo o vocabulário do Schema.org. O Teste de pesquisa aprimorada do Google verifica para quais resultados avançados do Google uma página é elegível e quais propriedades obrigatórias ou recomendadas estão faltando.
Dados estruturados válidos garantem um resultado avançado?
Não. O Google diz que uma marcação válida torna a página elegível, não garantida. Ele decide se mostra um resultado avançado conforme a busca, a página e as suas diretrizes de qualidade.
Dá para validar o schema markup de um site inteiro?
Não com as ferramentas de página única. Um crawler que extrai e verifica os dados estruturados de todas as páginas mostra problemas de template, marcação ausente e páginas diferentes do seu grupo, e depois você confere por amostragem uma página por template no Teste de pesquisa aprimorada.
Qual formato de dados estruturados devo usar?
O Google lê JSON-LD, microdata e RDFa e recomenda o JSON-LD, já que ele fica em um bloco separado do HTML e é o mais fácil de manter.