Microdados, Schema e JSON-LD: como preparar seu site para buscadores e assistentes de IA
Entenda como a marcação estruturada funciona, veja exemplos para empresas de serviços e aprenda a implementar e validar JSON-LD com segurança.
Conheça uma avaliação inicial para o seu site
Neste artigo8 seções
- O que são microdados, Schema e JSON-LD?
- Como o Schema e o JSON-LD ajudam buscadores e assistentes de IA
- Quais tipos de marcação usar em clínicas, escritórios e comércios?
- Exemplos práticos de JSON-LD para empresas de serviços
- Como inserir JSON-LD no WordPress e no Joomla sem quebrar o site
- Como validar Schema e JSON-LD antes de publicar
- Erros comuns ao implementar dados estruturados
- Quando buscar apoio técnico para Schema e JSON-LD
O que são microdados, Schema e JSON-LD?
Microdados, Schema e JSON-LD são formas de apresentar informações estruturadas sobre uma página. Em vez de deixar buscadores interpretarem apenas o texto visível, você informa de maneira organizada que determinado conteúdo representa uma empresa, um serviço, uma pergunta frequente, um produto ou um endereço.
Schema.org é um vocabulário compartilhado por mecanismos de busca e plataformas digitais. Ele define tipos de entidades e propriedades, como LocalBusiness, Service, Product, FAQPage, Article e Organization. O vocabulário não substitui o conteúdo da página, mas ajuda a esclarecer a relação entre as informações apresentadas.
Microdados inserem atributos diretamente nas tags HTML visíveis. Um exemplo simples seria adicionar itemscope e itemprop ao nome e ao telefone de uma empresa. JSON-LD segue outra lógica: fica em um bloco de dados separado, normalmente dentro de <script type="application/ld+json">, sem alterar a aparência da página.
Na prática, JSON-LD costuma ser mais simples de manter em sites institucionais, WordPress e Joomla. A equipe consegue atualizar o bloco sem espalhar atributos por vários elementos do HTML, reduzindo o risco de confundir o conteúdo visual com a marcação técnica.
A documentação oficial do Schema.org explica como o vocabulário é organizado e quais propriedades podem ser usadas. Já o guia do Google sobre dados estruturados esclarece que a marcação pode ajudar o buscador a compreender o conteúdo, mas não garante recursos visuais especiais nem posições específicas nos resultados.
Como o Schema e o JSON-LD ajudam buscadores e assistentes de IA
- ✓Identificação da entidade: o site pode deixar mais claro qual é a empresa, quais serviços oferece, onde atende e como pode ser contatada. Isso é especialmente útil quando o nome comercial, domínio, telefone e perfis públicos aparecem em diferentes páginas.
- ✓Contexto para cada página: uma página de serviço pode ser descrita como
Service, um artigo comoArticlee uma página de perguntas frequentes comoFAQPage, desde que o conteúdo visível realmente corresponda ao tipo declarado. - ✓Menos ambiguidade: informar que um número é telefone, que um valor representa preço ou que uma sequência de perguntas contém respostas facilita a interpretação técnica dos dados.
- ✓Base mais organizada para integrações: sistemas de busca, ferramentas de auditoria e outros agentes podem encontrar informações em um formato previsível. Isso não significa que qualquer assistente de IA utilizará todos os campos, mas melhora a disponibilidade de contexto público.
- ✓Apoio à elegibilidade para recursos: determinados formatos de resultado dependem de requisitos específicos, qualidade do conteúdo e políticas da plataforma. A marcação é uma condição técnica possível, não uma promessa de exibição.
- ✓Manutenção mais controlável: um bloco centralizado de JSON-LD pode ser revisado durante atualizações de serviços, telefone, preço, horário ou endereço, evitando informações conflitantes.
Quais tipos de marcação usar em clínicas, escritórios e comércios?
A escolha do tipo deve começar pelo conteúdo real da página, não por uma lista de propriedades desejadas. Uma clínica pode usar uma entidade organizacional adequada para descrever o negócio, uma página de serviço para explicar uma consulta e uma página de artigo para publicar orientações gerais.
Para prestadores de serviços, Service é útil quando a página detalha o que é oferecido, para quem se destina, quais etapas existem e como solicitar atendimento. O campo provider pode relacionar o serviço à organização responsável, enquanto areaServed deve refletir a área efetivamente atendida, sem criar localidades que não façam parte da operação.
Consultórios e clínicas precisam ter cuidado redobrado com informações de saúde. A marcação não deve expor dados pessoais de pacientes, prometer resultados clínicos ou transformar uma explicação educativa em diagnóstico. O texto visível, as credenciais e as orientações de contato precisam ser claros e responsáveis.
Escritórios podem estruturar a organização e seus serviços, mas não devem inserir avaliações, preços ou especialidades que não estejam comprovados na página. Para comércios, Product pode fazer sentido quando há uma oferta individualizada com nome, descrição, imagem e preço atualizados.
Uma empresa com atendimento presencial pode incluir LocalBusiness ou um subtipo compatível quando há informações públicas e consistentes sobre endereço, telefone e horário. Se o negócio atende remotamente ou em diferentes locais, a estrutura deve refletir esse modelo, sem publicar um endereço apenas para tentar obter relevância local.
A marcação de perguntas frequentes merece atenção. O tipo FAQPage deve representar perguntas e respostas que aparecem de fato na página, com conteúdo acessível ao usuário. Para organizar esse material, consulte também o guia sobre FAQ para páginas de serviço e compreensão por buscadores e assistentes de IA.
Exemplos práticos de JSON-LD para empresas de serviços
O exemplo abaixo descreve uma organização. Substitua os dados pelos valores reais da empresa e mantenha o mesmo nome, domínio, telefone e logotipo em todo o site. A propriedade sameAs só deve apontar para perfis oficiais ou páginas públicas que realmente representem o negócio.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Nome da empresa",
"url": "https://www.exemplo.com.br/",
"logo": "https://www.exemplo.com.br/imagens/logo.png",
"telephone": "+55 00 00000-0000",
"sameAs": ["https://www.instagram.com/perfil-oficial/"]
}
</script>
Para uma página específica de serviço, o bloco pode ser mais detalhado. A descrição precisa resumir o que o visitante encontra, e a URL deve levar à página correspondente, não à página inicial.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Service",
"name": "Criação de site institucional",
"serviceType": "Desenvolvimento de site profissional",
"description": "Desenvolvimento de site responsivo com estrutura técnica, hospedagem e suporte.",
"provider": {
"@type": "Organization",
"name": "Nome da empresa",
"url": "https://www.exemplo.com.br/"
},
"url": "https://www.exemplo.com.br/criacao-de-sites/"
}
</script>
O formato é intencionalmente enxuto. Inserir dezenas de campos sem conteúdo correspondente aumenta a chance de inconsistência e não transforma uma página superficial em uma referência. Para aprofundar a parte editorial antes da implementação, use o roteiro de conteúdo para páginas de serviço com foco em SEO e compreensão por IA.
Em uma página de perguntas frequentes, cada pergunta e resposta precisa estar visível ao visitante. Não esconda respostas exclusivamente para obter um resultado enriquecido e não use o bloco para publicar afirmações que a empresa não consegue sustentar.
Para Product, o preço, a disponibilidade e a imagem devem corresponder ao produto apresentado. Uma loja que altera valores diariamente precisa definir um processo para atualizar o JSON-LD junto com a interface, evitando que o código informe um valor diferente daquele visto pelo consumidor.
Como inserir JSON-LD no WordPress e no Joomla sem quebrar o site
- 1
Faça um inventário antes de editar
Liste as páginas que receberão marcação, o tipo Schema adequado, a fonte de cada informação e quem será responsável por futuras atualizações. Faça backup do site e registre o estado atual antes de alterar tema, extensões ou arquivos.
- 2
Escolha o ponto de implementação
No WordPress, o JSON-LD pode ser inserido por uma extensão de SEO, por uma área específica do tema ou por uma solução desenvolvida para o projeto. No Joomla, pode ser incluído por uma extensão, recurso de código personalizado ou ajuste controlado do template.
- 3
Evite duplicidade
Verifique se o tema, a extensão de SEO e outro recurso já geram
Organization,Article,BreadcrumbListou tipos semelhantes. Dois blocos não são automaticamente um problema, mas entidades conflitantes, nomes diferentes e telefones divergentes prejudicam a manutenção. - 4
Use dados visíveis e atualizados
O conteúdo essencial do JSON-LD deve estar disponível na página para o usuário. Não informe preço, avaliação, horário, endereço, serviço ou disponibilidade que não possam ser confirmados no conteúdo público.
- 5
Publique primeiro em ambiente controlado
Quando a plataforma permitir, teste em uma cópia ou em uma página de baixa exposição antes de replicar a configuração. Observe o código-fonte, o carregamento no celular, os formulários, o menu, o certificado SSL e eventuais erros de PHP ou JavaScript.
- 6
Documente a configuração
Guarde o tipo usado, as propriedades preenchidas, a origem dos dados e a data da última revisão. Essa documentação facilita a troca de equipe, a atualização de domínio e a correção de informações após uma mudança comercial.
Como validar Schema e JSON-LD antes de publicar
Validação não é apenas copiar uma URL em uma ferramenta. O processo precisa conferir sintaxe, elegibilidade, correspondência com o conteúdo e funcionamento da página. Um JSON inválido pode ser ignorado, enquanto uma marcação tecnicamente válida ainda pode estar inadequada para aquela página.
Comece pelo Validador do Schema.org, que ajuda a identificar erros de estrutura e propriedades. Em seguida, use o Teste de resultados avançados do Google para verificar se o tipo pode ser analisado pelos recursos compatíveis da plataforma.
Depois da publicação, confira o código-fonte da página em uma janela anônima e procure por application/ld+json. Teste a versão com e sem www, a página móvel, o carregamento sem cookies opcionais e a navegação por links internos. O bloco não deve depender de uma ação que o robô ou o usuário não consiga executar.
A Solução Via Web aplica uma revisão prática que inclui nome comercial, URL canônica, telefone, logotipo, tipo de entidade, relações entre organização e serviço, duplicidades e informações desatualizadas. Em projetos WordPress e Joomla, essa etapa também considera a extensão utilizada, o tema e os efeitos de futuras atualizações.
Use este roteiro de controle de qualidade antes de considerar a tarefa concluída:
- O tipo escolhido descreve a finalidade principal da página?
- Todas as propriedades importantes têm valores reais?
- O conteúdo marcado aparece claramente para o visitante?
- O nome, domínio, telefone e logotipo são consistentes?
- Há apenas uma fonte principal para cada entidade?
- O JSON-LD passa pela validação sem erros críticos?
- A página continua rápida, responsiva e acessível?
- O bloco foi revisado após mudanças de preço, horário ou serviço?
- O sitemap e a indexação da URL estão em condições adequadas?
- Foi registrada a data e o responsável pela revisão?
A marcação estruturada trabalha junto com conteúdo útil, rastreabilidade, desempenho e arquitetura de informação. Ela não corrige páginas lentas ou confusas sozinha. Para uma visão mais ampla das bases técnicas, consulte o guia de otimização para Google e atração de clientes.
Erros comuns ao implementar dados estruturados
O erro mais frequente é marcar informações que não aparecem na página. Um site pode declarar cinco estrelas, preço promocional ou horário de funcionamento no JSON-LD, mas, se o visitante não encontra esses dados, a marcação perde confiabilidade e pode contrariar as orientações da plataforma.
Outro problema é escolher um tipo apenas porque ele parece oferecer mais possibilidades de exibição. FAQPage, Product e LocalBusiness têm contextos diferentes. A decisão deve seguir o propósito da página e a realidade da operação, não uma tentativa de inserir o maior número de propriedades possível.
Também é comum deixar dados antigos depois de uma mudança. Uma clínica troca o telefone, um comércio encerra uma unidade ou um prestador altera sua área de atendimento, mas o JSON-LD permanece igual por meses. Crie uma rotina para revisar o código sempre que houver alteração no site ou no negócio.
A duplicidade aparece quando uma extensão gera uma organização, o tema cria outra e um código manual adiciona uma terceira. Se cada bloco usa nome, URL ou logotipo diferente, buscadores podem ter dificuldade para relacionar as entidades. Antes de instalar outra ferramenta, faça uma auditoria do HTML e das configurações já existentes.
Por fim, não trate a validação como uma tarefa única. O site muda, as diretrizes são atualizadas e novas páginas são publicadas. A marcação deve entrar no fluxo de manutenção, junto com backups, atualizações, segurança, verificação de links e acompanhamento da indexação.
Quando buscar apoio técnico para Schema e JSON-LD
- ✓Você encontrou vários blocos JSON-LD e não sabe qual extensão ou parte do tema os criou.
- ✓O site foi desenvolvido em WordPress ou Joomla por pessoas diferentes e não há documentação da estrutura técnica.
- ✓As páginas exibem informações comerciais diferentes das informações encontradas no código-fonte.
- ✓A empresa tem várias unidades, serviços, profissionais ou formas de atendimento e precisa representar essas relações sem confusão.
- ✓Uma alteração de hospedagem, tema ou extensão pode afetar o cabeçalho, o código personalizado ou a geração automática da marcação.
- ✓Você precisa conectar criação de site, hospedagem, SEO, formulários e acompanhamento técnico em um único processo.
- ✓A página recebe tráfego de campanhas ou busca orgânica, mas a equipe não consegue identificar se o problema está no conteúdo, na estrutura ou na conversão.
Perguntas Frequentes
Schema.org melhora diretamente a posição de um site no Google?▼
Não há garantia de melhora direta de posição apenas por adicionar Schema.org. A marcação ajuda o buscador a interpretar entidades e informações, podendo contribuir para a elegibilidade de determinados recursos de apresentação. O desempenho orgânico depende também de conteúdo útil, autoridade, rastreamento, experiência da página, relevância e outros fatores. Por isso, Schema deve fazer parte de um trabalho contínuo de SEO, não ser tratado como atalho.
Qual é a diferença entre microdados e JSON-LD?▼
Microdados usam atributos dentro do HTML que apresenta o conteúdo, como itemtype e itemprop. JSON-LD descreve as mesmas entidades em um bloco separado, geralmente no cabeçalho ou no corpo da página. JSON-LD costuma facilitar a implementação e a manutenção, enquanto microdados podem aparecer em projetos que já foram estruturados dessa forma. O ponto principal é manter os dados corretos, coerentes e relacionados ao conteúdo visível.
Qual marcação Schema é indicada para uma empresa prestadora de serviços?▼
A organização pode ser descrita com Organization ou um tipo mais específico quando ele representar corretamente a atividade. Cada página que detalha uma oferta pode usar Service, vinculando o serviço ao prestador e à URL correspondente. Informações sobre endereço, horário e atendimento presencial só devem ser incluídas quando forem públicas e verdadeiras. A escolha depende do conteúdo e da operação, por isso uma auditoria da arquitetura do site é útil antes da implementação.
Como colocar JSON-LD no WordPress sem instalar várias extensões?▼
Primeiro, verifique se a extensão de SEO ou o tema já gera dados estruturados. Se houver necessidade de personalização, use um único ponto controlado, como uma extensão confiável, um recurso específico do tema ou uma implementação feita sob medida. Faça backup, teste em ambiente controlado e procure duplicidades no código-fonte. Evite colar scripts aleatórios em áreas que possam interpretar ou modificar o código.
Como inserir Schema em um site Joomla?▼
No Joomla, a inserção pode ocorrer por extensão, código personalizado ou ajuste do template, conforme a estrutura do projeto. O caminho escolhido deve permitir atualizar o conteúdo sem perder a marcação em uma atualização futura. Antes de publicar, confirme se o bloco aparece no código-fonte, se o JSON é válido e se a página continua funcionando. Sites antigos podem exigir uma avaliação do template e das extensões antes de qualquer alteração.
O JSON-LD precisa estar visível na página?▼
O bloco de código não precisa aparecer visualmente como texto, mas as informações essenciais declaradas devem estar disponíveis ao usuário na página correspondente. Não é uma boa prática usar o JSON-LD para esconder ofertas, avaliações, preços ou serviços que o visitante não consegue encontrar. A correspondência entre conteúdo visível e marcação é um dos critérios de qualidade mais importantes. Quando houver dúvida, simplifique o bloco e marque apenas o que está claramente explicado.
Como validar dados estruturados antes de publicar um site?▼
Use o Validador do Schema.org para conferir a estrutura e o Teste de resultados avançados do Google para analisar tipos compatíveis com recursos da busca. Depois, revise manualmente a página, o código-fonte, a versão móvel, a URL canônica e a consistência das informações comerciais. Corrija erros críticos antes de publicar e registre a configuração para futuras atualizações. A validação também deve ser repetida quando tema, extensão, domínio, serviço ou preço forem alterados.
Dados estruturados fazem meu site aparecer nas respostas de assistentes de IA?▼
Não existe garantia de que um assistente de IA usará uma determinada marcação ou citará uma empresa. JSON-LD fornece contexto em um formato legível por máquinas, mas a compreensão pública do negócio também depende de conteúdo claro, informações consistentes, reputação e acessibilidade do site. Escreva para as pessoas, descreva serviços com precisão e mantenha dados institucionais atualizados. A marcação é uma camada técnica de apoio, não um mecanismo isolado de visibilidade.
Quer saber se a marcação do seu site está correta?
Solicitar uma avaliação inicialSobre o Autor
Carlos Roberto Alves da Silva está à frente da Solução Via Web e atua na criação de sites e soluções digitais. Desenvolve sites institucionais e landing pages em HTML, CSS e JavaScript, além de projetos em Joomla e WordPress. Também trabalha com hospedagem, migração, suporte técnico e Google Ads, atendendo empresas e profissionais em diferentes necessidades de presença digital.