# Generador de FAQ schema

> Pegá un borrador o escribí tus preguntas y llevate el JSON-LD de FAQPage, con las advertencias que importan. Gratis, sin registro.

Pegá un borrador en Markdown con su sección de preguntas frecuentes, o escribí los pares a mano. El generador lee las preguntas con sus respuestas y escribe el JSON-LD de FAQPage. Copiá la etiqueta script en la página que muestra esas respuestas.

Page: https://seodraft.app/es/tools/faq-schema-generator

## Usala desde tu agente

El control de esta página también es un endpoint JSON y una herramienta en un servidor MCP público. Ninguno pide cuenta ni clave.

### Endpoint JSON

```http
POST https://seodraft.app/api/tools/faq-schema-generator
content-type: application/json

{
  "markdown": "## FAQ\n\n### Does seodraft publish the article?\n\nNo. It writes a draft into your repository and you publish from your CMS.\n\n### How many questions does a page need?\n\nThe ones it answers, from two up.\n",
  "pageUrl": "https://example.com/blog/faq-schema"
}
```

Limits: 20 calls per minute per IP. Over a limit the answer is 429 with Retry-After.

### Servidor MCP gratis

Agregá esta URL en Claude, ChatGPT, Cursor o cualquier cliente MCP. Expone todas las herramientas gratis, sin iniciar sesión.

- URL: https://seodraft.app/tools/mcp
- Tool: `generate_faq_schema`

Builds FAQPage JSON-LD from a Markdown draft or from a list of question and answer pairs. Send markdown, faqs, or both; an explicit faqs list is used instead of detection. In Markdown it reads an FAQ section first (a heading named FAQ, Frequently asked questions, Questions, Preguntas frecuentes and the like), where the child headings are the questions and the text up to the next heading of the same level or higher is the answer; with no such section, every heading that ends in a question mark is a question. Answers come back as plain text (links keep their words, images, code fences, HTML tags and emphasis markers are removed), capped at 50 questions and 2000 characters per answer. Returns faqs (the pairs the markup carries), jsonLd (@graph with FAQPage, plus BlogPosting when article is given), script (the whole <script type="application/ld+json"> block with < escaped as \u003c) and warnings, each with a code and a severity: no-questions and too-few-questions (under two) describe the set; empty-answer and duplicate-question name entries that were left out; question-not-question, answer-has-html and faq-rich-results-restricted are info. Nothing is fetched: pageUrl is only written into @id and url.

## Qué hace el marcado FAQPage

El marcado FAQPage nombra las preguntas que responde una página y la respuesta de cada una, en un JSON que una máquina lee sin interpretar tu maquetado.

Google achicó el resultado enriquecido en agosto de 2023. Las preguntas desplegables debajo de un resultado hoy aparecen en sitios conocidos de gobierno y de salud. El marcado sigue describiendo la página para los buscadores y para los asistentes que citan páginas en sus respuestas.

La regla que sigue en pie es la visibilidad: cada pregunta y cada respuesta del marcado tienen que estar en la página donde cae quien lee.

## Cómo lee tu borrador este generador

Primero busca una sección de preguntas frecuentes. Un título llamado FAQ, Preguntas frecuentes, Preguntas o Frequently asked questions abre el bloque; los títulos que cuelgan de él son las preguntas, y el texto hasta el siguiente título del mismo nivel es la respuesta.

Si el borrador no tiene esa sección, cualquier título que termine en signo de pregunta pasa a ser una pregunta y los párrafos que siguen son su respuesta.

El Markdown sale como texto plano. Un enlace conserva sus palabras y pierde la URL; las imágenes, los bloques de código y los asteriscos de énfasis se van.

Escribir los pares a mano manda por encima de la detección, y así marcás una página cuyo borrador ya no tenés.

## Qué significa cada advertencia

no-questions dice que el borrador no dejó nada para marcar, casi siempre porque las preguntas están en negrita y no como títulos.

too-few-questions cuenta un solo par. empty-answer y duplicate-question nombran las entradas que quedaron fuera del JSON, porque una respuesta sin texto y una pregunta repetida hacen que el marcado no coincida con la página.

question-not-question marca un name que se lee como un tema, por ejemplo "Precios". El name de un Question es la frase que escribe una persona, así que escribila así.

answer-has-html informa las etiquetas que se sacaron. faq-rich-results-restricted repite lo que cambió Google en 2023, para que nadie publique este marcado esperando estrellitas.

## Qué te deja a vos el generador

Lee el texto que pegás y nada más. La URL de la página se escribe en @id y en url; no se descarga ninguna página.

Toma hasta 50 preguntas y corta una respuesta en 2000 caracteres, sobre una palabra.

Pegá la etiqueta en el head o en el body de la página que muestra esas respuestas, y después pasá la URL por el Test de resultados enriquecidos de Google para ver el marcado como lo lee Google.

## Preguntas

### ¿El FAQ schema todavía da resultados enriquecidos?

Los reciben los sitios conocidos de gobierno y de salud. Google restringió el resultado enriquecido de FAQ en agosto de 2023 y el marcado volvió a ser lo que siempre fue por debajo: una descripción de la página que leen los buscadores y los motores de respuesta.

### ¿Cuántas preguntas conviene marcar?

Las que responde la página, de dos para arriba. Con una sola, el FAQPage describe un único intercambio y la página casi siempre tiene más para decir. Las reglas de seodraft le piden tres a un borrador.

### ¿Una respuesta puede llevar enlaces o HTML?

La documentación de FAQPage de Google acepta algunas etiquetas HTML dentro de una respuesta. Este generador las saca y escribe texto plano, y así el JSON queda válido venga como venga el borrador. Los enlaces quedan en el cuerpo de la página, que es donde alguien hace clic.

### ¿Dónde va la etiqueta script?

En cualquier parte de la página que muestra esas preguntas, head o body. Lo que importa es la página: quien cae ahí tiene que ver las mismas preguntas y respuestas.

### ¿Mi borrador sale del navegador?

No. El generador de esta página corre en tu navegador y no manda nada. El endpoint JSON que está al lado es para los agentes, y tampoco guarda nada.

## El proceso completo corre en seodraft

En seodraft las FAQ son un campo del borrador y no un agregado al final: las reglas piden tres antes de aprobar un artículo, y el Markdown que se entrega a tu repositorio las lleva para que el sitio las muestre.

MCP: https://seodraft.app/mcp