Configurações de cookies

Os cookies necessários mantêm o site funcionando. A análise mostra quais páginas são úteis. Você pode mudar sua escolha a qualquer momento pelo rodapé.

Política de cookies deste site — detalhes completos: categorias de cookies, como guardamos sua escolha no navegador e como retirar o consentimento.

Necessários

Funções básicas do site e sua escolha de consentimento. Sempre ativos.

Análise

Ajuda a entender como o site é usado. Carregado apenas com sua permissão.

GitHubBaixar ZIP

Validador de dados estruturados e de schema

Valide JSON-LD, Microdata e RDFa contra o vocabulário Schema.org incluído e as regras locais de resultados avançados do Google, e rascunhe JSON-LD novo com o schema-build.

Ver no GitHubInício rápido

O que faz

  • App desktop SpiderHead: a aba Schema da URL, mostrando os blocos JSON-LD detectados e interpretados.
  • SpiderHead no terminal: seohead schema-check

Duas camadas de validação

A primeira camada verifica se a marcação é Schema.org válida: se o tipo existe, se a propriedade é permitida nele, se as propriedades herdadas contam e se o valor corresponde ao tipo esperado. A segunda camada verifica as condições visíveis localmente para os resultados avançados do Google, como as propriedades obrigatórias. Passar na segunda camada não é garantia de que o Google vai exibir um resultado avançado.

  • Vocabulário Schema.org incluído, funciona offline
  • Propriedades herdadas são tratadas, então um autor em um Article não vira erro falso
  • Propriedades obrigatórias e de escolha entre alternativas, para tipos de resultado avançado
  • Erros de análise informados quando um bloco JSON-LD não é JSON válido

A marcação como grafo

As entidades se conectam por referências @id. O verificador mapeia quais entidades têm um @id, quais estão ligadas, quais estão isoladas e se alguma referência aponta para lugar nenhum. Uma entidade isolada é um achado útil, porque os buscadores não conseguem conectá-la ao restante da página.

  • Entidades sem @id ou sem ligação com o restante
  • Referências a um @id que não existe
  • Marcação lida de JSON-LD, Microdata e RDFa

Criação

O schema-build rascunha um @graph conectado para o tipo da página, usando apenas fatos visíveis na página. Ele mostra os sinais que usou e o grau de certeza sobre o tipo. Você define o tipo com --type quando o palpite for fraco, e revisa o rascunho antes de publicá-lo.

  • Fatos extraídos somente da página
  • Palpite de tipo com sinais e nível de confiança
  • --type para substituir o palpite
  • Campos recomendados que faltam são listados

Três passos, um rastreamento salvo

  1. Valide contra o vocabulário Schema.org

    O schema-check lê os dados estruturados da página e testa cada tipo e propriedade contra o vocabulário Schema.org incluído.

  2. Verifique a marcação como grafo

    A ferramenta mapeia quais entidades têm um @id, quais estão ligadas, quais estão isoladas e se alguma referência @id aponta para lugar nenhum.

  3. Crie a marcação que falta

    O schema-build sugere um @graph conectado, usando apenas fatos visíveis na página, e lista os campos recomendados que ainda faltam.

Verificações deste recurso

VerificaçãoO que significaGravidadeEvidência
SCHEMA_VALIDATION_ERROROs dados estruturados da página têm erros de validação contra o vocabulário Schema.orgImportantNúmero de erros de validação por página
STRUCTURED_DATA_PARSE_ERRORHá um bloco JSON-LD, mas ele não é JSON válido, então os buscadores o ignoramImportantBlocos encontrados contra blocos interpretados
STRUCTURED_DATA_MISSINGA página não tem marcação Schema.orgTipPágina sem nenhum bloco de dados estruturados
Também no registro de verificações
STRUCTURED_DATA_SCHEMA_ERRORSTRUCTURED_DATA_SCHEMA_WARNINGSTRUCTURED_DATA_RICH_RESULT_REQUIRED_MISSING

Um comando

bash
seohead schema-check --url https://example.com/product

Instale primeiro: guia de instalação. Todo comando também funciona como ferramenta MCP para agentes de IA.

O que você precisa

  • Uma URL de página ou o próprio HTML (argumento html) para uma verificação offline
  • Um nome de tipo para o schema-build, quando o palpite for fraco
  • Nenhuma chave de API

Limites

  • Uma verificação estática não consegue dizer se o Google vai de fato exibir um resultado avançado
  • A ferramenta vê apenas o HTML que recebe: marcação injetada por JavaScript passa despercebida, a menos que o HTML seja renderizado antes
  • RDFa, HTML e tamanho do grafo têm limites; ao atingir um limite, o resultado é explicitamente parcial
  • O schema-build rascunha a marcação, mas não a publica

Perguntas

O que eu executo?
seohead schema-check --url https://example.com/product. Para verificar a marcação offline, passe o próprio HTML no argumento html, por exemplo com --input e um objeto JSON.
A ferramenta também verifica a elegibilidade para resultados avançados?
Sim, localmente. A primeira camada é o vocabulário Schema.org: se um tipo existe, se uma propriedade é permitida nele e se o tipo do valor corresponde. A segunda camada verifica as propriedades obrigatórias de cada tipo de resultado avançado do Google para o qual tem regras. Ela não consegue saber se o Google vai exibir o resultado.
Quais formatos de marcação ela lê?
JSON-LD, Microdata e RDFa. Um bloco JSON-LD que não pode ser interpretado é informado como erro de análise, porque os buscadores o ignoram.
O schema-build inventa fatos para a minha página?
Não. Ele monta o grafo a partir de fatos visíveis na página e mostra os sinais e o seu nível de confiança. Se o palpite do tipo tiver baixa confiança, defina o tipo você mesmo com --type.
Ela altera o meu site?
Não. Os dois comandos só leem a página. O JSON-LD que ele rascunha é uma sugestão, que você revisa e publica por conta própria.
Ela também roda em um rastreamento?
Sim. Um rastreamento registra os achados de dados estruturados por página: marcação ausente, erros de análise, erros de schema e propriedades obrigatórias de resultados avançados que faltam.

Continue explorando

Do blog e do glossário

Schema.org JSON-LD: dados estruturados para a Pesquisa do GoogleBlogSchema.orgGlossárioJSON-LD: dados estruturados expressos como JSON vinculadoGlossárioDados estruturadosGlossário

Mais neste grupo · Auditoria

Auditoria técnica de SEORecursoVerificador de redirecionamentos: cadeias, loops e 302sRecursoVerificador de links quebrados com origem e posiçãoRecursoVerificador de tag canonicalRecursoVerificador de hreflangRecursoVerificador de title e meta descriptionRecursoVerificador de estrutura de títulosRecursoVerificador de conteúdo duplicado e rasoRecursoVerificador e otimizador de SEO para imagensRecursoAuditoria de linkagem interna e profundidade de rastreamentoRecursoPeso da página e verificações de velocidadeRecursoVerificação de HTTPS e de cabeçalhos de segurançaRecursoVisibilidade na busca por IA (GEO/AEO)Recurso

Teste no seu próprio site

Baixar ZIPTodos os recursos