Saltar al contenido
Datos abiertos de PLACSP, Euskadi, Catalunya y Madrid · 6.275.423 contratos · actualizado el 20/11/2026 07:41
contratosmenores

API y conexión para agentes de IA

Los mismos datos de la web, por API REST o como servidor MCP para conectar un agente: Claude, ChatGPT, Cursor o el tuyo. Gratis, con un token personal y 2.000 consultas al día.

Pedir un token

Solo te pedimos un correo y para qué lo vas a usar. El token se muestra al momento y te enviamos un correo con las instrucciones (sin el token).

Conectar un agente por MCP

Servidor MCP por HTTP en https://contratosmenores.com.es/mcp, con el token en la cabecera Authorization: Bearer cm_….

Claude Code

$ claude mcp add --transport http contratosmenores \
    https://contratosmenores.com.es/mcp \
    --header "Authorization: Bearer cm_TU_TOKEN"

Claude Desktop, Cursor y similares

{ "mcpServers": { "contratosmenores": {
    "type": "http",
    "url": "https://contratosmenores.com.es/mcp",
    "headers": { "Authorization": "Bearer cm_TU_TOKEN" }
} } }

Herramientas

buscar_contratosBusca contratos menores ya adjudicados en España (PLACSP, Euskadi, Catalunya y Ayuntamiento de Madrid): qué se compró, quién lo compró, a quién y por cuánto. Devuelve 25 por página, del más reciente al más antiguo (o por importe).
ver_contratoFicha completa de un contrato menor por su id, con el contacto del organismo.
buscar_organismosBusca organismos compradores por nombre (ayuntamientos, consejerías, universidades…). Devuelve su id.
ver_organismoPerfil de compras de un organismo: cuánto compra por menor, de qué sectores, a qué proveedores, y su correo y teléfono de contratación.
ver_empresaContratos menores ganados por una empresa (por NIF) y sus principales organismos clientes. No disponible para personas físicas.
renovaciones_previstasCompras por contrato menor adjudicadas hace un año cuyo aniversario cae en los próximos días: candidatas a repetirse. Es una previsión, no un anuncio oficial.
resumen_periodoResumen de los contratos menores publicados en los últimos días: totales, por sector, los mayores, los que tuvieron plazo de ofertas y las empresas que más ganan. Útil para partes semanales.
contratos_abiertosOportunidades con plazo de ofertas ABIERTO ahora mismo en toda España. Tres tipos: «menor» (contratos menores anunciados: Ayuntamiento de Zaragoza, Cataluña, Euskadi, Junta de Andalucía), «lic_menor» (licitaciones de PLACSP y plataformas autonómicas de hasta 15.000 €, 40.000 € en obras) y «lic_pequena» (hasta 60.000 €, 80.000 € en obras: abierto simplificado sumario y similares). Por defecto solo menor y lic_menor; lic_pequena hay que pedirla.
listar_sectoresDivisiones CPV (sectores) con su código de 2 cifras.

API REST

Base: https://contratosmenores.com.es/api/v1. El token va en Authorization: Bearer o en X-API-Key. Respuestas en JSON.

GET /contratosBúsqueda. Parámetros: q, sector, cpv, provincia, desde, hasta, min, max, organismo_id, empresa_nif, solo_con_plazo, orden, pagina
GET /contratos/{id}Ficha de un contrato, con el contacto del organismo
GET /organismos?q=Buscar organismos por nombre
GET /organismos/{id}Perfil de compras de un organismo
GET /empresas/{nif}Contratos de una empresa (persona jurídica)
GET /renovacionesRenovaciones previstas: q, sector, cpv, provincia, min, desde_dias, dias, pagina
GET /resumenResumen de los últimos días: dias, q, sector, cpv, provincia
GET /abiertosMenores con plazo abierto: q
GET /sectoresLista de sectores (divisiones CPV)
$ curl -H "Authorization: Bearer cm_TU_TOKEN" \
    "https://contratosmenores.com.es/api/v1/contratos?q=licencias+microsoft&provincia=46"

La cabecera X-Cupo-Restante dice cuántas consultas te quedan hoy. Si te pasas, la API responde 429 hasta medianoche (hora de Madrid).

Condiciones

Gratis. Cita la fuente (el campo «fuente» de cada contrato, «vía contratosmenores.com.es»). No se publican datos de personas físicas adjudicatarias y no se permite intentar reconstruirlos. Podemos desactivar los tokens que abusen del servicio.