Generador de schema FAQ

Cómo generar el schema de FAQ

Escribe cada par una sola vez; el generador construye las dos salidas a partir de la misma lista, así que el marcado y la FAQ visible no pueden decir cosas distintas.

1. Añade tus preguntas y respuestas. Una fila por par. Redacta la pregunta como la escribiría alguien en el buscador y haz que la primera frase de la respuesta ya responda por sí sola.
2. Lee los avisos. Las filas vacías se omiten, una fila con solo pregunta o solo respuesta es un error, y se marcan las preguntas repetidas y las respuestas demasiado largas.
3. Pega el JSON-LD. Copia el bloque script en la página — en el head o en el body, funciona igual — con un único FAQPage por página.
4. Pega el HTML visible. Copia el bloque details/summary donde quieras que se lea la FAQ. Contiene exactamente el texto que declara el JSON-LD. Si más adelante cambias uno, vuelve a generar los dos.

Por qué el marcado tiene que coincidir palabra por palabra con el texto visible

El schema de FAQ son datos estructurados de tipo FAQPage — un bloque JSON-LD que enumera las preguntas y respuestas que aparecen en una página — para que los buscadores y los motores de respuesta con IA las lean como datos en lugar de deducirlas del diseño. La palabra que decide todo es aparecen. Las directrices de datos estructurados de Google exigen que el contenido marcado sea visible para quien lee la página y coincida con lo que dice el marcado. Una página cuyo JSON-LD enumera preguntas que el visitante no ve, o respuestas distintas de las visibles, incumple esas directrices y puede perder su elegibilidad para datos estructurados por una acción manual.

Casi todos los generadores se paran en el JSON-LD y te dejan la mitad visible a ti. Ahí empieza la deriva, y en el mercado español tiene una forma muy concreta: el bloque de preguntas frecuentes lo pinta la plantilla o un plugin, el JSON-LD lo escribe otro plugin distinto, alguien retoca el texto en el editor de WordPress y nadie vuelve a tocar el marcado. Seis meses después el JSON-LD describe una página que ya no existe. Este generador escribe el HTML visible y el JSON-LD desde la misma lista y en la misma pasada — el texto del <summary> es el name, el del <p> es el acceptedAnswer.text, carácter a carácter. Vuelve a generar los dos siempre que cambies uno y no podrán contradecirse.

La regla no es solo cumplimiento. Los motores de respuesta con IA se llevan la frase visible, y quien llega a la página desde esa cita espera encontrarla allí. Una sola fuente para las dos caras es la manera de asegurarte de que la encuentra.

Para qué sirve hoy el schema de FAQ, sin adornos

En agosto de 2023 Google limitó los resultados enriquecidos de FAQ en la Búsqueda a sitios reconocidos y con autoridad de gobierno y de salud. Para todos los demás, el desplegable de preguntas bajo el resultado desapareció, y cualquier herramienta que siga prometiéndolo está describiendo 2022. ¿Entonces para qué marcar una FAQ?

• La FAQ visible posiciona. Una pregunta redactada como se busca y respondida en una frase limpia es una sección de página que puede posicionar por sí sola y que una IA puede citar. El marcado es la copia legible por máquinas de esa sección, no el motivo por el que posiciona.
• Los datos estructurados se siguen leyendo. Google procesa el marcado FAQPage aunque no muestre ningún resultado enriquecido, y otros consumidores — Bing, los motores de respuesta, tus propios agentes — lo usan como vía limpia de extracción.
• La disciplina se paga en otro sitio. Escribir la pregunta como consulta y la respuesta como frase independiente es exactamente lo que hace que a una página la citen en las respuestas de IA, con JSON-LD o sin él.

Lo que no debes esperar: una subida de posiciones por el marcado en sí, ni un resultado enriquecido en una web comercial. Úsalo porque la página tiene una FAQ de verdad y quieres que sus dos caras digan lo mismo.

Preguntas y respuestas que acaban citadas

• No traduzcas las preguntas del inglés. En español se busca cuánto tarda el envío, no tiempos de entrega; se busca cómo dar de baja, no cancelación de suscripción. Coge la pregunta del buscador o del correo de un cliente, no del glosario de la empresa.
• Redáctala como la escribe una persona. ¿Cómo puedo…?, ¿Cuánto cuesta…?, ¿Es obligatorio…? — tal cual se teclea, no como un titular de sección.
• Responde entero en la primera frase. Los extractores se llevan la frase inicial; el resto es detalle de apoyo.
• Que cada frase se sostenga sola. Nada de eso, lo anterior o como hemos dicho: una frase citada pierde a sus vecinas.
• Una idea por par. Una pregunta que necesita tres respuestas son tres preguntas.
• Datos antes que adjetivos. Las cifras con fuente se citan; los superlativos no.
• Solo preguntas que alguien hace. Una FAQ no es el sitio donde esconder un argumento de venta detrás de un signo de interrogación.

Dónde va cada bloque

El JSON-LD puede ir en cualquier punto de la página, dentro de <script type="application/ld+json"> — head o body, Google lee los dos. Usa un único bloque FAQPage por página y no repitas las mismas preguntas en varias URL: el marcado describe la página en la que está. El bloque visible va donde se deba leer la FAQ; <details>/<summary> se pliega y despliega sin una línea de JavaScript y se queda en el HTML para los rastreadores. Si trabajas con WordPress, pega el JSON-LD en un bloque HTML personalizado y el bloque visible en el contenido: no hace falta ningún plugin, y así los dos salen del mismo sitio.

Cuando lo tengas puesto, compruébalo con la Prueba de resultados enriquecidos de Google o con el validador de schema.org: te dirán si el bloque se interpreta como FAQPage, aunque no vayas a ver el resultado enriquecido. Y ten presente que FAQPage es para las preguntas que hace y responde el propio sitio: una página donde los visitantes publican preguntas y otros contestan — un hilo de foro, una comunidad de soporte — es una QAPage, otro tipo distinto.

El JSON-LD solo describe lo que hay en esta página. Las versiones por idioma se declaran aparte con el generador de etiquetas hreflang, y el índice que lee un agente se revisa con el validador de llms.txt — los dos construidos con la misma regla que esta página: una fuente, dos salidas, cero deriva.

$ npm i -g @clize/clize && clize install
$ clize seo check --domain tudominio.es