Gerador de schema FAQ: monte o JSON-LD do FAQPage

Esta página monta e audita o bloco de uma página específica. Se a pergunta é outra, se o seu site inteiro está pronto para ser citado por IA, a página certa é o checklist de prontidão GEO, que roda um modelo de 16 itens e trata dados estruturados como um item de 6 pontos entre muitos. E se o que falta é apontar o conteúdo canônico do site como um todo, o gerador de llms.txt resolve outro arquivo, na raiz do domínio. As três se completam e não se sobrepõem: o checklist diz o que consertar, o llms.txt aponta o site, esta aqui marca a página.

Antes de tudo: o rich result de FAQ acabou para quase todo mundo

Vale começar pela parte que a maioria das ferramentas omite. Em agosto de 2023 o Google restringiu o rich result de FAQ a sites de governo e de saúde reconhecidos. Se você não é um deles, marcar a página com FAQPage não vai abrir aquele acordeão de perguntas no resultado de busca, e prometer o contrário é vender o que não existe.

Isso não zerou o valor do tipo, mudou a razão de usá-lo. Um bloco FAQPage continua sendo a maneira mais barata de dizer, em formato de máquina, onde cada resposta começa e termina. Quem consome isso hoje não é só o Google: são os sistemas de IA que precisam recortar trechos curtos, os buscadores menores, os agregadores e, com frequência subestimada, a busca interna do seu próprio site. E tem o efeito colateral que mais rende: preencher o bloco obriga a escrever uma resposta que resolve a pergunta na primeira frase.

Como usar

1. Preencha a URL da página com o endereço completo, começando em https. Ela vira o url e o @id do bloco, com a âncora #faq, que é o que permite referenciar este FAQ especificamente quando a página carrega mais de um schema.
2. Escreva os pares na caixa grande: pergunta numa linha, resposta nas linhas seguintes, e uma linha vazia entre os pares. Se você já tem o conteúdo em outro formato, a caixa também entende P: e R:, o par inteiro numa linha só separado por barra vertical, e markdown com ### na pergunta.
3. Confirme a caixa de conteúdo visível na página só se for verdade. Ela vale 6 pontos porque marcação que descreve texto ausente da página é violação de diretriz, não otimização.
4. Olhe a lista de conferência abaixo do bloco e resolva o que está em vermelho, de cima para baixo. Cada item mostra quanto vale e quanto você levou.
5. Copie com a tag script e cole no HTML da página, dentro do head ou no fim do body, tanto faz. Antes de colar, procure application/ld+json no código-fonte: se o seu CMS já injeta um FAQPage, você quer editar aquele, não somar um segundo.

Como funciona: a estrutura e os 10 pesos

O FAQPage é raso de propósito. Uma lista de perguntas pendurada num tipo de página, e cada pergunta com exatamente uma resposta aceita. Não há campo de autor, de data nem de prioridade: o que existe é o texto.

Como a estrutura é trivial, a diferença entre um bloco que serve e um que não serve está inteira no texto. Por isso a auditoria não mede sintaxe, que qualquer gerador acerta: ela mede conformidade (isto é um FAQ de verdade?) e recortabilidade (esta resposta sobrevive fora do contexto?). Os 10 itens fecham exatamente 100 pontos.

Tamanho da resposta vale 14 porque é o item que mais reprova na prática, nas duas pontas: resposta de dez caracteres não responde e resposta de mil deixou de ser recorte para virar seção de artigo. Cobertura vale outros 14 porque FAQPage com uma pergunta é uma pergunta, não um FAQ. Interrogação vale 12 porque Question sem pergunta é a assinatura de quem transformou títulos de seção em FAQ para preencher um campo. E a primeira frase vale 10 porque é literalmente ela que um sistema recorta: se a resposta começa com contexto, o recorte leva o contexto e não a resposta.

Exemplo trabalhado (reproduz o resultado padrão)

Os valores que já vêm preenchidos descrevem um FAQ de página de preços com 5 perguntas, e duas falhas plantadas de propósito para a fila de correção não nascer vazia: a quarta entrada foi escrita como título (Preço do plano para times grandes, sem interrogação) e a quinta abre com uma frase de 39 palavras antes de chegar ao ponto.

• Cobertura: 5 perguntas passam do alvo de 4, então 14 de 14.
• Interrogação: 4 das 5 terminam em ponto de interrogação, então 12 × 4 ÷ 5 = 9,6 de 12.
• Tamanho da resposta: as 5 ficam entre 186 e 261 caracteres, dentro da faixa de 50 a 800, então 14 de 14.
• Resposta na primeira frase: 4 das 5 abrem com até 25 palavras, então 10 × 4 ÷ 5 = 8 de 10. A média fica em 18,6 palavras justamente porque uma delas tem 39.
• Sem pergunta repetida 10 de 10, só HTML aceito 10 de 10, sem resposta repetida 8 de 8, URL declarada 8 de 8, pergunta curta 8 de 8 (a maior tem 37 caracteres, longe do teto de 120) e conteúdo visível 6 de 6.
• Nota: 100 menos os 2,4 da interrogação e os 2 da primeira frase = 95,6, arredondado para 96 de 100, faixa A. O bloco fica em 2,2 kB.

Reescreva a quarta entrada como Quanto custa o plano para times grandes? e a nota sobe 2,4 pontos. Corte a quinta resposta para começar em Em data centers no Brasil, jogando a explicação de residência de dados para a segunda frase, e sobem os outros 2. Cada correção custa um minuto e o preço por linha sobe conforme o FAQ encolhe, porque os itens proporcionais dividem pelo total de perguntas.

Como interpretar e onde a nota engana

A nota mede o bloco, não o resultado. Um FAQPage nota 100 numa página que os crawlers de IA não conseguem ler continua não gerando citação nenhuma, porque o problema estava duas camadas antes. Se o seu robots.txt bloqueia os bots de IA, ou se o conteúdo só aparece depois do JavaScript, resolva isso primeiro: o checklist de prontidão GEO mede exatamente essa camada de acesso.

A segunda armadilha é achar que marcar substitui escrever. O schema descreve o que existe; ele não melhora uma resposta ruim, só a torna mais fácil de encontrar. Se as suas respostas são vagas, marcar acelera a distribuição de conteúdo vago. A ordem certa é escrever a resposta que resolve, verificar que ela está visível na página, e só então marcar.

A terceira é inflar o FAQ para preencher a lista. Existe uma tentação óbvia de transformar cada subtítulo em pergunta até chegar a 20, e o efeito é o contrário do pretendido: dilui as três perguntas que realmente importavam. Nesta ferramenta a cobertura satura em 4 de propósito, e a partir de 20 aparece um aviso.

Por fim, FAQ envelhece rápido, mais rápido que o resto da página, porque quase sempre fala de preço, prazo e política. Bloco com preço velho é pior que bloco nenhum: você está entregando o dado errado em formato de máquina, e ele vai ser repetido com confiança. Coloque a revisão do FAQ no mesmo ritmo da revisão da tabela de preços.

Do bloco à evidência

Marcar é uma aposta sobre como terceiros tratam o seu conteúdo, e aposta sem medição vira folclore de equipe. O caminho honesto é curto:

• Registre a data em que o bloco entrou e quais perguntas estavam nele. Sem linha de base, qualquer variação depois vira interpretação livre.
• Acompanhe menção e citação, não só posição na busca. O método está no guia de GEO em 2026, e a estrutura de FAQ que mais rende citação está em FAQ para citação por IA.
• Quando a mudança também mexer na página em si, e não só no bloco invisível, meça com teste A/B antes de espalhar para o site inteiro. Reescrever o FAQ visível mexe em conversão, não só em rastreamento.

Para transformar o primeiro item da fila em hipótese testável, use o gerador de hipótese. Para dimensionar o experimento antes de ligar qualquer coisa, a calculadora de tamanho de amostra resolve em um minuto.

Perguntas frequentes

O que é o schema FAQPage?

É o tipo de dados estruturados do schema.org que declara, em formato de máquina, os pares de pergunta e resposta que já existem numa página. Ele não cria conteúdo nem muda o que o visitante vê: é uma etiqueta em JSON-LD, colada dentro de uma tag script, dizendo qual texto é pergunta e qual é a resposta aceita. A estrutura é rasa de propósito: um FAQPage contém uma lista mainEntity de Question, e cada Question carrega um name e um acceptedAnswer do tipo Answer com o campo text.

O schema FAQ ainda gera rich result no Google?

Para quase todo mundo, não. Em agosto de 2023 o Google restringiu o rich result de FAQ a sites de governo e de saúde reconhecidos, e desde então o site comum marca a página e não vê nada de diferente na SERP. Isso mudou o motivo de usar o tipo, não o valor dele: o bloco continua sendo a forma mais barata de entregar perguntas e respostas em formato de máquina para outros consumidores, que é o que interessa em busca por IA. Se o seu objetivo era ganhar espaço visual no Google, ajuste a expectativa antes de marcar.

Então por que continuar publicando FAQPage?

Por três motivos que não dependem de rich result. O primeiro é que sistemas de IA recortam respostas curtas e delimitadas com muito mais facilidade quando alguém já disse onde a resposta começa e termina. O segundo é que outros consumidores leem o mesmo bloco: buscadores menores, agregadores, assistentes e a sua própria busca interna. O terceiro é disciplina editorial: para preencher o bloco você precisa escrever uma resposta que resolve a pergunta no primeiro parágrafo, e essa é a mudança que mais rende, com ou sem marcação.

Posso marcar perguntas que não estão visíveis na página?

Não. A diretriz de dados estruturados exige que o conteúdo marcado esteja visível para o usuário na mesma página, e marcação que descreve texto ausente é motivo de ação manual. Isso vale inclusive para o caso comum de esconder o texto dentro de um acordeão fechado: acordeão tudo bem, porque o texto está no HTML e abre com um clique, mas texto que só existe dentro do JSON-LD não. É por isso que a confirmação vale 6 pontos aqui e não é enfeite.

Que HTML pode ir dentro da resposta?

Apenas h1 a h6, br, ol, ul, li, a, p, div, b, strong, i e em. Qualquer outra tag reprova na validação, e a que mais aparece é span, herdado de um copiar e colar do editor visual. Markdown também não vale: o campo é HTML, então um link escrito com colchete e parêntese vai aparecer cru na resposta. A ferramenta acusa as duas coisas, a tag proibida como perda de ponto e o link em markdown como aviso.

Quantas perguntas devo colocar no bloco?

De 4 a 10 na maioria das páginas, e no máximo 20 num bloco só. O limite de baixo é de utilidade: uma pergunta sozinha não é um FAQ, e a ferramenta satura o item de cobertura em 4. O de cima é de foco: acima de 20 a página virou central de ajuda, cada resposta perde peso relativo e fica quase impossível manter tudo atualizado. Se você tem 40 perguntas, o problema não é o schema, é que ali existem quatro páginas.

Posso ter FAQPage e outro schema na mesma página?

Sim, e é o normal. Uma página de produto costuma carregar Product mais FAQPage, e um artigo carrega Article mais FAQPage. Você pode publicar os dois blocos script separados ou juntar tudo num @graph. O que não vale é declarar duas vezes o mesmo FAQPage, o que acontece quando o plugin do CMS já injeta um bloco e alguém cola outro na mão. Antes de colar, procure application/ld+json no código-fonte da página e veja o que já está lá.

Continue

Com o bloco publicado, o próximo passo é a camada que ele não resolve: acesso do crawler, texto recortável e sinal de autoria. Leia o método completo em GEO em 2026, veja o que muda no trabalho de conversão em CRO na era da IA e o efeito de resposta pronta na tela em otimização para busca zero-click.