---
title: "Como validar seus dados estruturados | Grupo Marfre"
description: "Como validar dados estruturados: Teste de pesquisa aprimorada do Google, validador do schema.org e parse em linha de comando para conferir o JSON-LD."
canonical: https://grupomarfre.com.br/sites-agenticos/validar-dados-estruturados/
alternate_html: https://grupomarfre.com.br/sites-agenticos/validar-dados-estruturados/
language: pt-BR
last_updated: 2026-10-27
type: guia
---
# Como validar seus dados estruturados

**Resposta rápida:** Valide em três camadas: o Teste de pesquisa aprimorada do Google, o validador do schema.org e um parse em linha de comando sobre o HTML cru. Depois confira, à mão, se cada dado do JSON-LD aparece no texto visível da página. Ferramenta aprovando não prova que o conteúdo é verdadeiro.

Validar dados estruturados é checar três coisas: se o JSON-LD é lido sem erro de sintaxe, se os tipos e as propriedades existem no vocabulário, e se o que está no bloco é o mesmo que o visitante vê na página. As duas primeiras podem ser feitas por ferramenta. A terceira exige uma conferência sua.

Use a lista abaixo a cada publicação ou mudança em telefone, endereço, horário ou perguntas frequentes. Se você ainda não tem o bloco no ar, comece por [JSON-LD: o que é e como a IA usa os dados estruturados](https://grupomarfre.com.br/sites-agenticos/json-ld/).

## Qual ferramenta usar para cada pergunta?

Use o Teste de pesquisa aprimorada (Rich Results Test) do Google para ver como o Google lê a página, e o Schema Markup Validator (validator.schema.org) para conferir o bloco contra o vocabulário do schema.org, sem relação com recurso do Google. Uma não substitui a outra.

| Pergunta | Ferramenta |
| --- | --- |
| O Google consegue ler o bloco na URL publicada? | Teste de pesquisa aprimorada |
| O bloco está sintaticamente certo e os tipos existem? | Validador do schema.org |
| O bloco está no HTML que chega sem JavaScript? | Parse em linha de comando |
| Os dados do bloco batem com o texto visível? | Conferência manual (próxima seção) |

Cole a URL de produção, não só o código, pelo menos uma vez: assim você testa o que o robô realmente recebe. Colar o código serve para depurar antes de publicar.

Um ponto sobre o FAQPage: o resultado enriquecido de FAQ foi extinto em 07/05/2026, segundo o Google. O bloco não pune, só deixou de render resultado enriquecido. Então não trate a ausência desse recurso no teste como defeito do seu bloco. Detalhes em [FAQPage depois do fim do resultado enriquecido](https://grupomarfre.com.br/sites-agenticos/schema-faqpage/).

## Como conferir se o JSON-LD bate com o texto visível?

Abra a página e o bloco lado a lado e confirme, campo por campo, que cada dado do JSON-LD aparece escrito na página. Dado que existe só no bloco é o erro mais grave desta checklist, e nenhum dos validadores desta lista o acusa, porque eles conferem o bloco, não o texto da página.

Passo a passo:

1.  Copie do JSON-LD o `name`, o `telephone`, o endereço e o horário de funcionamento.
2.  Procure cada um no texto visível da mesma página (Ctrl+F no navegador).
3.  Confira o número inteiro, dígito a dígito: "(31) 3000-0000" no bloco e "(31) 99999-0000" no rodapé (números fictícios) são dois telefones diferentes, e o do bloco precisa aparecer escrito na página.
4.  Para cada pergunta do `FAQPage`, localize a pergunta e a resposta escritas na página. Na régua do Grupo Marfre, FAQPage só entra com a pergunta visível.
5.  Se houver `aggregateRating` ou `review`, confira se a nota vem de avaliações reais, coletadas no próprio site e visíveis. A diretriz do Google de review snippet diz: "Não agregue avaliações de outros sites". Mais em [Avaliações no schema](https://grupomarfre.com.br/sites-agenticos/avaliacoes-no-schema/).

## Como fazer o parse em linha de comando?

Baixe o HTML cru com `curl`, extraia cada `<script type="application/ld+json">` e passe cada um por um parser de JSON. Isso prova que o bloco existe sem executar JavaScript e acusa vírgula sobrando ou aspa errada na hora.

```bash
curl -s https://www.exemplo.com.br/ \
 | python3 -c '
import sys, re, json
html = sys.stdin.read()
blocos = re.findall(r"application/ld\+json[^>]*>(.*?)</script>", html, re.S)
print(len(blocos), "bloco(s) encontrado(s)")
for i, b in enumerate(blocos, 1):
    try:
        d = json.loads(b)
        if isinstance(d, dict) and "@graph" in d:
            tipos = [x.get("@type") for x in d["@graph"]]
        elif isinstance(d, dict):
            tipos = d.get("@type")
        else:
            tipos = "lista"
        print(i, "ok", tipos)
    except json.JSONDecodeError as e:
        print(i, "ERRO", e)
'
```

Zero bloco encontrado, com o bloco aparecendo no navegador, indica que ele é injetado por JavaScript. Para outros testes com `curl`, veja [Como testar a camada agêntica com curl](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/).

Para checar um telefone do bloco contra o texto, conte as ocorrências do final do número, que aparece igual no bloco ("+55-31-3000-0000") e no texto ("(31) 3000-0000"): rode `curl -s https://www.exemplo.com.br/ | grep -o "3000-0000" | wc -l` (endereço fictício). O `grep -o` conta cada ocorrência, mesmo com o HTML numa linha só. Se o resultado for 1, o número provavelmente está só dentro do JSON-LD.

## Quais erros conferir?

Os erros desta lista são de cópia e de coerência, não de código complexo. Todos se detectam com as etapas acima.

- **Vírgula sobrando** depois do último campo, ou aspas tipográficas coladas de um editor de texto: o parse em linha de comando acusa.
- **Tipo escrito errado ou inexistente**: `localBusiness` com "l" minúsculo, ou tipos como `Psychologist` e `LanguageSchool`, que não existem no schema.org. Para psicólogo, use `MedicalBusiness` ou `ProfessionalService`; para escola de idiomas, `EducationalOrganization`.
- **Dado só no bloco**: telefone, horário ou pergunta que o visitante não vê.
- **Avaliação de terceiros** dentro de `aggregateRating`, ou nota no bloco sem avaliação visível na página.
- **Blocos soltos** (na régua do Grupo Marfre, que liga os blocos por @id): Organization, WebSite e FAQPage sem ligação entre si. Veja [@id: como ligar os blocos](https://grupomarfre.com.br/sites-agenticos/id-e-ligacao-de-entidades/).
- **Texto de modelo esquecido**: plugin ou tema que deixou nome, endereço ou URL de exemplo no bloco.

Exemplo fictício de bloco com dado só no bloco (o telefone não existe na página):

```json
{
  "@context": "https://schema.org",
  "@type": "ProfessionalService",
  "name": "Estúdio Exemplo Ltda.",
  "telephone": "+55-31-3000-0000"
}
```

Se a página do exemplo mostra só "(31) 99999-0000", o bloco precisa ser corrigido ou o número precisa aparecer no texto.

## Como o Grupo Marfre trabalha isso

Nos sites que o Grupo Marfre publica, o JSON-LD leva Organization (name, description, url, contactPoint, address, sameAs), WebSite e FAQPage com pergunta visível, ligados por @id, com o tipo de negócio mais específico possível. Depois do deploy, o site passa pela prova em produção com curl e por um scan novo no is-agentic. O Grupo Marfre não promete citação por IA: controla o site e as fontes, e a escolha é do modelo.

## Perguntas frequentes

### Passar nos validadores garante que a IA vai citar minha empresa?

Não. Os validadores mostram se o bloco está legível e coerente, não se algum assistente vai usá-lo. O Grupo Marfre trata dado estruturado como condição de base, sem promessa de citação.

### Aviso no validador é a mesma coisa que erro?

Não necessariamente. Erro deve ser corrigido antes de publicar. Aviso pode apontar um campo opcional ausente: preencha só se o dado existe e está visível na página.

### Preciso validar todas as páginas do site?

Valide um exemplar de cada modelo de página (home, serviço, artigo, contato) e refaça quando o modelo mudar. Depois, rode o parse em linha de comando para varrer as demais URLs.

### Vale manter o FAQPage depois de maio de 2026?

Vale, se as perguntas e respostas estiverem visíveis na página. O resultado enriquecido de FAQ foi extinto em 07/05/2026, mas o bloco não pune.

## Leia também

### [JSON-LD: o que é e o que se sabe sobre o uso pela IA](https://grupomarfre.com.br/sites-agenticos/json-ld/)

JSON-LD é um bloco de dados no HTML, no vocabulário schema.org. Veja o que é, um exemplo mínimo e o que o Google diz sobre dados estruturados e IA.

### [FAQPage depois do fim do resultado enriquecido (maio de 2026)](https://grupomarfre.com.br/sites-agenticos/schema-faqpage/)

FAQPage depois de 07/05/2026: o resultado enriquecido acabou, o bloco não pune. Veja o que manter, as regras de pergunta visível e um JSON-LD de exemplo.

### [Avaliações no schema: quando pode e quando é violação](https://grupomarfre.com.br/sites-agenticos/avaliacoes-no-schema/)

aggregateRating no schema só vale com avaliação real, coletada e visível no próprio site. Veja quando pode, quando é violação e como testar a sua página.

### [@id: como ligar os blocos de dados estruturados entre si](https://grupomarfre.com.br/sites-agenticos/id-e-ligacao-de-entidades/)

@id no JSON-LD: como usar um identificador fixo e o @graph para ligar Organization, WebSite e Article e referenciar a mesma empresa em todas as páginas.

### [Como testar a camada agêntica com curl (receitas prontas)](https://grupomarfre.com.br/sites-agenticos/testar-camada-agentica-com-curl/)

Receitas de curl para testar a camada agêntica: Accept text/markdown, ?mode=agent, GPTBot, Googlebot, Vary, Link, 404 e robots.txt, com a saída esperada.

### [sameAs: como ligar o site aos perfis oficiais da empresa](https://grupomarfre.com.br/sites-agenticos/sameas-e-entidade/)

sameAs liga o site aos perfis oficiais da empresa no JSON-LD e declara que todos são a mesma entidade. Veja quais perfis listar, o que evitar e um exemplo.

---

## Sobre o Grupo Marfre

Grupo Marfre Automação e Tecnologia LTDA (CNPJ 49.685.676/0001-55): agência de marketing digital e inteligência artificial com base em Contagem/MG, que atende o Brasil inteiro de forma remota.

- Endereço: Alameda das Cotovias, 75, Cabral, Contagem - MG, Brasil
- WhatsApp: (31) 93618-7272, https://wa.me/5531936187272
- E-mail: contato@grupomarfre.com.br
- Instagram: https://instagram.com/marfregrupo
- Serviços: gestão de tráfego pago (Meta Ads e Google Ads), site agêntico (site pronto pra assistentes de IA lerem), site que vira contato, SEO e Google, IA no WhatsApp, CRM e automação
- Serviço de site agêntico: https://grupomarfre.com.br/servicos/site-agentico/ · serviço de gestão de tráfego: https://grupomarfre.com.br/servicos/gestao-de-trafego/
- Guias: https://grupomarfre.com.br/sites-agenticos/ e https://grupomarfre.com.br/gestao-de-trafego/
- Método em 4 etapas: Diagnóstico, Estratégia, Execução, Otimização
- Segmentos já atendidos: clínica, consultório, advocacia, loja, igreja
- Preço e escopo não são publicados: são definidos por diagnóstico, caso a caso
- Todas as páginas em Markdown: https://grupomarfre.com.br/llms.txt · conteúdo completo: https://grupomarfre.com.br/llms-full.txt

Página HTML equivalente: https://grupomarfre.com.br/sites-agenticos/validar-dados-estruturados/