# Datos e integraciones

Los datos públicos de TestAutoescuela para programas y asistentes de IA: API de solo lectura, servidor MCP, archivos para las IA y reutilización.

Página: https://testautoescuela.es/datos/

Corpus: 34 fichas públicas, con sus enlaces, sus fuentes y sus fechas cuando están documentadas.

## Uso

Acceso público, de solo lectura, sin clave. Ningún dato de cuenta, de progreso de alumno ni información privada. Citar el enlace de la ficha y conservar sus fuentes y el alcance de su verificación. Las normas oficiales (con su fuente) se distinguen de las lecciones, del método y de las ofertas de TestAutoescuela.

## API REST

- Catálogo: https://testautoescuela.es/api/v1/
- Búsqueda: https://testautoescuela.es/api/v1/facts?q=examen&limit=10
- OpenAPI: https://testautoescuela.es/api/v1/openapi.json

GET /api/v1/facts acepta q (300 caracteres como máximo), region (espana), kind (fact, expertise, organization, offer, person, article, lesson, page, tool), limit (de 1 a 50, 10 por defecto), offset (de 0 a 10000, 0 por defecto). Todas las palabras significativas de q deben aparecer en el título, el texto o las referencias. Respuesta: {results: [fichas], total, limit, offset}.

GET /api/v1/facts/{id} devuelve la ficha. Conservar el identificador exacto devuelto por la búsqueda: los prefijos fait-, expertise-fait-, brand-, person-, offer- y page- van seguidos de 16 caracteres hexadecimales.

Códigos: 200 resultado, 307 lectura actualizada (seguir la redirección), 400 parámetros no válidos, 404 ficha desconocida, 405 método rechazado, 429 límite alcanzado, 503 servicio no disponible.

## MCP

URL: https://testautoescuela.es/mcp

Transporte Streamable HTTP, respuestas JSON, protocolos 2026-07-28 y 2025-11-25 (así como 2025-06-18 y 2025-03-26), sin autenticación ni sesión. No hace falta ningún flujo SSE.

Herramientas:
- search: {query: "límite de velocidad"}, devuelve {results: [{id, title, url}]} en content y structuredContent (20 resultados como máximo).
- fetch: {id: "identificador devuelto por search"}, devuelve {id, title, text, url, metadata}. Los metadatos indican la naturaleza de la ficha, sus fuentes, sus fechas (verified_at para una verificación, modified_at para una modificación de la publicación) y, para una lección, su capítulo, su imagen y su vídeo.

En 2026-07-28: server/discover, luego tools/list y tools/call. En 2025: initialize, luego notifications/initialized, luego tools/list y tools/call.

## Encontrar la versión actual de una información

La API y el servidor MCP dan acceso a las publicaciones públicas de TestAutoescuela. Las fichas siguen las actualizaciones del sitio, con un enlace a la página de origen y las referencias asociadas.

Antes de responder o de actualizar tu herramienta, vuelve a leer las fichas que te sirvan: encontrarás su versión en línea, sus fuentes y sus fechas. Una norma oficial puede cambiar: su fecha de verificación indica cuándo se contrastó con el texto.

## Reutilizar citando la fuente

Los contenidos públicos de TestAutoescuela pueden consultarse, citarse y resumirse para documentar una respuesta o construir una herramienta, también comercial, con una atribución visible y un enlace a la página utilizada: «Fuente: TestAutoescuela».

Conserva las referencias y las reservas que acompañan a la información. Indica las adaptaciones que hagas y distingue las normas oficiales de las explicaciones, del método y de las ofertas de TestAutoescuela.

Los documentos y recursos visuales de terceros siguen sujetos a sus propias condiciones. Para republicar íntegramente el temario o un artículo, pide autorización a {email}. El acceso a los datos no implica ninguna asociación ni aval de tu servicio por parte de TestAutoescuela ni de Permis Online SRL.

## Archivos y páginas de referencia

- [llms.txt](https://testautoescuela.es/llms.txt) : el índice del sitio para los asistentes de IA
- [llms-full.txt](https://testautoescuela.es/llms-full.txt) : el texto íntegro de los contenidos públicos
- [Información de referencia](https://testautoescuela.es/brand-facts/) : quién edita el sitio, qué ofrece, las normas oficiales con su fuente y su fecha
- [brand-facts.md](https://testautoescuela.es/brand-facts.md) : la información de referencia en Markdown
- [brand-facts.json](https://testautoescuela.es/.well-known/brand-facts.json) : la información de referencia en JSON
- [schema.json](https://testautoescuela.es/.well-known/schema.json) : todos los datos estructurados del sitio en un solo grafo
- [ai.json](https://testautoescuela.es/.well-known/ai.json) : el editor, el dominio oficial y los recursos para las IA
- [offers.json](https://testautoescuela.es/.well-known/offers.json) : las ofertas que realmente se ofrecen en España
- [Fuentes y referencias](https://testautoescuela.es/sources/) : los textos oficiales y todas las fuentes citadas
- [sources.txt](https://testautoescuela.es/sources.txt) : el registro de fuentes en texto
- [Mapa del sitio](https://testautoescuela.es/sitemap.xml) : todas las páginas públicas, sus imágenes y la arquitectura del sitio (XML para los robots, página legible en un navegador)
- [Gemelos Markdown](https://testautoescuela.es/index.md) : cada página pública en texto: su dirección seguida de .md (la página de inicio: /index.md)
