PLACSP — Datos de contratación pública vía datos.gob.es

PLACSP — Datos de contratación pública vía datos.gob.es

La Plataforma de Contratación del Sector Público (contrataciondelestado.es) es el canal oficial donde se publican los contratos del Estado y otros organismos públicos españoles. No expone una API REST pública con catálogo consultable: los volcados oficiales son ficheros ATOM mensuales muy pesados, poco prácticos para consultas puntuales.

En su lugar, los datasets de PLACSP están indexados en el catálogo nacional datos.gob.es, que sí ofrece una API abierta bien documentada y permite filtrar por título.

Esta skill sigue siempre el mismo patrón:

1. Buscar por título en datos.gob.es con la ruta /title/{texto}.
2. Revisar los items[].distribution[] devueltos.
3. Elegir la distribución con formato útil (CSV > JSON > XLSX > ATOM).
4. Descargar con WebFetch la accessURL real.

Nunca inventar URLs de contrataciondelestado.es ni scrapear el portal web. Solo usar accessURL extraídas de la respuesta del catálogo.

Solapamiento con transparencia

La skill transparencia también descubre datasets de PLACSP (entre otros ámbitos). La diferencia:

• placsp (esta skill) → uso específico para contratación pública del Estado: contratos mayores, contratos menores, licitaciones, adjudicaciones.
• transparencia → uso genérico para el Portal de Transparencia: además de PLACSP cubre subvenciones, altos cargos, retribuciones, agendas institucionales, registro de transparencia.

Si la pregunta es exclusivamente sobre contratos públicos, esta skill es más directa. Si mezcla contratación con subvenciones u otros datos de transparencia, usar transparencia.

Base URL

https://datos.gob.es/apidata/catalog/dataset

Siempre añadir ?_format=json. WebFetch con GET y header Accept: application/json.

⚠️ El parámetro ?q={texto} NO funciona — devuelve 400. Hay que usar la ruta /title/{texto}.

Operaciones

1. PLACSP global (búsqueda canónica)

GET https://datos.gob.es/apidata/catalog/dataset/title/PLACSP?_pageSize=10&_format=json

Es la búsqueda más directa: muchos publishers etiquetan sus datasets con la abreviatura PLACSP en el título. Devuelve nombres como:

• Contratos Mayores. 2024 - (PLACSP)
• Contratos Mayores. 2025 - (PLACSP)

Usar esta consulta primero cuando el usuario menciona explícitamente "PLACSP" o "Plataforma de Contratación del Sector Público".

2. Contratos mayores por año

GET https://datos.gob.es/apidata/catalog/dataset/title/contratos%20mayores?_pageSize=10&_format=json

contratos mayores debe ir URL-encoded (contratos%20mayores). Devuelve datasets como:

• Contratos Mayores. 2024 - (PLACSP)
• Contratos Mayores. 2025 - (PLACSP)
• UCM-Licitaciones de Contratos Mayores
• Estadística del número de contratos mayores por tipo y ejercicio

Si el usuario pide un año concreto, filtrar items[] por título que contenga ese año (2023, 2024, …). Si no encuentra el año exacto, avisar y ofrecer el ejercicio disponible más próximo.

3. Contratos menores

GET https://datos.gob.es/apidata/catalog/dataset/title/contratos%20menores?_pageSize=10&_format=json

Devuelve datasets como:

• Contratos Menores (varios publishers)
• Relación de contratos menores por trimestre
• Contratos menores adjudicados

Los contratos menores los publican muchas administraciones locales y autonómicas (ayuntamientos, universidades, diputaciones) como volcados propios. Indicar siempre el publisher para que el usuario entienda el alcance territorial.

4. Licitaciones activas, anuncios y adjudicaciones

GET https://datos.gob.es/apidata/catalog/dataset/title/licitaciones?_pageSize=10&_format=json

Devuelve datasets como:

• Licitaciones Publicadas 2021 / 2022 / …
• Anuncios licitaciones
• Adjudicaciones licitaciones
• Licitaciones de los organismos públicos del proyecto NextProcurement

Si el usuario pide específicamente adjudicaciones, también probar:

GET https://datos.gob.es/apidata/catalog/dataset/title/adjudicaciones?_pageSize=10&_format=json

Estructura de respuesta

result.items[]
  .title                       → string o lista de { _value, _lang }
  .identifier                  → identificador interno
  .publisher                   → URL del publisher (DIR3)
  ._about                      → URL canónica del dataset en datos.gob.es
  .distribution[]              → array (o objeto) de distribuciones
    .accessURL                 → URL real de descarga (CSV, JSON, XLSX, ATOM)
    .format._value             → "text/csv", "application/json", "application/atom+xml", ...
    .byteSize                  → tamaño aproximado en bytes
    .title                     → nombre legible de la distribución

distribution puede venir como objeto (1 sola) o como array. Tratar siempre como lista. title puede venir como string, objeto {_value, _lang} o lista de objetos. Si es lista, preferir _lang == "es".

Workflow recomendado

1. GET /title/{termino}?_pageSize=10&_format=json
2. Filtrar result.items[] por títulos realmente relacionados con
   contratación pública (descartar agendas, subvenciones, etc.)
3. Para cada candidato, iterar distribution[]
4. Elegir formato más útil (CSV > JSON > XLSX > ATOM > PDF)
5. WebFetch a esa accessURL para descargar los datos
6. Si el fichero es muy grande (byteSize > ~5 MB), avisar antes al usuario
   — los volcados ATOM mensuales de PLACSP pueden superar 100 MB
7. Indicar siempre al usuario el publisher del dataset (Estado, CCAA,
   ayuntamiento, universidad) para que entienda el alcance

Errores comunes

• 400 Bad Request: estás usando ?q= en vez de /title/.
• 0 items: el término es demasiado específico — probar sinónimos (contratos mayores → PLACSP, licitaciones → anuncios, adjudicaciones → adjudicación).
• HTML en vez de JSON: olvidaste ?_format=json.
• Volcado ATOM gigantesco: los ficheros mensuales de PLACSP completos son enormes. Si el usuario solo quiere consultar un puñado de contratos, preferir un dataset CSV/JSON anual ya recortado.
• Confundir ámbito estatal con autonómico/local: muchos datasets de contratación los publica una CCAA, ayuntamiento o universidad concreta. Leer siempre el publisher antes de generalizar a "España".

Cuándo NO usar esta skill

• Si el usuario pregunta también por subvenciones, altos cargos o agendas → transparencia (cubre PLACSP además de eso).
• Si pregunta por la ley de contratos del sector público o una norma concreta (Ley 9/2017) → boe.
• Si pregunta por paro registrado o "contratos laborales" del SEPE → sepe (ojo: "contratos registrados" del SEPE ≠ "contratos del sector público" de PLACSP).
• Si necesita presentar una oferta real a una licitación → no es posible desde esta skill: redirigir a https://contrataciondelestado.es.
• Si pregunta por un dataset genérico no relacionado con contratación → datos-gob-es.