Catálogo de fuentes públicas de España

Administración fuentes públicas

Spanish public-sector data sources, catalogued for AI agents and developers: verified endpoints, response shapes, pitfalls, and recipes. Start at llms.txt.

Catálogo de fuentes de datos de la Administración pública española para desarrolladores y agentes de IA: qué hay, dónde está, cómo se llama, qué devuelve y qué falla. Cada endpoint se prueba con una llamada real y cada trampa lleva la fecha en que se comprobó.

Empieza aquí

• Agente con MCP (Claude, Cursor y cualquier cliente MCP): uvx --from git+https://github.com/BquantFinance/Administracion-fuentes-publicas mcp-catalogo, o . Carga solo la ficha que hace falta (guía).
• Agente sin MCP: llms-min.txt (7 KB) o llms.txt; todo el catálogo en catalog.json o llms-full.txt.
• Código: cargadores en Python que ya resuelven las trampas en scripts/clientes/ (BOE y BORME, BDNS, AEMET, INE, PLACSP, DataComex, Saiku), probados contra respuestas reales.

Lo que no dice la documentación oficial

Algunos ejemplos, verificados con llamadas reales:

• La API del BOE responde 400 si no envías Accept: application/json, y la forma del sumario cambia según el día.
• La exportación de la BDNS devuelve 50 filas aunque haya miles si no pasas pageSize, y no avisa.
• Para filtrar un municipio, el INE no quiere su código (02001) sino un Id interno (6124).
• Muchos servidores .gob.es envían el certificado FNMT sin la intermedia: el navegador entra, curl y requests fallan (arreglo).
• AEMET responde en dos pasos, con el fichero en ISO-8859-15 y los errores dentro de un HTTP 200.
• En SIGPAC el municipio es el código del Catastro, no el del INE: un punto de la Puerta del Sol devuelve 28:900, no 28079.
• Los CSV de los portales PC-Axis de Educación, Cultura e Interior llegan en UTF-8 aunque la cabecera diga ISO-8859-15; leídos como Latin-1 salen «autónoma».

Fuentes catalogadas: 95. Alcance actual: Administración General del Estado y, desde octubre de 2026, las cuatro comunidades más pobladas (Madrid, Cataluña, Andalucía y Comunitat Valenciana) y los ayuntamientos de Madrid y Barcelona. Después: resto de comunidades y entidades locales, Cortes y Poder Judicial, Unión Europea.

Principios

• Una ficha por fuente, en YAML, con campos fijos validados contra un esquema. Sin prosa de relleno: cada línea ahorra una búsqueda.
• Fuente única de verdad. Solo se editan sources/**/*.yaml. Índices, catalog.json y llms*.txt se generan.
• Lo que no dice la documentación oficial. El campo gotchas recoge los detalles que hacen perder horas: cabeceras obligatorias, codificaciones raras, límites no documentados, URLs que cambian.
• Verificación explícita. verified lleva la fecha de la última prueba real del endpoint, o null. Un job semanal comprueba que las URLs siguen respondiendo.
• Top-down. Se cubren primero las fuentes de mayor uso e impacto, sector a sector, hasta cubrirlo todo.

Sectores

sector	descripción	fuentes
legislacion-boletines	Legislación y boletines oficiales	5
economia-finanzas	Economía, finanzas y mercados	5
hacienda-presupuestos	Hacienda, tributos y presupuestos	6
estadistica	Estadística oficial	7
contratacion-subvenciones	Contratación pública y subvenciones	3
empleo-seguridad-social	Empleo y Seguridad Social	3
gobierno-abierto-administracion	Gobierno abierto, transparencia y organización administrativa	11
territorio-cartografia	Territorio, catastro y cartografía	4
meteorologia-clima	Meteorología y clima	2
medio-ambiente-agua-biodiversidad	Medio ambiente, agua y biodiversidad	5
energia	Energía	5
sanidad-medicamentos	Sanidad y medicamentos	5
ciencia-investigacion	Ciencia e investigación (biología, química, geología, oceanografía)	7
agricultura-pesca-alimentacion	Agricultura, pesca y alimentación	4
transporte-movilidad	Transporte y movilidad	7
comercio-industria-propiedad	Comercio exterior, industria y propiedad industrial	4
educacion-universidades	Educación y universidades	2
justicia-interior-seguridad	Justicia, interior y seguridad	1
cultura-patrimonio	Cultura y patrimonio	2
demografia-migraciones-sociedad	Demografía, migraciones y sociedad	4
vivienda-urbanismo	Vivienda y urbanismo	1
telecomunicaciones-digital	Telecomunicaciones y sociedad digital	1
exterior-cooperacion	Acción exterior y cooperación	0
consumo-seguridad-alimentaria	Consumo y seguridad alimentaria	1
defensa	Defensa	0

Estructura

sources/<sector>/<id>.yaml   fichas (fuente de verdad)
sources/<sector>/README.md   índice del sector (generado)
schema/source.schema.json    esquema de ficha
schema/vocab.yaml            vocabulario controlado: sectores, acceso, auth, formatos
catalog.json                 todo el catálogo (generado)
llms.txt / llms-full.txt     entrada para agentes (generado)
indices/*.yaml               recetas por intención, necesidades, identificadores, códigos que son parámetros, rutas muertas (fuente de verdad)
indices/README.md            los cinco índices en texto (generado)
scripts/                     validate.py, build.py, check_links.py, check_recetas.py, check_ejemplos.py, fnmt_bundle.py, mcp_catalogo.py (servidor MCP local)
scripts/clientes/            cargadores en Python que resuelven las trampas (BOE y BORME, BDNS, AEMET, INE, PLACSP, DataComex, Saiku)
scripts/clientes/muestras/   respuestas reales recortadas para probar los parsers sin red (python scripts/test_clientes.py)
evals/                       20 tareas con respuesta esperada para medir lo que aporta el repo a un agente
templates/source.yaml        plantilla de ficha
guides/                      guías transversales (identificadores para cruzar datasets, etc.)

Uso rápido

# Todo el catálogo
curl -s https://raw.githubusercontent.com/BquantFinance/Administracion-fuentes-publicas/main/catalog.json

# Fuentes de un sector con API REST y sin autenticación
curl -s .../catalog.json | jq '.sources[] | select(.sector=="economia-finanzas" and (.access|index("api-rest")) and .auth=="none") | .id'

Índices para agentes

Además de las fichas, indices/ responde a las preguntas que se hacen antes de elegir una fuente:

• Recetas por intención: procedimientos verificados que encadenan fichas (de un NIF a sus subvenciones y contratos, de unas coordenadas a la referencia catastral, del sumario del BOE al texto consolidado). Cada receta lleva comprobaciones que python scripts/check_recetas.py ejecuta contra los servidores reales.
• Dónde está cada cosa: necesidades habituales con la ficha que las resuelve y la nota que evita el desvío típico.
• Identificadores: los códigos que cruzan datasets, con regex, ejemplo, emisor y vías verificadas de conversión.
• Códigos que son parámetros: valores que las APIs exigen y no se adivinan (Id del INE para tv, países de DataComex, estación de AEMET por capital, productos de carburantes, rangos del BOE), obtenidos con llamadas reales.
• Rutas muertas: URLs de documentación antigua que ya no sirven y su sustituta.

Medido (evals/): en diez tareas resueltas por el mismo agente con y sin catálogo (dos modelos), el acierto fue el mismo; con catálogo, en las tareas difíciles las llamadas HTTP y los pasos del agente bajan a la mitad y las fallidas casi a cero. El consumo de tokens está pendiente de medir bien: las dos primeras tandas registraron el contexto final de cada agente, no los tokens procesados en todos sus turnos.

Todo en indices/README.md y, para consumo programático, bajo la clave indices de catalog.json. Cada endpoint principal de una ficha lleva example (llamada copiable) y returns (forma de la respuesta vista en esa llamada). python scripts/mcp_catalogo.py expone el catálogo por MCP en local para cargar solo lo necesario (guía).

Contribuir

Lee CONTRIBUTING.md. Resumen: copia templates/source.yaml, rellena, ejecuta python scripts/validate.py && python scripts/build.py, abre un PR.

Licencia

Catálogo y documentación: CC0 1.0. Los datos a los que apuntan las fichas tienen cada uno su propia licencia, indicada en el campo license.