Pular para o conteúdo
Made For Builders iconoMade For Builders
Visibilidade

Schema e dados estruturados (JSON-LD)

edu-lopez-parada16 min de leitura
Schema e dados estruturados (JSON-LD)

Dados estruturados em JSON-LD dizem aos buscadores, em linguagem de máquina, exatamente o que sua empresa faz, onde atende e o que os clientes dizem. Para prestadores de serviços residenciais, os tipos essenciais são LocalBusiness, Service, FAQPage, Review com AggregateRating e BreadcrumbList. Bem implementado, o schema habilita rich results no Google e facilita a citação por sistemas de IA. Mal implementado, gera avisos no Teste de Resultados Ricos e não aparece. Este guia traz exemplos de código reais, os erros mais comuns e como validar.

A maioria dos sites de prestadores de serviços residenciais comunica perfeitamente para humanos e quase nada para máquinas. Um visitante vê "Encanador 24h, atendemos toda a Grande São Paulo, nota 4,8 no Google". O buscador, sem ajuda, vê apenas texto. Dados estruturados em JSON-LD existem para fechar essa lacuna: traduzem o que a página diz para um vocabulário que Google, Bing e sistemas de IA entendem sem ambiguidade.

O Google recomenda o JSON-LD como formato preferido de dados estruturados, usando o vocabulário do schema.org. Implementado corretamente, ele habilita rich results — estrelas de avaliação, perguntas frequentes expandidas, trilha de navegação — e ajuda sistemas generativos a interpretar e atribuir sua informação com precisão.

Este guia mostra, com exemplos de código reais, os cinco tipos de schema que importam para prestadores: LocalBusiness, Service, FAQPage, Review com AggregateRating e BreadcrumbList. Também cobre como validar e os erros mais comuns que fazem o schema falhar silenciosamente.

Por que dados estruturados importam para prestadores

Três benefícios concretos:

  1. Rich results. Estrelas, FAQs e breadcrumbs na página de resultados aumentam a área visível e a clareza do seu anúncio orgânico.
  2. Compreensão por máquinas. Buscadores e sistemas de IA entendem com mais certeza o que você faz, onde e com que reputação.
  3. Consistência de dados (NAP). Nome, endereço e telefone marcados de forma estruturada reforçam os sinais que sustentam o SEO local e a presença no Google Maps.

Uma ressalva honesta desde já: marcar corretamente torna a página elegível a rich results, mas não garante a exibição. Schema é condição necessária, não suficiente.


LocalBusiness: a base de tudo

O tipo LocalBusiness identifica a empresa. O schema.org define subtipos específicos úteis para o setor: Plumber, Electrician, HVACBusiness, HousePainter, Locksmith, RoofingContractor. Use o subtipo mais específico que se aplica.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Plumber",
  "name": "Nome da Empresa",
  "image": "https://seusite.com.br/foto-equipe.jpg",
  "@id": "https://seusite.com.br/#empresa",
  "url": "https://seusite.com.br/",
  "telephone": "+5511999999999",
  "priceRange": "$$",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Rua Exemplo, 123",
    "addressLocality": "Guarulhos",
    "addressRegion": "SP",
    "postalCode": "07000-000",
    "addressCountry": "BR"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": -23.4543,
    "longitude": -46.5337
  },
  "areaServed": [
    { "@type": "City", "name": "Guarulhos" },
    { "@type": "City", "name": "Sao Paulo" }
  ],
  "openingHoursSpecification": [{
    "@type": "OpeningHoursSpecification",
    "dayOfWeek": ["Monday","Tuesday","Wednesday","Thursday","Friday"],
    "opens": "08:00",
    "closes": "18:00"
  }]
}
</script>

Pontos-chave: telefone em formato internacional, endereço completo, areaServed refletindo onde você atende de verdade (a mesma lógica das páginas de cidade) e horário real. A documentação do Google sobre local business detalha as propriedades aceitas.

Código-fonte exibido em tela de laptop, representando implementação de JSON-LD
JSON-LD fica em um bloco script separado do conteúdo visível: não muda o que o usuário vê, mas explica o significado da página às máquinas. Foto: Markus Spiske / Pexels

Service: descrever cada serviço

O tipo Service descreve um serviço oferecido, idealmente na página de serviço correspondente.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Service",
  "serviceType": "Deteccao e conserto de vazamentos",
  "provider": {
    "@type": "Plumber",
    "name": "Nome da Empresa",
    "@id": "https://seusite.com.br/#empresa"
  },
  "areaServed": { "@type": "City", "name": "Guarulhos" },
  "description": "Localizacao e reparo de vazamentos em tubulacoes residenciais com equipamento de deteccao."
}
</script>

O @id do provider aponta para a entidade LocalBusiness, conectando os dois nós. Isso evita duplicar a empresa e mantém o grafo coerente.


FAQPage: perguntas frequentes marcadas

Se a página tem uma seção de perguntas frequentes visível ao usuário, marque-a com FAQPage. As perguntas e respostas devem existir de fato na página.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "Voces atendem em quanto tempo numa emergencia?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Em emergencias, o atendimento na regiao de Guarulhos costuma ocorrer no mesmo dia, conforme disponibilidade da equipe."
    }
  }, {
    "@type": "Question",
    "name": "Voces dao garantia no servico?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Sim. Os reparos tem garantia conforme o tipo de servico, informada no orcamento."
    }
  }]
}
</script>

Regra do Google: o conteúdo marcado precisa estar visível ao usuário na página. Marcar FAQs ocultas viola a política.


Review e AggregateRating: avaliações com responsabilidade

Avaliações marcadas podem gerar estrelas no resultado. Aqui exige-se rigor ético e técnico. A política de review snippet do Google proíbe avaliações inventadas e desencoraja "self-serving reviews" — a empresa marcando notas sobre si mesma sem origem genuína.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Plumber",
  "name": "Nome da Empresa",
  "@id": "https://seusite.com.br/#empresa",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "127"
  }
}
</script>

Nunca invente notas ou contagens. Os números precisam corresponder a avaliações reais e verificáveis. A ciência por trás do impacto dessas avaliações está no nosso artigo sobre a ciência das avaliações online, e a estratégia prática em avaliações Google para empresas de serviços residenciais.

Tablet exibindo cinco estrelas, representando AggregateRating e review snippets
AggregateRating só deve refletir avaliações reais e verificáveis. Inventar notas viola a política do Google e é desonesto. Foto: Towfiqu barbhuiya / Pexels

BreadcrumbList: a trilha de navegação

O BreadcrumbList informa a hierarquia da página e pode exibir a trilha nos resultados.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [{
    "@type": "ListItem",
    "position": 1,
    "name": "Inicio",
    "item": "https://seusite.com.br/"
  }, {
    "@type": "ListItem",
    "position": 2,
    "name": "Servicos",
    "item": "https://seusite.com.br/servicos/"
  }, {
    "@type": "ListItem",
    "position": 3,
    "name": "Desentupimento em Guarulhos",
    "item": "https://seusite.com.br/servicos/desentupimento/guarulhos/"
  }]
}
</script>

Casa diretamente com a arquitetura descrita nas páginas de serviço e de cidade.


Como validar

FerramentaPara que serveURL
Teste de Resultados RicosElegibilidade a rich results e avisossearch.google.com/test/rich-results
Schema Markup ValidatorValidação de sintaxe contra o vocabuláriovalidator.schema.org
Search Console (Dados estruturados)Erros em escala após indexaçãosearch.google.com/search-console

Fluxo recomendado: rascunhe o JSON-LD, valide no Teste de Resultados Ricos, corrija avisos, publique e acompanhe o relatório no Search Console. O Schema Markup Validator ajuda quando o erro é de sintaxe pura.

Código de programa em tela de notebook, representando validação de dados estruturados antes de publicar
Valide o JSON-LD no Teste de Resultados Ricos antes de publicar: um bloco com erro de sintaxe é ignorado inteiro. Foto: Rodrigo Santos / Pexels

Erros comuns que fazem o schema falhar

  • Marcar conteúdo que não está visível (FAQs ocultas, avaliações inexistentes) — viola a política e pode gerar ação manual.
  • Inventar AggregateRating — além de antiético, é detectável e punível.
  • Inconsistência de NAP entre schema, site, Perfil da Empresa e diretórios — confunde os sinais.
  • JSON-LD inválido (vírgula sobrando, chave fechada errada) — o bloco inteiro é ignorado.
  • @type errado (usar Organization onde cabe LocalBusiness) — perde elegibilidade a rich results locais.
  • Esquecer o @id para conectar entidades — gera duplicação no grafo.

No projeto da Made For Builders, a validação de schema roda em CI: JSON-LD inválido quebra o build, justamente para evitar que esses erros cheguem à produção.


Schema e a era das respostas de IA

Sistemas como ChatGPT, Perplexity e o AI Overviews do Google resumem e atribuem informação. Dados estruturados tornam o significado da página explícito, o que facilita interpretação e atribuição corretas. Não há garantia formal publicada de que schema, por si, aumente citações em respostas de IA — mas clareza semântica, FAQs marcadas e dados consistentes nunca atrapalham.

Para entender o mecanismo de seleção de fontes, veja como as IAs generativas escolhem as fontes que citam, como aparecer no ChatGPT e Perplexity e o que é GEO, otimização para motores generativos.

Conclusão

Dados estruturados são o trabalho técnico de SEO com melhor relação esforço-retorno para prestadores: poucas linhas de JSON-LD bem feitas habilitam rich results e melhoram a compreensão por máquinas. Os cinco tipos — LocalBusiness, Service, FAQPage, Review/AggregateRating e BreadcrumbList — cobrem quase todas as necessidades do setor.

Implemente com honestidade (nunca invente notas), valide sempre no Teste de Resultados Ricos e mantenha o NAP consistente. Para continuar, veja as páginas de serviço e de cidade, a estratégia de visibilidade e o restante do blog.

Perguntas frequentes

Resolvemos dúvidas antes de começar

Ajuda direta

Sua dúvida não está aqui?

Falar com a equipe
  1. Q/01O que é JSON-LD e por que o Google o recomenda?

    JSON-LD (JavaScript Object Notation for Linked Data) é um formato de dados estruturados que você insere em um bloco script no HTML para descrever o conteúdo da página em vocabulário padronizado do schema.org. O Google recomenda JSON-LD como formato preferido para dados estruturados porque ele fica separado do conteúdo visível, é mais fácil de manter e pode ser injetado dinamicamente. Ele não muda o que o usuário vê, mas ajuda buscadores e sistemas a entender o significado da página.

  2. Q/02Quais tipos de schema um prestador de serviços residenciais precisa?

    Os essenciais são: LocalBusiness (ou um subtipo como Plumber, Electrician, HVACBusiness) para identificar a empresa, endereço, horário e área atendida; Service para descrever cada serviço; FAQPage para perguntas frequentes; Review e AggregateRating para avaliações; e BreadcrumbList para a hierarquia de navegação. O schema.org define subtipos específicos como Plumber e Electrician que herdam de LocalBusiness e descrevem melhor a atividade.

  3. Q/03Posso marcar avaliações (Review) com schema na minha própria página?

    Pode, mas com cautela. A política do Google exige que as avaliações marcadas sejam genuínas, provenientes de clientes reais, e não podem ser as próprias avaliações da empresa sobre si mesma (self-serving reviews) quando se trata de AggregateRating da entidade que controla a página. Avaliações de terceiros exibidas com schema devem refletir feedback autêntico e coletado de forma legítima. Nunca invente avaliações ou notas: além de violar a política, é desonesto e pode gerar ação manual contra o site.

  4. Q/04Como valido se meu schema está correto?

    Use o Teste de Resultados Ricos do Google (Rich Results Test) para verificar se a página é elegível a rich results e quais avisos ou erros existem. Para validação genérica de sintaxe contra o vocabulário, use o Schema Markup Validator do schema.org. O Relatório de Dados Estruturados no Google Search Console mostra erros em escala após a indexação. Comece pelo Teste de Resultados Ricos antes de publicar.

  5. Q/05Dados estruturados garantem rich results no Google?

    Não. O Google afirma explicitamente que marcar a página corretamente a torna elegível a rich results, mas não garante a exibição. A decisão de mostrar depende de qualidade, relevância e critérios do algoritmo. Schema é condição necessária, não suficiente. Implemente corretamente, valide, e trate o rich result como possibilidade, não como certeza.

  6. Q/06Schema ajuda a ser citado por ChatGPT e Perplexity?

    Dados estruturados tornam o significado da página mais explícito para máquinas, o que pode ajudar sistemas que indexam e resumem conteúdo a entender e atribuir corretamente sua informação. Não há garantia formal publicada de que schema aumente diretamente citações em respostas de IA, mas clareza semântica, FAQs bem marcadas e dados consistentes facilitam a interpretação. Combine schema com conteúdo factual e citável. Veja nosso guia sobre como as IAs escolhem fontes.