Saltar al contenido
CERPBanco de ítems

Beta

API de datos y MCP del banco de ítems

La API pública de lectura y el servidor MCP (Model Context Protocol) ya están disponibles en beta, sin clave. Consulta ítems, precios y descomposiciones de España y Argentina por texto, código o capítulo desde tu software, tus presupuestos o tu agente de IA, sin bajar el bundle entero.

Toda respuesta incluye la licencia y la atribución de los datos: al reutilizarlos, cítala. Los precios van en la moneda de la fuente (EUR en España, ARS en Argentina), con su fecha y su procedencia: son precios de referencia, no precios actualizados a hoy. Qué mide el banco y qué no verifica todavía está en la salud del dataset.

API de lectura

Base https://items.cerp.es/api/v1, JSON con CORS abierto. El contrato completo está en OpenAPI 3.1.

  • GET /api/v1/search?q=&country=&kind=&limit=

    Búsqueda por texto: todas las palabras en la descripción o el código, sin distinguir tildes. Hasta 25 resultados, sin paginación.

  • GET /api/v1/items/{id}?country=

    Ficha completa: descomposición costeada, todos los precios con su procedencia (fuente, código, edición, ámbito, fecha y antigüedad) y la verificación automática.

  • GET /api/v1/chapters?country=&depth=

    Árbol de capítulos con el número de ítems de cada nodo y el enlace a su página.

  • GET /api/v1/meta

    Versión del bundle, países, conteos, licencia y atribución exacta.

  • GET /api/v1/health

    Salud del dataset de cada país: estados de verificación, antigüedad de los precios, cobertura de la descomposición por capítulo, observaciones abiertas y fuentes. Los mismos números que la página de salud del dataset.

country es es (por defecto) o ar. Errores en JSON con { error: { code, message } }.

Servidor MCP

Servidor remoto de solo lectura en https://items.cerp.es/mcp (transporte Streamable HTTP, sin sesión). Añádelo a cualquier cliente que admita servidores MCP remotos por HTTP:

{
  "mcpServers": {
    "cerp-items": {
      "type": "http",
      "url": "https://items.cerp.es/mcp"
    }
  }
}
  • search_items: busca ítems por texto (hasta 10 resultados).
  • get_item: devuelve la ficha completa de un ítem por su código.
  • list_chapters: recorre el árbol de capítulos del catálogo.

Límites de la beta

  • Sin clave; el uso intensivo puede limitarse por IP.
  • La búsqueda devuelve como mucho 25 resultados (10 en el MCP) y no pagina: afina la consulta.
  • Las respuestas se sirven desde caché y se renuevan cada hora.

Más cuota y export masivo

Si necesitas claves con más cuota o exportar el banco en bloque, apúntate a la lista de espera y cuéntanos en el correo el uso previsto: con él ordenamos la lista.

Apuntarme a la lista

Descarga directa