Skip to main content
Glama
catalogo-fuentes-publicas

catalogo-fuentes-publicas

Administración fuentes públicas

CI Licencia CC0 Apoya en Ko-fi

Spanish public data, ready to build products on: where each dataset lives, how to call it, what it returns and the traps that change the numbers, verified with real calls; plus code that fetches it already solved. Start at llms-min.txt or the MCP server.

Datos públicos de España listos para construir productos. Para cada fuente: dónde está, cómo pedirla, qué devuelve y qué falla, comprobado con llamadas reales, y código que ya trae el dato resuelto. Pensado para startups, desarrolladores y agentes de IA.

Empieza aquí

  • Con un agente (MCP): uvx --from git+https://github.com/BquantFinance/Administracion-fuentes-publicas mcp-catalogo, Instalar en Cursor, o en Claude Code /plugin marketplace add BquantFinance/Administracion-fuentes-publicas y /plugin install fuentes-publicas@fuentes-publicas. buscar encuentra la fuente, ficha da endpoints y trampas, y perfil_municipio, coyuntura, empresa_nif y el resto traen el dato (herramientas).

  • Con código: pip install "fuentes-publicas-mcp @ git+https://github.com/BquantFinance/Administracion-fuentes-publicas". Clientes que ya resuelven certificados, codificaciones y paginación (scripts/clientes), un almacén local en Parquet para lo que las APIs no dejan consultar (guía) y ejemplos que funcionan.

  • Leyendo: llms-min.txt para orientarse y la ficha de cada fuente en sources/.

Related MCP server: Asiento Uno

Qué puedes construir hoy

Cada producto con piezas que ya funcionan; frescura, volumen medido, licencia y la trampa que más cuesta en indices/productos.yaml. Antes de vender: licencias, cita y datos personales.

producto

para quién

fichas

piezas

radar-licitaciones · Avisos de licitaciones nuevas por CPV, provincia u órgano de contratación

pymes y consultoras que licitan con la Administración

placsp-datos-abiertos, dir3-directorio

fuentes-radar con ejemplos/radar/ (aviso diario en GitHub Actions: issue, RSS y JSON; CPV, NUTS, importe y palabras); almacen.py sync --fuentes placsp para histórico y búsquedas

inteligencia-competidores · Quién gana los contratos de un sector u órgano, a qué importe y contra cuántas ofertas

empresas que licitan, analistas de contratación pública, periodistas

placsp-datos-abiertos

almacen.py (tabla placsp_adjudicaciones y vista adjudicaciones_ultimo); ejemplos/adjudicaciones.py; herramienta almacen_sql

radar-ayudas · Convocatorias de subvenciones nuevas que encajan con el perfil de una empresa (sector, región, tipo de beneficiario)

pymes, gestorías y consultoras de financiación pública

bdns-api, boe-api-sumario

fuentes-radar con ejemplos/radar/ (convocatorias nuevas por palabras y nivel, aviso diario); scripts/clientes/bdns.py (convocatorias y concesiones paginadas, altas por fecha de alta)

kyb-proveedores · Ficha de riesgo de un proveedor o cliente por NIF (ayudas, contratos, actos mercantiles, prohibiciones de contratar)

departamentos de compras, fintech de crédito, compliance

bdns-api, placsp-datos-abiertos, borme-api-sumario, hacienda-registro-licitadores

herramienta empresa_nif (por NIF o por nombre, que resuelve el NIF con el directorio de la BDNS) y ejemplos/empresa_nif.py; con almacén local añade contratos adjudicados y actos del BORME

leads-sociedades-nuevas · Sociedades recién constituidas por provincia y objeto social, con capital y domicilio

proveedores B2B (asesorías, bancos, software de gestión, seguros)

borme-api-sumario

fuentes-radar con ejemplos/radar/ (constituciones por provincia, objeto social y capital, aviso diario); almacen.py sync --fuentes borme para el histórico; empresa_nif con la denominación para el NIF

informe-ubicacion · Informe de una localización (población, renta, paro, vivienda, criminalidad y colegios, salud y recarga a 1 km) para inmobiliarias, retail y franquicias

inmobiliarias, cadenas de retail y franquicias, proptech

ine-api-tempus, sepe-estadisticas, interior-criminalidad, mivau-precios-vivienda-alquiler, catastro-ovc, centros-docentes-ccaa, centros-sanitarios-ccaa, dgt-datex-trafico

herramienta perfil_municipio con el municipio, una dirección o «lat,lon» (CP, referencia catastral del portal y, con dirección, el bloque cerca) y ejemplos/mi_municipio.py; datos/municipios.csv para pasar entre códigos

comparador-carburantes · Gasolineras más baratas cerca y evolución de precios por estación para conductores y flotas

apps de movilidad, gestores de flotas, comparadores

minetur-precios-carburantes

ejemplos/carburante_cerca.py; almacen.py sync --fuentes carburantes para la serie diaria por estación

monitor-regulatorio · Avisos de normas nuevas o modificadas por materia y del texto vigente de un artículo

despachos, compliance, legaltech

boe-api-sumario, boe-api-legislacion-consolidada, boe-eli

fuentes-radar con ejemplos/radar/ (BOE por sección, departamento y palabras, aviso diario); scripts/clientes/boe.py (normas actualizadas ayer y versión vigente de un bloque)

panel-macro · Panel de coyuntura (IPC, paro, PIB, Euríbor, prima de riesgo) para fintech, medios y asesores

fintech, medios, asesores financieros

ine-api-tempus, bde-estadisticas

herramienta coyuntura (consulta.coyuntura); los 90 ZIP del Banco de España con descarga condicional para series completas

precio-electricidad · Precio de la electricidad por cuarto de hora para apps de ahorro, domótica y recarga de vehículos

apps de consumo, domótica, puntos de recarga

omie-mercado

ficha omie-mercado (ficheros marginalpdbc por día y ZIP anual)

buscador-medicamentos · Buscador de medicamentos con presentaciones, prospecto y problemas de suministro

farmacias, healthtech, apps de pacientes

aemps-cima-api

ficha aemps-cima-api (API REST JSON sin clave)

agritech-parcelas · Información de una parcela agrícola por coordenadas (uso, superficie, Red Natura, zonas vulnerables a nitratos)

agritech, cooperativas, aseguradoras agrarias

mapa-sigpac, catastro-ovc

perfil_municipio con «lat,lon» (recinto, uso, superficie y referencia catastral de la parcela, municipio INE); scripts/clientes/ogc.py (recintos por bbox siguiendo next)

viviendas-turisticas · Mapa y censo de viviendas turísticas por municipio, barrio o calle, con licencia frente a anuncios en plataformas

proptech, ayuntamientos, asociaciones vecinales, gestores de alquiler, hoteleros

viviendas-uso-turistico, ine-api-tempus, cnig-centro-descargas

perfil_municipio (bloque viviendas_turisticas: INE en toda España y registro en Cataluña, Madrid y Comunitat Valenciana); los listados con dirección y referencia catastral de Socrata y CKAN; ubicar para cruzar por referencia catastral

eficiencia-energetica-edificios · Etiqueta energética de un edificio y reparto de letras por municipio para rehabilitación, hipotecas verdes y proptech

empresas de rehabilitación y ESE, bancos (financiación verde), proptech, administradores de fincas

certificados-eficiencia-energetica, cnig-centro-descargas, catastro-ovc

perfil_municipio con una dirección (bloque certificados_energeticos: el último certificado por inmueble de la parcela en Cataluña y la Comunitat Valenciana); Socrata con $group para el reparto por municipio en Cataluña; CSV y 7z en Madrid y Andalucía

Lo que no dice la documentación oficial

Algunos ejemplos, comprobados con llamadas reales:

  • La exportación de la BDNS devuelve 50 filas aunque haya miles si no pasas pageSize, y no avisa. Y para sincronizarla no sirve la fecha de concesión: las del 15/01/2025 se siguieron dando de alta hasta agosto de 2026 (el filtro bueno, fechaRegInicio, no está documentado).

  • Para filtrar un municipio, el INE no quiere su código (02001) sino un Id interno (6124). En SIGPAC y Catastro, Madrid es 28:900, no 28079, y otros 4.448 municipios cambian de número (tabla de equivalencias).

  • El IPC del último mes es un avance que se revisa, y el PIB que se publica es el corregido: 0,68 % trimestral en 2026T2 frente al 4,79 % de la serie sin corregir.

  • En el CSV del paro registrado del SEPE, Oza-Cesuras sale con 0 parados y Cerdedo-Cotobade no aparece: sus datos van con los códigos de antes de la fusión.

  • Muchos servidores .gob.es envían el certificado FNMT sin la intermedia: el navegador entra, curl y requests fallan (arreglo).

  • Los CSV de los portales PC-Axis llegan en UTF-8 aunque la cabecera diga ISO-8859-15, y el del SEPE en Windows-1252 aunque diga UTF-8.

  • En GBIF la encina ibérica es sobre todo Quercus rotundifolia (1,3 millones de registros en España); preguntar por Quercus ilex, que es lo que devuelve el buscador de nombres, da 21.322 sin ningún aviso. Y 41,6 de sus 95,8 millones de registros en España son CC BY-NC.

Fuentes catalogadas: 102. 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. Las trampas silenciosas, las que dan una cifra incompleta o distinta sin ningún error, van aparte en alerts, y el servidor MCP las devuelve lo primero.

  • 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

6

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

12

territorio-cartografia

Territorio, catastro y cartografía

5

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

6

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

3

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

3

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-min.txt, llms.txt, llms-full.txt   entrada para agentes, de menos a más (generado)
indices/*.yaml               productos, recetas por intención, necesidades, identificadores, códigos que son parámetros, rutas muertas (fuente de verdad)
indices/README.md            los seis índices en texto (generado)
ejemplos/                    proyectos pequeños que funcionan (carburante, BOE, licitaciones, municipio, subvenciones)
plugins/, .claude-plugin/    plugin de Claude Code con la skill y el servidor MCP
datos/municipios.csv         los 8.132 municipios con su código INE, Id del INE Tempus, SIGPAC y Catastro, DIR3, NIF, NUTS3 y coordenadas (scripts/municipios.py)
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/            sesión HTTP, clientes CKAN, Socrata, PC-Axis, ArcGIS y OGC, cargadores (BOE y BORME, BDNS, AEMET, INE, PLACSP, DataComex, Saiku) y almacén local en Parquet
scripts/clientes/muestras/   respuestas reales recortadas para probar los parsers sin red (python scripts/test_clientes.py)
evals/                       24 tareas con respuesta esperada para medir lo que aporta el repo a un agente
templates/source.yaml        plantilla de ficha
guides/                      guías transversales (cliente HTTP, identificadores, servidor MCP, reutilización y datos personales, almacén)

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'
# pip install "fuentes-publicas-mcp @ git+https://github.com/BquantFinance/Administracion-fuentes-publicas"
from fuentes_publicas.clientes import ckan, socrata, pcaxis, arcgis, ogc
from fuentes_publicas.clientes.sesion import sesion  # requests.Session con FNMT, User-Agent, reintentos y bloqueos

pcaxis.tabla(24077)[:3]                 # IPC del INE en CSV: UTF-8 real, coma decimal y periodo sin dato como None
list(socrata.filas("gn9e-3qhr"))        # 87.930 filas de la Generalitat, no las 1.000 que da Socrata sin $limit
list(ckan.filas("cnmc", rid))           # todas las filas del datastore aunque el portal recorte limit a 32.000
ckan.comparar("comunidad-madrid", rec)  # el datastore del padrón tiene 5.000 filas; el CSV, 18.718

Índices para agentes

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

  • Productos: qué se puede construir hoy, para quién y con qué piezas.

  • 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. En tareas con trampas silenciosas y un modelo pequeño (Haiku, tres repeticiones, tokens medidos turno a turno), el acierto pasa de 3 de 21 sin catálogo a 13 de 21 con el servidor MCP, con un 43 % menos de tokens; con las alertas, las trampas que aún fallaban pasan de 5 a 18 de 18.

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.

Available Tools

13 tools
almacen_sqlB

SQL de solo lectura (DuckDB) sobre el almacén local en Parquet si existe: tablas boe, borme, bdns, placsp, placsp_adjudicaciones y carburantes (PLACSP con una fila por versión y columna feed: 643 perfiles alojados, 1044 plataformas agregadas, 1143 menores), y vistas placsp_ultimo (una por id, con anulada) y adjudicaciones_ultimo; borme.actos es lista (list_contains(actos, 'Constitución')). Devuelve columnas, filas y cobertura; sin almacén, cómo crearlo.

Inputs: consulta (required), limite.

boe_sumarioA

Disposiciones de un día del BOE (diario=boe) o del BORME (diario=borme); fecha AAAA-MM-DD. Filtra por código de sección (1, 2A, 2B, 3, 4, 5A) y por texto en el título. Domingos y festivos no hay boletín.

Inputs: fecha (required), texto, diario, seccion, +1 more.

buscarB

Busca a la vez fichas (resumen, alerts y code si hay código que ya la trae), recetas que cruzan fuentes, necesidades con la ficha que las resuelve, productos que se pueden construir e identificadores. Devuelve un índice ligero; el detalle, con ficha(id).

Inputs: consulta (required), limite, sector.

ckan_buscarB

Conjuntos de un portal CKAN con sus recursos (id, formato, si tiene datastore, url de descarga). portal: comunidad-madrid, madrid, barcelona, gva, andalucia, cnmc, renfe o la URL de su /api/3/action.

Inputs: texto (required), portal (required), limite.

ckan_filasA

Filas del datastore de un recurso CKAN con filtros por igualdad ({"Territorio": "Madrid"}), paginando sin el tope silencioso del portal. Devuelve total_datastore: compáralo con el fichero antes de dar un total.

Inputs: portal (required), recurso (required), limite, filtros.

codigosA

Códigos que una API exige y no se adivinan (Id del INE para tv, países de DataComex, estaciones de AEMET, productos de carburantes, rangos del BOE). Sin grupo, la lista de grupos; con grupo, sus entradas.

Inputs: grupo.

coyunturaA

Último dato de coyuntura de España con periodo, serie y fuente: IPC (marcando si es avance), paro EPA, PIB corregido, paro registrado, Euríbor, dólar, deuda PDE, bono a 10 años y prima de riesgo.

Inputs: no named parameters.

descargarA

Descarga una URL pública resolviendo certificados FNMT, User-Agent, reintentos, gzip y codificación, y la resume (CSV, JSON, xlsx o ZIP). Avisa de bloqueos de WAF, añade las alerts de la ficha del host y la sustituta si la URL está muerta. Hasta 25 MB. Para cuando tu fetch falle con un .gob.es o para ver qué devuelve una URL.

Inputs: url (required), desde, max_caracteres.

empresa_nifA

Lo público de una empresa o entidad por NIF: si es sector público (con DIR3), subvenciones, ayudas de Estado y minimis con totales (BDNS), ayudas de la AEI y prohibiciones de contratar; con almacén local, contratos adjudicados y actos del BORME. Con un nombre en vez de NIF, candidatos con su NIF (directorio de la BDNS y del almacén, sin personas físicas), o el perfil si uno coincide exacto. Con una lista de hasta 10, todos en una llamada.

Inputs: nif (required), max_filas.

fichaC

Detalle de cualquier id de buscar: fuente (alerts y code primero, endpoints con ejemplo y respuesta, sync, gotchas), receta (pasos), producto (piezas, frescura, licencia, trampa) o identificador (regex, cruces). Si no existe, ids parecidos.

Inputs: id (required).

perfil_municipioA

Un municipio (nombre, código INE, SIGPAC, DIR3 o NIF) o el de una dirección («calle Alcalá 50, Madrid») o «lat,lon» en una llamada: sus códigos en cada sistema (SIGPAC y Catastro numeran distinto que el INE), padrón, renta media, paro y contratos del año por mes, criminalidad, viviendas turísticas (INE y registro autonómico) y compraventas y valor tasado de vivienda; con dirección o coordenadas, además ubicacion (CP, coordenadas y referencia catastral del portal; exacta=false si la calle hallada no es la pedida; en el campo, recinto SIGPAC, uso y referencia de la parcela), certificados energéticos del edificio (Cataluña y C. Valenciana) y, a menos de 1 km, puntos de recarga, colegios y centros de salud y hospitales con los tres más cercanos. solo_codigos=True da solo los códigos y la ubicación. Con una lista de hasta 20, en una llamada.

Inputs: municipio (required), solo_codigos.

socrata_filasC

Filas de un conjunto de la Generalitat de Catalunya (analisi.transparenciacatalunya.cat, id como gn9e-3qhr) con SoQL; números ya convertidos. Los nombres de campo van sin caracteres no ASCII (estaci por Estació).

Inputs: conjunto (required), order, where, limite, +1 more.

tabla_pcaxisB

Tabla PC-Axis en filas con números ya convertidos (None es dato no disponible o secreto, no cero): id de tabla del INE (24077), URL Tabla.htm del INE, Interior, Educación o Cultura, o URL del fichero. filtro deja las filas con ese texto en algún campo (código INE como 08019, nombre, periodo).

Inputs: tabla (required), filtro, max_filas.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 13 tools

    Disambiguation4/5

    Most tools are clearly distinct: entity lookups (empresa_nif, perfil_municipio, coyuntura), a catalog index/detail pair (buscar/ficha), and platform-bound fetchers. There is some overlap among the row-fetching tools (ckan_filas, socrata_filas, tabla_pcaxis, almacen_sql) since all return tabular data, but each names its specific source system and the detailed descriptions make the boundaries workable.

    Naming Consistency3/5

    All names are lowercase snake_case, but the conventions are mixed: resource-first compounds (ckan_buscar, socrata_filas, almacen_sql, tabla_pcaxis, boe_sumario), bare verbs (buscar, descargar), and bare nouns (coyuntura, ficha, codigos). Verb/noun ordering is inconsistent, though each name remains readable.

    Tool Count4/5

    13 tools is a reasonable size for a broad multi-source public-data catalog, and each tool appears to cover a distinct source or operation. Slightly heavy given the heterogeneous scope, but nothing feels obviously redundant.

    Completeness4/5

    Coverage spans BOE/BORME, BDNS, PLACSP, CKAN, Socrata, INE PC-Axis, economic indicators, municipalities and companies, plus a discovery layer (buscar/ficha) and generic fetch (descargar). Some source types and entity profiles are absent, but the surface lets agents work around gaps via the catalog.

    Maintenance

    ActivitySlowing
    ResponsivenessMixed handling

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for querying Spanish government open data APIs including grants, legislation, company registry, statistics, and open data catalog. Enables LLMs to access Spanish public information on-the-fly.
      26
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to perform due diligence, KYB, and supplier or client verification by querying Spanish company registry data cross-referenced with public grants and procurement awards, each fact linking to its official publication.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to search and retrieve datasets, publishers, and themes from Spain's national open-data catalogue through keyless MCP tools or HTTP endpoints.
      93 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants and agents to query Spanish public statistics from INE, official BOE publications, and Catastro property data via typed, read-only tools with structured, source-citable results.
      8
      MIT