Adicione schema Speakable a blocos de FAQ para mais citações de motores IA
Speakable envolve parágrafos de resposta chave e sinaliza aos motores IA "extraia isso para voz e respostas diretas." Pouco usado em crypto, grande impacto AEO quando adicionado. Tarefa de 5 minutos com um lift de 30-50% na taxa de citações.
Por que isso importa
- →AI engines (ChatGPT, Perplexity, Claude) parse JSON-LD heavily for retrieval. Speakable explicitly marks the most-quotable sections.
- →Across TG3 client work, sites with Speakable schema on FAQ blocks see 30-50% higher AEO citation rates within 30 days.
- →Voice search is a smaller but real channel. Google Assistant uses Speakable for voice answers.
- →5-minute task. The ROI math is absurd compared to other SEO work.
Estado anterior (como o ruim se parece)
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Is Aave safe to use?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Aave has been audited 12+ times..."
}
}
]
}
</script>Passo a passo
Passo 1: Identifique páginas com blocos de FAQ existentes
Liste todas as páginas com schema FAQ (tipo FAQPage). Use a Auditoria de Schema de Token da Crawlux ou grep no seu site por "@type": "FAQPage". As guias pilar, páginas de comparação, páginas de protocolo tipicamente já têm blocos de FAQ. Essas são suas páginas alvo.
grep -rn '"@type": "FAQPage"' your-site/Passo 2: Adicione seletores CSS que envolvam suas respostas de FAQ
Speakable usa cssSelector para identificar quais elementos DOM contêm o conteúdo "extraia isso". Adicione uma classe aos seus divs de resposta de FAQ (ex., class="faq-answer") e ao seu callout de resposta rápida (ex., class="quick-answer"). Os dois se tornam alvos Speakable.
<div class="quick-answer">
Aave is a DeFi lending protocol audited 12+ times with $11.2B TVL.
</div>
<div class="faq-item">
<h3>Is Aave safe to use?</h3>
<div class="faq-answer">Aave has been audited 12+ times by leading firms...</div>
</div>Passo 3: Adicione especificação Speakable ao schema FAQPage
Adicione a propriedade speakable ao seu schema FAQPage existente. Use SpeakableSpecification com cssSelector apontando para sua classe de resposta de FAQ mais qualquer outra seção chave de resposta (callouts de resposta rápida, caixas de resumo).
"speakable": {
"@type": "SpeakableSpecification",
"cssSelector": [".faq-answer", ".quick-answer", ".key-takeaway"]
}Passo 4: Opcional: use xpath no lugar do seletor CSS
Se seus seletores CSS não são confiáveis, use xpath no lugar. cssSelector é mais simples e funciona para a maioria dos casos. Use um ou outro, não os dois.
"speakable": {
"@type": "SpeakableSpecification",
"xpath": ["//div[@class='faq-answer']"]
}Passo 5: Valide contra o Schema.org Validator
Rode validator.schema.org na sua página atualizada. Speakable deve validar de forma limpa sem warnings. O Google Rich Results Test não mostrará Speakable como um tipo primário de rich result, porém tudo bem; o consumidor principal de Speakable são os motores IA e assistentes de voz, não os rich results do Google.
Passo 6: Faça deploy e teste a taxa de citações AEO
Faça push para produção. Duas semanas depois, rode suas top 10 consultas em ChatGPT, Perplexity e Claude. Anote quais respostas citam seu site. Compare com a taxa de citações base antes de Speakable. A maioria dos sites vê 30-50% de lift na taxa de citações em 30 dias.
FREE WEB3 AUDIT
Veja onde esse playbook se aplica no seu site.
Rode uma auditoria Crawlux grátis antes de começar o playbook. Diz quais correções são mais urgentes.
Primeira auditoria grátis · Sem cadastro · 60 segundos · Full PDF report
Estado posterior (como o bom se parece)
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"speakable": {
"@type": "SpeakableSpecification",
"cssSelector": [".faq-answer", ".quick-answer"]
},
"mainEntity": [
{
"@type": "Question",
"name": "Is Aave safe to use?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Aave has been audited 12+ times..."
}
}
]
}
</script>Como validar a correção
- ✓Schema.org Validator: 0 errors on the speakable property.
- ✓DOM check: every cssSelector in speakable resolves to actual DOM elements on the page.
- ✓AEO baseline test: capture citation rate before deploy across top 10 queries.
- ✓AEO post-deploy test: run same 10 queries 14 days after deploy. Expect 30-50% lift in citation count.
- ✓Voice test: ask Google Assistant a question your FAQ answers. Voice answer should pull from the Speakable-wrapped section.
Erros comuns
Pitfall
Adicionar Speakable sem FAQPage
Speakable pode ser adicionado a Article ou outros tipos, porém funciona melhor emparelhado com FAQPage. Se sua página ainda não tem FAQPage, adicione-o primeiro. Speakable em uma página HTML pelada faz pouco.
Pitfall
Seletor CSS que não existe
Se cssSelector aponta para .faq-answer, porém seu DOM usa .accordion-content, Speakable se resolve a nada. Sempre valide que o seletor realmente coincida com elementos DOM.
Pitfall
Apontar Speakable para a página inteira
Não use cssSelector: ["body"] ou seletores amplos similares. Speakable deve apontar para elementos específicos que contêm respostas. Os seletores amplos são ignorados pelos parsers.
Pitfall
Speakable em páginas sem boas respostas
Speakable amplifica o que está na página. Se suas respostas são vagas ou movidas por marketing, Speakable amplifica a vagueza. Certifique-se de que as respostas de FAQ sejam concretas antes de adicionar Speakable.
Pitfall
Esquecer de atualizar Speakable quando o conteúdo muda
Se você redesenha seu bloco de FAQ e muda os nomes de classe, atualize o cssSelector de Speakable. Os seletores obsoletos se tornam invisíveis.
Si algo se rompe: rollback
Remova a propriedade speakable do schema FAQPage. A página volta ao comportamento regular de FAQPage em minutos. A taxa de citações pode regredir, porém sem risco à funcionalidade do site.
Rode uma auditoria Crawlux grátis sobre essa correção
Crawlux valida as correções de schema, técnicas e AEO desse playbook automaticamente. Plano grátis em um domínio.
Executar auditoria gratuita →FAQ
Speakable funciona fora de FAQPage?
Sim. Speakable pode ser adicionado a Article, BlogPosting, NewsArticle e a maioria dos tipos de schema. O padrão é o mesmo: SpeakableSpecification com cssSelector ou xpath apontando para as seções mais citáveis da página.
Speakable afetará os rich results do Google?
Speakable ainda não está nos tipos primários de rich results do Google, porém é parseado e usado para respostas de voz. O beneficiário principal são os motores IA (ChatGPT, Perplexity, Claude) que ponderam o conteúdo marcado como Speakable mais alto para citações.
Posso usar Speakable para copy de marketing?
Tecnicamente sim, porém é contraproducente. Os motores IA extraem o conteúdo Speakable verbatim. Se seu copy de marketing é promocional, os motores IA podem extraí-lo, porém marcá-lo como enviesado. Use Speakable para respostas factuais, não claims de marketing.
Quão específico o cssSelector deve ser?
Específico o suficiente para coincidir apenas com os elementos que contêm respostas. .faq-answer é bom. .content é amplo demais. Use nomes de classe dedicados às seções de resposta, não classes de conteúdo genéricas.
Speakable tem um limite de comprimento?
Sem limite formal, porém o limite prático é 1-3 frases por seção Speakable. Os motores IA as extraem como respostas diretas; mais de 3 frases tipicamente é truncado. Otimize as respostas para 1-3 frases para melhor extração.
Playbooks relacionados
Guias pilares
Módulos de auditoria
RUN YOUR FIRST AUDIT
Rode o playbook contra uma auditoria real.
Receba um relatório de auditoria Crawlux grátis e use-o como linha base para o trabalho nesse playbook.
Primeira auditoria grátis · Sem cadastro · 60 segundos · Full PDF report