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_contratos | Busca 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_contrato | Ficha completa de un contrato menor por su id, con el contacto del organismo. |
buscar_organismos | Busca organismos compradores por nombre (ayuntamientos, consejerías, universidades…). Devuelve su id. |
ver_organismo | Perfil 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_empresa | Contratos menores ganados por una empresa (por NIF) y sus principales organismos clientes. No disponible para personas físicas. |
renovaciones_previstas | Compras 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_periodo | Resumen 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_abiertos | Oportunidades 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_sectores | Divisiones 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 /contratos | Bú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 /renovaciones | Renovaciones previstas: q, sector, cpv, provincia, min, desde_dias, dias, pagina |
GET /resumen | Resumen de los últimos días: dias, q, sector, cpv, provincia |
GET /abiertos | Menores con plazo abierto: q |
GET /sectores | Lista 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.