Basque Country Public Tenders Index Scraper · Anuncios de contratación del País Vasco

Extrae el índice de anuncios de contratación pública del País Vasco (Gobierno Vasco, diputaciones forales, ayuntamientos y demás entidades adheridas a la Kontratazio Publikoen Plataforma) desde el catálogo oficial Open Data Euskadi.

Scrapes the Basque Country's public procurement announcements index (regional government, provincial councils, town halls and other affiliated bodies) from the official Open Data Euskadi catalogue.

---

🇪🇸 Español

Qué obtienes

Un ítem por anuncio de contratación:

Campo	Qué es
idExpediente	Número de expediente del órgano
titulo, objeto	Título y objeto del anuncio
administracion	Entidad (institución)
organoContratacion	Poder adjudicador
organoSuperior	Departamento
unidadTramitadora	Órgano de contratación concreto
estado	Estado de tramitación (Abierto / Plazo de presentación, Adjudicación provisional / definitiva…)
esContratoMenor	Booleano
fechaPublicacionAnuncio, fechaLimiteOfertas	Fechas, en ISO
enlaceFichaPublica	Ficha pública oficial del expediente

⚠️ Limitación importante, verificada y documentada: sin importes ni adjudicatario

A diferencia de catalonia-tenders y aragon-tenders, este actor NO incluye presupuesto, importe de adjudicación ni datos del adjudicatario. No es una carencia de implementación: es una limitación real y verificada del origen de datos.

• El índice público (el que usa este actor) no lleva esos campos — verificado con curl sobre el volcado JSON completo.
• El detalle de cada expediente (que sí los lleva) solo está disponible en dos rutas técnicas, ambas prohibidas por el robots.txt de contratacion.euskadi.eus: Disallow: /*/es_*/data/* (el JSON/XML de detalle) y Disallow: /*idxContent* (los metadatos indexados).
• La página HTML pública del expediente sí está permitida por robots, pero es una aplicación de página única que pinta el detalle en el navegador leyendo precisamente el recurso prohibido — verificado que el HTML crudo no contiene el adjudicatario.
• Existe un tercer recurso (trazabilidad) que sí está permitido por robots y sí contiene el adjudicatario, pero el identificador interno que necesita esa URL solo aparece dentro del propio recurso prohibido — callejón sin salida conforme con robots.txt.

Este actor nunca solicita las rutas prohibidas. El resultado es un índice de oportunidades de licitación (quién, qué, cuándo, en qué estado y enlace a la ficha oficial), no un registro económico completo. Ver la evidencia curl completa en docs/fase5/socrata-ccaa.md.

El filtrado ocurre en CLIENTE, no en servidor

A diferencia de Cataluña (Socrata) y Aragón (CKAN), esta plataforma no ofrece ningún parámetro de consulta (?q=, ?filters=…) — verificado con curl. El actor descarga el volcado JSON completo del periodo elegido (fuente) y aplica keywords/fechaDesde/fechaHasta/soloContratoMenor en memoria, documentado en cada log de ejecución.

Parámetros de entrada

Parámetro	Tipo	Por defecto	Descripción
fuente	abiertos|anio	abiertos	abiertos = solo anuncios actualmente en plazo (rápido, ~500 filas). anio = volcado histórico completo de un año
anio	entero	2025	Solo si fuente: anio. Disponible desde 2005
keywords	lista de textos	[]	Busca en título+objeto, EN CLIENTE
soloContratoMenor	booleano	false	Filtro en cliente
fechaDesde / fechaHasta	fecha ISO	—	Filtro en cliente sobre la fecha de publicación
maxItems	entero	200	Tope de ítems

Fuente y aviso legal

• Fuente oficial: Open Data Euskadi, catálogo del Gobierno Vasco — https://opendata.euskadi.eus/contenidos/ds_contrataciones/. Volcado "anuncios en plazo abierto" verificado el 23-ago-2026 (501 filas, ~1,3 MB, actualización diaria); volcado anual 2025 verificado el mismo día (96.829 filas, ~229 MB).
• Este actor respeta estrictamente el robots.txt de contratacion.euskadi.eus (no solicita dataXML ni metadataXML).
• Este actor solo lee datos públicos, sin login, sin cookies y sin saltarse ninguna medida técnica. No es un producto oficial ni está afiliado, respaldado ni verificado por el Gobierno Vasco.

---

🇬🇧 English

What it does

euskadi-tenders scrapes the Basque Country's public procurement announcements index from the official Open Data Euskadi catalogue.

Important, verified limitation: no amounts or awardee data

Unlike catalonia-tenders/aragon-tenders, this actor does not include budget, award amount or awardee identity. This is a real, verified platform limitation, not a shortcut: the only two endpoints that carry that detail are explicitly blocked by contratacion.euskadi.eus's robots.txt (Disallow: /*/es_*/data/* and Disallow: /*idxContent*), and the public HTML detail page (which robots.txt does allow) renders that data client-side from precisely those blocked endpoints — verified empty in the raw HTML. This actor never requests the disallowed paths. See docs/fase5/socrata-ccaa.md for full curl evidence.

Client-side filtering

This platform exposes no query parameters at all (verified with curl) — the actor downloads the full JSON dump for the chosen period and filters in memory.

Disclaimer

Data comes from Open Data Euskadi, the Basque Government's official open data catalogue. This actor is not an official product and is not affiliated with or endorsed by the Gobierno Vasco / Eusko Jaurlaritza.

---

Palabras clave / Keywords: licitaciones País Vasco, contratación pública Euskadi, Kontratazio Publikoen Plataforma, Gobierno Vasco, Eusko Jaurlaritza, anuncios de licitación, open data Euskadi, public procurement Basque Country.