Añade schema Speakable a bloques Preguntas frecuentes para más citas de motores IA
Speakable envuelve párrafos de respuesta clave y señaliza a los motores IA "extrae esto para voz y respuestas directas." Poco usado en crypto, gran impacto AEO cuando se añade. Tarea de 5 minutos con un lift del 30-50% en tasa de citas.
Por qué importa esto
- →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 Preguntas frecuentes 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 (cómo se ve lo malo)
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Preguntas frecuentesPage",
"mainEntity": [
{
"@type": "Question",
"name": "Is Aave safe to use?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Aave has been audited 12+ times..."
}
}
]
}
</script>Paso a paso
Paso 1: Identifica páginas con bloques Preguntas frecuentes existentes
Lista todas las páginas con schema Preguntas frecuentes (tipo Preguntas frecuentesPage). Usa Crawlux Auditoría de Schema de Token o grep en tu sitio por "@type": "Preguntas frecuentesPage". Las guías pilar, páginas de comparación, páginas de protocolo típicamente tienen bloques Preguntas frecuentes ya. Estas son tus páginas objetivo.
grep -rn '"@type": "Preguntas frecuentesPage"' your-site/Paso 2: Añade selectores CSS que envuelvan tus respuestas Preguntas frecuentes
Speakable usa cssSelector para identificar qué elementos DOM contienen el contenido "extrae esto". Añade una clase a tus divs de respuesta Preguntas frecuentes (ej., class="faq-answer") y a tu callout de respuesta rápida (ej., class="quick-answer"). Ambos se convierten en objetivos 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>Paso 3: Añade especificación Speakable al schema Preguntas frecuentesPage
Añade la propiedad speakable a tu schema Preguntas frecuentesPage existente. Usa SpeakableSpecification con cssSelector apuntando a tu clase de respuesta Preguntas frecuentes más cualquier otra sección clave de respuesta (callouts de respuesta rápida, cajas de resumen).
"speakable": {
"@type": "SpeakableSpecification",
"cssSelector": [".faq-answer", ".quick-answer", ".key-takeaway"]
}Paso 4: Opcional: usa xpath en lugar del selector CSS
Si tus selectores CSS no son confiables, usa xpath en su lugar. cssSelector es más simple y funciona para la mayoría de casos. Usa uno u otro, no ambos.
"speakable": {
"@type": "SpeakableSpecification",
"xpath": ["//div[@class='faq-answer']"]
}Paso 5: Valida contra Schema.org Validator
Corre validator.schema.org en tu página actualizada. Speakable debería validar limpiamente sin warnings. Google Rich Resultados Test no mostrará Speakable como un tipo primario de rich result pero eso está bien; el consumidor principal de Speakable son los motores IA y asistentes de voz, no los rich results de Google.
Paso 6: Despliega y prueba la tasa de citas AEO
Pushea a producción. Dos semanas después, corre tus top 10 consultas en ChatGPT, Perplexity y Claude. Anota qué respuestas citan tu sitio. Compara con la tasa de citas base antes de Speakable. La mayoría de sitios ven 30-50% de lift en tasa de citas en 30 días.
FREE WEB3 AUDIT
Mira dónde aplica este playbook en tu sitio.
Corre una auditoría Crawlux gratis antes de empezar el playbook. Te dice qué correcciones son más urgentes.
Primera auditoría gratis · Sin registro · 60 segundos · Full PDF report
Estado posterior (cómo se ve lo bueno)
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Preguntas frecuentesPage",
"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>Cómo validar la corrección
- ✓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 Preguntas frecuentes answers. Voice answer should pull from the Speakable-wrapped section.
Errores comunes
Pitfall
Añadir Speakable sin Preguntas frecuentesPage
Speakable puede añadirse a Article u otros tipos pero funciona mejor emparejado con Preguntas frecuentesPage. Si tu página no tiene Preguntas frecuentesPage todavía, añádelo primero. Speakable en una página HTML pelada hace poco.
Pitfall
Selector CSS que no existe
Si cssSelector apunta a .faq-answer pero tu DOM usa .accordion-content, Speakable se resuelve a nada. Siempre valida que el selector realmente coincida con elementos DOM.
Pitfall
Apuntar Speakable a la página entera
No uses cssSelector: ["body"] o selectores amplios similares. Speakable debería apuntar a elementos específicos que contienen respuestas. Los selectores amplios son ignorados por los parsers.
Pitfall
Speakable en páginas sin buenas respuestas
Speakable amplifica lo que está en la página. Si tus respuestas son vagas o impulsadas por marketing, Speakable amplifica la vaguedad. Asegúrate de que las respuestas Preguntas frecuentes sean concretas antes de añadir Speakable.
Pitfall
Olvidar actualizar Speakable cuando el contenido cambia
Si rediseñas tu bloque Preguntas frecuentes y cambias los nombres de clase, actualiza el cssSelector de Speakable. Los selectores obsoletos se vuelven invisibles.
Si algo se rompe: rollback
Elimina la propiedad speakable del schema Preguntas frecuentesPage. La página vuelve al comportamiento regular de Preguntas frecuentesPage en minutos. La tasa de citas puede regresar pero sin riesgo a la funcionalidad del sitio.
Corre una auditoría Crawlux gratis sobre esta corrección
Crawlux valida las correcciones de schema, técnicas y AEO de este playbook automáticamente. Plan gratis en un dominio.
Ejecutar auditoría gratuita →Preguntas frecuentes
¿Funciona Speakable fuera de Preguntas frecuentesPage?
Sí. Speakable puede añadirse a Article, BlogPosting, NewsArticle y la mayoría de tipos de schema. El patrón es el mismo: SpeakableSpecification con cssSelector o xpath apuntando a las secciones más citables de la página.
¿Afectará Speakable a los rich results de Google?
Speakable no está en los tipos primarios de rich results de Google todavía pero es parseado y usado para respuestas de voz. El beneficiario principal son los motores IA (ChatGPT, Perplexity, Claude) que ponderan el contenido marcado como Speakable más alto para citas.
¿Puedo usar Speakable para copy de marketing?
Técnicamente sí pero contraproduce. Los motores IA extraen el contenido Speakable verbatim. Si tu copy de marketing es promocional, los motores IA pueden extraerlo pero marcarlo como sesgado. Usa Speakable para respuestas factuales, no claims de marketing.
¿Qué tan específico debería ser cssSelector?
Lo suficientemente específico para coincidir solo con los elementos que contienen respuestas. .faq-answer es bueno. .content es demasiado amplio. Usa nombres de clase dedicados a las secciones de respuesta, no clases de contenido genéricas.
¿Tiene Speakable un límite de longitud?
Sin límite formal pero el límite práctico es 1-3 oraciones por sección Speakable. Los motores IA las extraen como respuestas directas; más de 3 oraciones típicamente se trunca. Optimiza las respuestas a 1-3 oraciones para mejor extracción.
Playbooks relacionados
Guías pilares
Módulos de auditoría
RUN YOUR FIRST AUDIT
Corre el playbook contra una auditoría real.
Recibe un reporte de auditoría Crawlux gratis y úsalo como línea base para el trabajo en este playbook.
Primera auditoría gratis · Sin registro · 60 segundos · Full PDF report