---
title: "JSON-LD: o que é e o que se sabe sobre o uso pela IA | Grupo Marfre"
description: "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."
canonical: https://grupomarfre.com.br/sites-agenticos/json-ld/
alternate_html: https://grupomarfre.com.br/sites-agenticos/json-ld/
language: pt-BR
last_updated: 2026-10-27
type: guia
---
# JSON-LD: o que é e o que se sabe sobre o uso pela IA

**Resposta rápida:** JSON-LD é um bloco de dados dentro do HTML, escrito no vocabulário schema.org, que descreve a empresa e a página para máquinas. Fica separado do texto visível, o que facilita a manutenção. O Google diz que não exige schema especial para recursos de IA. O bloco deve dizer o mesmo que o texto visível.

JSON-LD é um trecho de código colocado dentro do HTML da página que diz, em formato padronizado, o que a página é: nome da empresa, endereço, telefone, perfis oficiais, perguntas e respostas. O visitante não vê o bloco. Buscadores e ferramentas de validação leem.

Um ponto de atenção: não existe um "JSON-LD para IA". O Google afirma que não exige arquivo, markup ou schema especial para a Visão Geral por IA e para o Modo IA. O bloco serve para descrever o negócio com precisão, e deve dizer a mesma coisa que o texto visível da página.

## O que é JSON-LD?

JSON-LD é uma forma de escrever dados estruturados: um objeto de pares "propriedade: valor", dentro de uma tag `<script type="application/ld+json">`. Os nomes das propriedades vêm do [schema.org](https://grupomarfre.com.br/sites-agenticos/schema-org/), o vocabulário compartilhado que define tipos como `Organization`, `LocalBusiness` e `Service`.

Na prática, o bloco transforma o que está espalhado no layout (o rodapé com o endereço, o botão de WhatsApp, os links das redes) em uma ficha organizada, que a máquina não precisa adivinhar.

## Como é um bloco mínimo?

Um bloco mínimo declara o tipo, o nome, o endereço do site e o contato. O exemplo abaixo usa uma empresa fictícia (Clínica Exemplo, `example.com.br`); todos os valores são inventados para ilustrar.

```html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://www.example.com.br/#organizacao",
  "name": "Clínica Exemplo",
  "description": "Clínica de fisioterapia em Belo Horizonte, com atendimento por hora marcada.",
  "url": "https://www.example.com.br/",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+55-31-0000-0000",
    "contactType": "customer service"
  },
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Rua Exemplo, 100",
    "addressLocality": "Belo Horizonte",
    "addressRegion": "MG",
    "addressCountry": "BR"
  },
  "sameAs": [
    "https://www.instagram.com/clinicaexemplo"
  ]
}
</script>
```

Cada valor ali precisa existir também no texto da página (ou no rodapé, na página de contato). Para o tipo `Organization` com todos os campos explicados, veja [Schema Organization](https://grupomarfre.com.br/sites-agenticos/schema-organization/).

## Por que o JSON-LD é fácil de manter?

Porque ele vive num bloco único, separado da marcação visual. Para trocar o telefone, você edita uma linha no script, sem caçar atributos espalhados pelas tags do layout. Mexer no visual não quebra os dados, já que o bloco não depende de classes nem da ordem dos elementos.

Há ainda um ganho de organização: o bloco pode ser gerado a partir da mesma fonte que alimenta o site (um arquivo de dados, um campo do CMS), e não digitado à mão em cada página. Quanto menos cópias manuais, menos chance de endereço antigo em uma página e novo em outra.

Na régua do Grupo Marfre, o conjunto-base é `Organization` (name, description, url, contactPoint, address, sameAs), `WebSite` e `FAQPage` com pergunta visível, ligados entre si por `@id`. A ligação está explicada em [@id: como ligar os blocos](https://grupomarfre.com.br/sites-agenticos/id-e-ligacao-de-entidades/).

## O que o Google diz sobre dados estruturados e IA?

O Google diz que a Visão Geral por IA e o Modo IA usam o índice da Busca: a página precisa estar indexada e elegível a snippet. Segundo a documentação sobre recursos de IA (atualizada em 10/12/2025), não é preciso arquivo, markup ou schema especial para aparecer nesses recursos.

Daí saem duas consequências:

1.  Não existe tipo de schema que "ativa" a citação por IA. Quem vende isso está prometendo o que a documentação não confirma.
2.  O bloco deve espelhar o que a página mostra. Dado no JSON-LD que não aparece para o visitante é risco, não vantagem.

O caso mais claro é o de avaliações. Pelo que o Google orienta, o `aggregateRating` só entra com avaliação real, coletada no próprio site e visível na página, e não se agregam avaliações de outros sites. A página da própria empresa com `Organization` ou `LocalBusiness` não ganha estrelas. Os detalhes estão em [Avaliações no schema](https://grupomarfre.com.br/sites-agenticos/avaliacoes-no-schema/).

## A IA lê o JSON-LD?

Nenhuma documentação oficial usada neste guia afirma que um assistente específico (ChatGPT, Claude, Perplexity ou Gemini) leia o JSON-LD para montar a resposta. Por isso, não dá para contar com esse efeito. O que dá para sustentar é mais modesto: o bloco entrega a ficha da empresa em formato que qualquer ferramenta consegue processar sem interpretar o layout, e deixa o nome, o endereço e os perfis oficiais coerentes entre as páginas.

O texto visível continua sendo a base. Um bloco bem escrito sobre uma página vazia não resolve nada.

## Como conferir se o bloco bate com a página?

Rode este teste em três passos:

1.  Baixe o HTML cru e confirme que o bloco está lá, sem depender de JavaScript para aparecer:

```bash
curl -s https://www.example.com.br/ | grep -c 'application/ld+json'
```

2.  Abra o bloco e, para cada valor (nome, telefone, endereço, perfis), localize o mesmo dado no texto visível da página. O que não aparece, ou sai do bloco, ou entra na página.
3.  Passe o bloco por um validador para pegar erro de sintaxe e propriedade inexistente. O passo a passo está em [Como validar seus dados estruturados](https://grupomarfre.com.br/sites-agenticos/validar-dados-estruturados/).

Refaça o teste sempre que o telefone, o endereço ou os horários mudarem.

## Perguntas frequentes

### JSON-LD melhora minha posição no Google?

Não há garantia. A documentação do Google diz apenas que não exige schema especial para os recursos de IA. O bloco ajuda a descrever o negócio com clareza, mas posição depende de muitos outros fatores.

### Preciso de plugin para ter JSON-LD?

Não necessariamente. Plugin ou tema podem gerar o bloco, mas confira a saída no HTML cru: plugins podem trazer campos vazios ou dados desatualizados que ninguém revisou.

### Posso copiar o JSON-LD de outro site?

Não. O bloco descreve fatos da sua empresa, e copiar o de outro site leva nome, endereço e perfis errados para a sua página. Use o modelo como estrutura e troque todos os valores.

### Posso colocar nota de estrelas no bloco?

Só com avaliação real, coletada no próprio site e visível na página. Nota copiada do Google ou de outro site é violação das diretrizes de avaliação.

## Fontes consultadas

- [developers.google.com/search/docs/appearance/ai-features](https://developers.google.com/search/docs/appearance/ai-features)

## Leia também

### [schema.org: o vocabulário dos dados estruturados](https://grupomarfre.com.br/sites-agenticos/schema-org/)

schema.org é o vocabulário de tipos e propriedades usado nos dados estruturados. Veja o que é, os formatos (JSON-LD e microdados) e quais tipos existem.

### [Schema Organization: a ficha da empresa para as máquinas](https://grupomarfre.com.br/sites-agenticos/schema-organization/)

Schema Organization em JSON-LD: quais campos importam (name, url, logo, contactPoint, address, sameAs), como fixar o @id, exemplo completo e erros comuns.

### [@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 validar seus dados estruturados](https://grupomarfre.com.br/sites-agenticos/validar-dados-estruturados/)

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.

### [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.

### [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/json-ld/