🇪🇸 España Subasta Scout (Subastas BOE)

Este Actor extrae datos del portal oficial Subastas BOE

⚙️ Setup local (desarrollo)

pip install -r requirements.txt
playwright install chromium   # o: playwright install chrome
apify run

Si Chromium falla (SIGSEGV), instala Chrome y el actor usará channel="chrome" automáticamente. (Boletín Oficial del Estado) para obtener información precisa y detallada sobre futuras subastas de bienes inmuebles y activos en España. Está diseñado para inversores inmobiliarios, analistas y "subasteros" que buscan oportunidades.

---

🚀 ¿Por qué usar este Scraper?

El sitio web oficial subastas.boe.es es potente pero difícil de seguir a gran escala. Requiere navegar por múltiples pestañas para cada subasta para obtener la imagen completa. Este Actor resuelve esto:

1. Scraping Profundo Multi-Pestaña: Navega automáticamente por las pestañas General, Autoridad, Bienes y Pujas para extraer detalles ocultos.
2. Soporte Multi-Lote: Detecta subastas con múltiples lotes (ej. "(2 lotes)") e itera por cada uno para extraer detalles financieros y de propiedad específicos.
3. Documentos: Por defecto incluye enlaces (titulo, url) a PDFs del BOE (verDocumento.php). Opcionalmente puede descargar los PDFs al Key-Value Store de Apify y devolver file_key, file_url y download_status (ver más abajo).
4. Cálculos de Referencia: Calcula automáticamente los valores del 70% y 50% del valor de subasta para una estrategia de puja rápida.

🎯 Casos de Uso

• Análisis de Inversión: Filtrar propiedades en Madrid o Barcelona con una Puja Mínima baja.
• Investigación de Mercado: Analizar tendencias de subastas en diferentes provincias.
• Monitoreo de Activos: Rastrear tipos específicos de activos (Vivienda, Garaje, Solar).

💰 Cálculos Inteligentes

Proporcionamos campos calculados para ayudarle a evaluar la oportunidad al instante:

• Valor de Referencia (70%): El umbral a menudo utilizado para aprobaciones de adjudicación directa.
• Valor de Referencia (50%): Un límite inferior crítico para estrategias de puja.

💡 Consejos para Inversores

• Provincias: Seleccione Todas las provincias para obtener subastas de toda España, o filtre por provincias específicas (ej. Madrid, Valencia/València).
• Max Items: Establezca maxItems en 0 para no limitar el número de resultados (todas las entradas).
• Tipo de Bien: Filtre por Vivienda, Garaje, Solar, etc.
• Depósito: Extraemos el depósito exacto requerido para participar.

📄 Documentos PDF (opcional)

Por defecto (downloadDocumentsToKvs omitido o false) el comportamiento es solo enlaces; no cambia respecto a integraciones antiguas.

Input	Comportamiento
downloadDocumentsToKvs: false u omitido	Solo titulo y url por documento.
downloadDocumentsToKvs: true	Descarga cada PDF con la misma sesión del navegador, lo guarda en el Key-Value Store por defecto y añade file_key, download_status; en ejecuciones en Apify también file_url (API del almacén).

Algunos PDFs del BOE exigen sesión iniciada. Para ellos puede subir un JSON de Playwright storage state (tras iniciar sesión en subastas.boe.es, exportar con context.storage_state()) al Key-Value Store del run y pasar playwrightStorageStateKvsKey con el nombre del registro (alternativa: playwrightStorageStateJson como texto). Las sesiones pueden caducar; si download_status es not_pdf_maybe_login, hay que renovar el estado.

📦 Ejemplo de Salida

El scraper proporciona un conjunto de datos JSON limpio y estructurado con claves en Español, listo para integración:

{
  "identificador": "SUB-JA-2025-255845",
  "tipo_subasta": "JUDICIAL EN VÍA DE APREMIO",
  "fecha_inicio": "2025-12-30T18:00:00+01:00",
  "fecha_conclusion": "2026-01-19T18:00:00+01:00",
  "valor_subasta": 305348.0,
  "valor_referencia_70_porciento": 213743.6,
  "valor_referencia_50_porciento": 152674.0,
  "deposito": 15267.4,
  "puja_minima": 0.0,
  "cantidad_reclamada": 135353.97,
  "descripcion": "VIVIENDA en Calle Principal...",
  "direccion": "C/ Mayor, 1",
  "localidad": "Madrid",
  "provincia": "Madrid",
  "autoridad_nombre": "JUZGADO 1 INSTANCIA 5",
  "autoridad_email": "juzgado5@justicia.es",
  "lotes_data": [
    {
      "nombre": "Lote 1",
      "financiero": { "valor_subasta": 210000.0 },
      "bien": { "descripcion": "VIVIENDA en..." }
    }
  ],
  "documentos": [
    {
      "titulo": "Certificación de Cargas",
      "url": "https://subastas.boe.es/verDocumento.php?idSub=..."
    },
    {
      "titulo": "Edicto",
      "url": "https://subastas.boe.es/verDocumento.php?idSub=...",
      "file_key": "DOC_SUB-JA-2026-259951_0_Edicto.pdf",
      "file_url": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/...",
      "download_status": "ok"
    }
  ],
  "detail_url": "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-...",
  "google_maps_url": "https://www.google.com/maps/search/?api=1&query=..."
}

📜 Aviso Legal

Esta herramienta es solo para fines informativos. Verifique siempre los detalles de la subasta en el sitio web oficial del juzgado o autoridad gestora.

---

🇬🇧 Spain Auction Scout (Subastas BOE)

This Actor scrapes the official Subastas BOE (Boletín Oficial del Estado) portal to extract accurate, deep-level data on upcoming real estate and asset auctions in Spain. It is designed for real estate investors, analysts, and "subasteros" looking for opportunities.

🚀 Why use this Scraper?

The official subastas.boe.es website is incredibly powerful but difficult to monitor at scale. It requires navigating through multiple tabs for every single auction to get the full picture. This Actor solves that by:

1. Multi-Tab Deep Scraping: Automatically clicks through General, Autoridad, Bienes, and Pujas tabs to extract hidden details.
2. Multi-Lot Support: Detects auctions with multiple lots (e.g., "(2 lotes)") and iterates through each one to extract specific financial and property details.
3. Documents: By default outputs document links (titulo, url) to BOE PDFs (verDocumento.php). Optionally downloads PDFs into the default Key-Value Store and adds file_key, file_url, and download_status (see below).
4. Reference Calculations: Automatically calculates 70% and 50% values of the auction price for quick bidding strategy.

🎯 Use Cases

• Investment Analysis: Filter for properties in Madrid or Barcelona with a low Puja Mínima.
• Market Research: Analyze auction trends across different provinces.
• Asset Monitoring: Track specific types of assets (Vivienda, Garaje, Solar).

💰 Smart Calculations

We provide calculated fields to help you assess the opportunity instantly:

• Valor de Referencia (70%): The threshold often used for direct award approvals.
• Valor de Referencia (50%): A critical lower bound for bidding strategies.

💡 Tips for Investors

• Provinces: Select Todas las provincias (All provinces) to get auctions from all of Spain, or filter by specific provinces (e.g., Madrid, Valencia/València).
• Max Items: Set maxItems to 0 for no limit (all entries).
• Property Type: Filter by Vivienda (Housing), Garaje, Solar, etc.
• Deposit (Depósito): We extract the exact deposit required to participate.

📄 PDF documents (optional)

Default (downloadDocumentsToKvs omitted or false): only titulo and url per document — same as before for existing clients.

Input	Behavior
downloadDocumentsToKvs: false or omitted	Links only (backward compatible).
downloadDocumentsToKvs: true	Fetches each PDF using the browser session, saves bytes to the default Key-Value Store, and adds file_key and download_status; on Apify runs, file_url points at the store record API.

Some BOE PDFs require a logged-in session. Export Playwright storage state after signing in at subastas.boe.es, upload that JSON as a Key-Value Store record, and set playwrightStorageStateKvsKey to that record key (or use playwrightStorageStateJson for inline JSON — prefer KVS for secrets). Sessions expire; if download_status is not_pdf_maybe_login, refresh the storage state.

Accessing file_url usually requires your Apify API token as the token query parameter on the Key-Value Store API, unless the store is configured for public access.

📦 Output Example

The scraper provides a clean, structured JSON dataset with keys in Spanish, ready for integration (see the Spanish section for a full JSON example, including optional file_key / file_url / download_status on documents).