Gerador de JSON-LD — crie dados estruturados para FAQ, artigo e trilha
Os dados estruturados ajudam o Google a entender o conteúdo da sua página e podem render resultados mais ricos e clicáveis. Gere JSON-LD no seu navegador. Passos: escolha um tipo (FAQ, artigo, trilha, organização), preencha os campos obrigatórios e copie um marcado Schema.org válido com uma tag script pronta para colar. A página distingue campos obrigatórios e opcionais e valida o JSON antes de copiar. Nada é enviado. Exemplo: um FAQ de duas perguntas gera mainEntity com dois nós Question.
Como funciona
Escolha um tipo de esquema, preencha o formulário e clique em Gerar. A página monta um objeto JSON-LD do Schema.org, verifica se os campos obrigatórios estão presentes e mostra o resultado formatado envolto em uma tag script para colar no <head> da sua página. Antes de renderizar, roda uma checagem de sintaxe; campos obrigatórios ausentes são listados em vez de produzir um marcado quebrado em silêncio.
O que o gerador verifica
Cada tipo tem uma forma mínima válida. O gerador valida que o JSON está bem-formado e aponta campos obrigatórios vazios, mas não consegue dizer se o marcado corresponde ao conteúdo visível da sua página.
- FAQ: mainEntity guarda uma matriz de nós Question; cada item precisa de name e acceptedAnswer.text.
- Artigo: headline e author são obrigatórios; datePublished, dateModified, image e description são opcionais, mas recomendados.
- Trilha: itemListElement é uma lista ordenada em que cada position precisa ser sequencial (1, 2, 3…).
- Consistência: o Google compara dados estruturados com a página visível. Marcar conteúdo que não está na página viola as políticas de spam.
Exemplo
Exemplo de FAQ com duas perguntas: “Como instalo o SDK?” e “Os dados são processados localmente?” → a saída traz uma matriz mainEntity com dois objetos Question, cada um com acceptedAnswer.text, pronta para colar no head da sua página.
Quando usar
- Páginas de FAQ: adicione uma lista de perguntas como dados estruturados para que os buscadores entendam melhor as perguntas e respostas.
- Artigos e documentação: insira o marcado Article com autor e datas em sites de conteúdo e bases de conhecimento.
- Produto e estrutura do site: use Breadcrumb para descrever caminhos de navegação e Organization para nome e logo da marca.
Frequently asked questions
Para quem são os dados estruturados JSON-LD?
Para buscadores e outros consumidores que leem o marcado do Schema.org. Ele fica embutido no seu HTML para que máquinas entendam entidades, relações e fatos — não é conteúdo visível ao usuário.
Adicionar o schema FAQ garante um resultado rico?
Não. Os resultados ricos de FAQ pararam de aparecer em todo o site em maio de 2026, e os de HowTo antes. O Google pode continuar lendo o marcado para entender a página, mas não há garantia de rich result, então trate o schema como clareza para compreensão, não como KPI de ranking ou rich result.
Quais campos são obrigatórios no marcado gerado?
FAQ precisa de pergunta e resposta por item; Artigo precisa de manchete e autor; Trilha precisa de pelo menos dois níveis com nome e URL; Organização precisa de nome e URL. A página marca os obrigatórios e lista o que faltar.
Por que o marcado precisa corresponder ao conteúdo visível?
O Google considera enganosos os dados estruturados que não refletem a página visível. Por exemplo, uma pergunta de FAQ que a página não responde de fato pode ser vista como abuso de marcado mesmo quando o JSON é válido.
Dúvidas ou feedback
Algo pouco claro, quebrado ou faltando? Escreva abaixo — lemos cada mensagem sobre estas ferramentas.