NeovaPlataforma avançada de SEO

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.

Dados estruturadosvalidador de schema markupAtualizado em 21 de novembro de 2026Pela equipe da Neova

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:

  1. 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.
  2. 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.
  3. 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.
  4. 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 ValidatorTeste de pesquisa aprimorada
Desenvolvido porSchema.orgGoogle
Páginas por teste11
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:

TipoObrigatórias para o Google
Snippet de produtoname, mais offers, review ou aggregateRating
Eventname, startDate, location
Recipename, image
BreadcrumbListitemListElement: name, position, item
Article0 (todas recomendadas)

Algumas marcações são válidas, mas já não rendem o que rendiam:

MarcaçãoMudançaDesde
data-vocabulary.orgSem suporte2021
HowToSem resultado avançadoSetembro de 2023
FAQPageSó sites governamentais e de saúdeAgosto de 2023
FAQPageSem resultado avançadoMaio 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

  1. 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.
  2. Corrija primeiro os erros de sintaxe. Nada mais pode ser verificado em um bloco que não é lido.
  3. 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.
  4. Verifique as propriedades obrigatórias dos recursos que você quer, e depois as recomendadas.
  5. Compare a marcação com o texto visível: nomes, headlines e preços devem aparecer na página.
  6. Faça uma conferência por amostragem no Teste de pesquisa aprimorada, uma página por template, para confirmar o que o Google vê.
  7. 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:

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.

Leve isto com você

Os links dos assistentes abrem com uma pergunta sobre esta página já escrita.

Rastreie seu site com a NeovaO plano Free roda todas as verificações no Mac, Windows e Linux. Sem cartão de crédito.

Continue lendo