Schema Validator
Teste os dados estruturados de qualquer página. Veja os erros e o que a sua marcação Schema diz à IA sobre a sua marca.
| Tipo | Item | Resultado |
|---|
O que são dados estruturados?
Dados estruturados são um código que declara os fatos de uma página de um jeito que uma máquina lê sem adivinhar. Uma pessoa vê um nome, um preço e cinco estrelas. A marcação diz: isto é um produto, este é o nome dele, este é o preço, esta é a avaliação.
O vocabulário vem do schema.org, e por isso o mesmo código também é chamado de marcação Schema, ou schema markup. JSON-LD é o formato que a maioria dos sites usa para escrevê-lo: um bloco de código na página, separado do HTML visível.
Os mecanismos de busca usam esse código para entender a página e mostrar resultados mais completos. Os sistemas de IA leem o mesmo bloco quando buscam a página. Isso faz dele um dos poucos lugares onde você pode dizer com todas as letras quem você é e o que oferece, em palavras que não deixam espaço para interpretação.
O que este validador de dados estruturados verifica
Se o código é lido sem erro. Uma vírgula fora do lugar torna ilegível um bloco JSON-LD inteiro, e o rastreador ignora tudo o que está nele. O validador aponta o bloco e a linha em que ele quebra.
Se cada item diz o que é. Um item precisa de um @type, e o bloco precisa de um @context que aponte para o schema.org. Os tipos diferenciam maiúsculas de minúsculas, e o validador pega os que foram escritos do jeito errado.
Se cada tipo tem o que precisa. Um Product sem oferta, um FAQ sem respostas, um vídeo sem data de envio. Propriedades obrigatórias ausentes são erros. As recomendadas que faltam aparecem à parte, para você separar o que está quebrado do que pode melhorar.
Se os valores fazem sentido. Propriedades vazias, links que não são URLs completas, datas que não são datas, preços com o símbolo da moeda dentro do número.
O que a marcação diz sobre a sua marca. O validador separa o item Organization e o mostra como uma máquina o lê: nome, descrição, site, logo e os perfis listados em sameAs. Esta é a parte do teste de marcação Schema que a maioria das ferramentas deixa de fora.
O código que você cola é verificado no seu navegador e nunca sai da página.
Como testar dados estruturados
- Digite o endereço da página. Use a página em si, não só a página inicial. Cada página tem a sua própria marcação.
- Leia as linhas do topo. Elas dizem se há dados estruturados, se eles têm erros e se dizem a uma máquina quem está por trás do site.
- Olhe a tabela da marca. Ela mostra os dados da sua Organization do jeito que uma máquina os recebe. Tudo o que aparece como ausente é uma lacuna.
- Percorra os itens. Cada item de Schema da página aparece com o seu tipo e o seu resultado.
- Corrija o que está em Validação. Primeiro vêm os erros, depois os avisos, depois as propriedades recomendadas.
- Teste a correção antes de publicar. Cole o novo JSON-LD no validador e confira se os erros sumiram.
O que os dados estruturados dizem à IA sobre a sua marca
Quando um assistente responde a uma pergunta sobre uma empresa, ele trabalha com o que conseguiu ler. O texto corrido deixa lacunas. Esta é a empresa ou um revendedor? Aquele é o site oficial? Estes dois perfis são da mesma marca? A marcação Schema responde a essas perguntas em um só lugar.
Organization é o item que mais importa
Um item Organization na página inicial declara o seu nome, a sua URL e o seu logo. Acrescente uma description e a máquina passa a ter o seu próprio resumo de uma linha sobre o que você faz, com as suas palavras.
sameAs liga os pontos
sameAs lista os seus outros perfis: redes sociais, diretórios, sites de avaliações. Ele diz a uma máquina que todos eles são uma só entidade. Uma marca com os perfis amarrados entre si é mais fácil de reconhecer do que uma espalhada pela web com nomes um pouco diferentes.
Um nome só em todo lugar
Se a Organization tem um nome e o WebSite tem outro, a máquina precisa decidir qual está certo. O validador aponta a divergência. Escolha um nome e liste o outro em alternateName.
O ChatGPT usa dados estruturados?
O que se sabe é o seguinte. O Google e a Microsoft dizem que os dados estruturados ajudam os sistemas deles a entender uma página. A OpenAI, a Anthropic e a Perplexity não disseram quanto peso os modelos delas dão a isso. Os rastreadores delas buscam o HTML, e o JSON-LD faz parte dele.
Então a marcação Schema não é um interruptor que faz os assistentes citarem você. Ela tira a dúvida sobre quem você é, e vale a pena porque o custo é um bloco de código.
A marcação adicionada por um script pode nunca ser vista
A maioria dos rastreadores de IA não executa JavaScript. Se um gerenciador de tags adiciona o seu Schema depois que a página carrega, a marcação não está no que eles buscam. Este validador lê o mesmo HTML. Se ele não encontra nada em uma página que você sabe que tem Schema, o motivo é esse. O Agent Readiness Checker mostra quanto da página existe antes de qualquer script rodar.
Tipos de Schema que este validador verifica
Estes são os tipos que têm regras por trás. Os outros tipos do schema.org são lidos e listados, sem veredito sobre as propriedades deles.
| Tipo | O que descreve | Obrigatório | Recomendado |
|---|---|---|---|
Organization | Quem está por trás do site | name, url | logo, sameAs, description |
LocalBusiness | Um negócio com endereço físico | name, address | url, telephone, image, horário de funcionamento, sameAs |
WebSite | Como o site se chama | name, url | Nenhuma |
Person | Um autor ou um fundador | name | url, sameAs, jobTitle |
Article | Um post ou uma notícia | headline | author, datePublished, dateModified, image, publisher |
Product | Algo que você vende | name, e uma entre offers, review e aggregateRating | image, description, brand, sku |
Offer | O preço de um produto | priceCurrency, e price ou priceSpecification | availability |
SoftwareApplication | Um aplicativo ou uma ferramenta online | name, e uma entre offers, aggregateRating e review | applicationCategory, operatingSystem, description |
FAQPage | Perguntas com as suas respostas | mainEntity, com um name e um acceptedAnswer para cada pergunta | Nenhuma |
BreadcrumbList | Onde a página fica dentro do site | itemListElement, com uma position para cada item | Nenhuma |
VideoObject | Um vídeo na página | name, description, thumbnailUrl, uploadDate, e contentUrl ou embedUrl | duration |
Event | Algo que acontece em uma data | name, startDate, location | endDate, image, description, offers, organizer |
Recipe | Uma receita | name, image | recipeIngredient, recipeInstructions, author, totalTime |
HowTo | Instruções passo a passo | name, step | image, totalTime |
JobPosting | Uma vaga aberta | title, description, datePosted, hiringOrganization, jobLocation | validThrough, employmentType, baseSalary |
Review and AggregateRating | Avaliações | ratingValue, mais um autor para uma avaliação ou uma contagem para uma nota agregada | datePublished |
Os subtipos seguem o tipo pai. Um Restaurant ou um Dentist é verificado como LocalBusiness, um BlogPosting ou um NewsArticle como Article, um WebApplication como SoftwareApplication.
Erros comuns em dados estruturados
Uma vírgula depois da última propriedade. O JSON não permite. O bloco inteiro deixa de ser legível.
Maiúsculas e minúsculas trocadas em um tipo. organization não é Organization. Os tipos e os nomes das propriedades diferenciam maiúsculas de minúsculas.
Sem @context. Sem ele, os nomes dos tipos são só palavras.
Um Product sem oferta. Um produto precisa de um preço, uma avaliação ou uma nota para ser útil a quem o lê.
Um preço com o símbolo da moeda. "price": "$19" é texto. Escreva "price": "19.00" e coloque USD em priceCurrency.
Links relativos. /logo.png não significa nada fora do seu site. Use o endereço completo.
Datas em formato local. Escreva o ano primeiro, como em 2025-03-14, e não 14/03/2025.
Marcação de coisas que a página não mostra. Notas e avaliações no código que nenhum visitante consegue ver violam as regras do Google.
Dois plugins escrevendo o mesmo item. A página fica com dois itens Organization que se contradizem. Fique com um.
Schema Validator vs Rich Results Test
As ferramentas respondem a perguntas diferentes, e vale a pena usar mais de uma.
| Ferramenta | A pergunta que responde | O que deixa de fora |
|---|---|---|
| O Rich Results Test do Google | Esta página pode ganhar um resultado avançado (rich result) na Busca do Google? | Os tipos que o Google não usa em resultados avançados |
| O validador do Schema.org (Schema.org validator) | A marcação segue o vocabulário do schema.org? | Se falta algo obrigatório para a busca |
| Este Schema Validator | A marcação está correta, e o que ela diz a uma máquina sobre a marca? | As regras de elegibilidade do Google para cada resultado avançado |
Se o seu objetivo é um resultado avançado no Google, termine com o teste do próprio Google. Se o seu objetivo é ser entendido tanto pelos mecanismos de busca quanto pelos sistemas de IA, comece por aqui.
JSON-LD, microdados e RDFa
Os dados estruturados podem ser escritos em três formatos. Todos carregam o mesmo vocabulário.
JSON-LD é um bloco de código em uma tag script. Ele fica separado da página visível, o que o torna o mais fácil de escrever e de manter. O Google o recomenda, e a maioria dos sites o usa.
Microdados colocam atributos como itemscope e itemprop nos próprios elementos HTML. Funciona, e quebra com facilidade quando um template muda.
RDFa faz o mesmo com outro conjunto de atributos e é o menos comum dos três.
Este validador verifica o JSON-LD a fundo. No caso dos microdados, ele lista os tipos que encontra na página, para você saber que eles estão lá.
Perguntas frequentes
O que é um schema validator?
Um schema validator, ou validador de Schema, lê os dados estruturados de uma página e diz se eles estão escritos corretamente. Ele verifica se o código é lido sem erro, se cada item informa o seu tipo e se as propriedades que cada tipo exige estão presentes. Verificador de Schema e ferramenta de teste de dados estruturados são outros nomes para a mesma coisa.
Como testar os dados estruturados do meu site?
Digite o endereço da página no validador acima. Ele lê a página como um rastreador, lista cada item de Schema que encontra e marca o que está faltando ou errado. Para testar o código antes de publicar, cole o JSON-LD.
Por que o validador não encontra dados estruturados na minha página?
Geralmente porque um script adiciona a marcação depois que a página carrega. Um gerenciador de tags ou um aplicativo renderizado no navegador faz isso. O validador lê o HTML que o servidor envia, que é também o que a maioria dos rastreadores de IA recebe. Coloque o JSON-LD no código-fonte da página e ele será encontrado.
A marcação Schema ajuda com o ChatGPT e outros assistentes de IA?
Ela ajuda uma máquina a ler a sua página sem adivinhar. O Google e a Microsoft dizem que os dados estruturados ajudam os sistemas deles a entender o conteúdo. A OpenAI, a Anthropic e a Perplexity não disseram quanto peso os modelos delas dão a isso. Trate a marcação como um jeito de declarar com clareza os fatos sobre a sua marca, não como um interruptor que faz os assistentes citarem você.
Quais tipos de Schema importam mais para uma marca?
Organization vem primeiro, na página inicial, com o seu nome, URL, logo e os links em sameAs. WebSite dá nome ao site. Depois depende da página: Product para o que você vende, Article para o que você publica, FAQPage para perguntas e respostas, LocalBusiness se os clientes vão até você.
Qual é a diferença entre este validador e o Rich Results Test do Google?
O teste do Google responde a uma pergunta: esta página pode ganhar um resultado avançado na Busca do Google. Ele só olha os tipos que o Google aceita para isso. Este validador verifica a marcação em si e mostra o que ela diz a qualquer máquina sobre a sua marca, inclusive os tipos que o Google não usa em resultados avançados.
JSON-LD é melhor que microdados?
Para a maioria dos sites, sim. O JSON-LD fica em um bloco separado do HTML visível, então é mais fácil de escrever, de ler e de manter correto. O Google o recomenda. Os microdados ainda funcionam, e este validador lista os tipos de microdados que encontra sem verificá-los a fundo.
A marcação Schema pode prejudicar o meu site?
Uma marcação errada costuma ser ignorada. O risco é a marcação que descreve coisas que a página não mostra, como avaliações ou preços que não estão lá. O Google trata isso como spam e pode deixar de mostrar resultados avançados para o site.
O que o sameAs faz?
sameAs lista os outros lugares onde a sua marca tem um perfil, como as páginas dela em redes sociais, diretórios de empresas e enciclopédias. Ele diz a uma máquina que todos eles são a mesma entidade. Para uma marca que quer ser reconhecida pela IA, esta é a propriedade mais útil depois do nome.
Com que frequência devo validar os meus dados estruturados?
Depois de cada mudança em um template, um plugin ou um tema, e depois de um redesign. A marcação quebra em silêncio: a página continua igual e uma vírgula faltando elimina o bloco inteiro.
Dados estruturados limpos dizem a uma máquina quem você é. Se os assistentes mencionam a sua marca quando alguém pergunta é outra questão, e a verificação do AI Visibility responde a ela.