# Datos públicos de España para IA

> Servicio MCP + REST con datos oficiales de España ya limpios, estructurados y con fuente: Boletín Oficial del Estado (BOE), convocatorias de subvenciones (BDNS/InfoSubvenciones) y calendario fiscal de la AEAT. Cada respuesta incluye los campos `fuente` (URL oficial), `actualizado` (fecha) y `atribucion`.

Acceso: requiere clave de API (cabecera `Authorization: Bearer <clave>` o `X-API-Key`). Hoy las claves son gratuitas y se piden al responsable del servicio. Sin datos personales: no se exponen beneficiarios ni concesiones.

## Interfaces
- MCP (HTTP streamable, sin sesión): https://datos-publicos.iautopymes.com/mcp
- REST: https://datos-publicos.iautopymes.com/v1/...  (OpenAPI: https://datos-publicos.iautopymes.com/openapi.json)
- Manifiesto con herramientas y precios: https://datos-publicos.iautopymes.com/v1/manifest

## Herramientas
- `buscar_boe` (REST `GET /v1/boe`, precio 0 USD): Busca disposiciones y anuncios publicados en el Boletín Oficial del Estado (BOE) de España en los últimos ~45 días. Texto libre sobre título, departamento y epígrafe; filtros opcionales por fechas (AAAA-MM-DD), sección (1, 2A, 2B, 3, 4, 5A, 5B, 5C) y departamento. Devuelve identificador BOE, fecha, título y enlaces oficiales (HTML y PDF). Úsala para localizar normas, convocatorias, nombramientos o anuncios recientes. No cubre el histórico anterior a la ventana de cobertura indicada en la respuesta.
- `buscar_subvenciones` (REST `GET /v1/subvenciones`, precio 0 USD): Busca convocatorias de subvenciones y ayudas públicas de España en la Base de Datos Nacional de Subvenciones (BDNS/InfoSubvenciones). Por defecto solo convocatorias con solicitud abierta, ordenadas por fecha de publicación descendente. Filtros: texto libre, ámbito (estado, autonomica, local, otros) y rango de fechas de publicación. Devuelve código BDNS, título, órgano convocante y enlace oficial; para plazo, presupuesto y beneficiarios usa detalle_subvencion. No devuelve concesiones ni datos de beneficiarios.
- `detalle_subvencion` (REST `GET /v1/subvenciones/:codigo_bdns`, precio 0 USD): Devuelve el detalle de una convocatoria de la BDNS a partir de su código BDNS (el que da buscar_subvenciones): órgano, tipo, presupuesto total, plazo de solicitud (inicio/fin y si está abierta), tipos de beneficiarios, sectores, regiones, finalidad, bases reguladoras y documentos asociados, con enlace oficial.
- `proximos_vencimientos_fiscales` (REST `GET /v1/vencimientos`, precio 0 USD): Lista los vencimientos del Calendario del contribuyente de la Agencia Tributaria (AEAT) en una ventana de fechas: fecha límite, impuesto, descripción, periodo y modelos (303, 111, 130, 200...). Por defecto los próximos 30 días desde hoy. Filtra por modelo o por texto. Es el calendario general: no contempla domiciliación ni festivos locales y no es asesoramiento fiscal.
- `info_fuentes` (REST `GET /v1/fuentes`, precio 0 USD): Informa de qué fuentes oficiales usa este servicio, su URL, condiciones de reutilización, cobertura y fecha de la última sincronización. Úsala para citar correctamente la procedencia de los datos o comprobar su frescura.

## Ejemplos
- curl -H "Authorization: Bearer $CLAVE" "https://datos-publicos.iautopymes.com/v1/subvenciones?texto=digitalizacion&ambito=estado&limite=5"
- curl -H "Authorization: Bearer $CLAVE" "https://datos-publicos.iautopymes.com/v1/vencimientos?modelo=303&dias=60"
- curl -H "Authorization: Bearer $CLAVE" "https://datos-publicos.iautopymes.com/v1/boe?texto=seguridad+social&limite=5"

## Límites y cobro
- Ritmo por clave: 60 peticiones/minuto. Tope diario por clave (por defecto 500). Códigos: 401 sin clave, 429 límite (ver Retry-After), 402 pago requerido.
- Cobro: apagado. Diseñado para créditos (Stripe) y x402 (HTTP 402 con PaymentRequirements). El precio de cada herramienta está en el manifiesto.

## Condiciones de los datos
Datos de organismos públicos reutilizados con cita de fuente (BOE: "Basado en datos de la Agencia Estatal Boletín Oficial del Estado"). Información orientativa, sin valor oficial ni asesoramiento. Contrasta siempre con la fuente oficial enlazada.