Spain Property Auction Intelligence MCP (Subastas BOE & Catastro) - Proptech & Judicial Foreclosures API

The only MCP-native Apify Actor that crosses Spanish judicial property auctions (subastas BOE) with official Catastro data in a single API call. Get a 360° investment profile with automatic investment score — optimized for property investors, proptech platforms, and AI agents.

This scraper acts as a powerful proptech bridge, extracting real-time foreclosure and judicial auction data from the official Spanish government portal subastas.boe.es and automatically enriching each asset with physical attributes (surface area, construction year, land size, and GPS coordinates) from the Spanish Cadastre (Sede Electrónica del Catastro).

To provide the best user experience on Apify Console, it returns clean, fully-flattened fields mapped as columns for the Table View (with user-friendly values instead of raw nulls), while grouping the structured 360° technical blocks inside the _json_mcp_desarrolladores column for AI agents and database integrations.

---

🎯 Target Audience & 💡 Primary Use Cases

Casos de Uso / Valor Comercial (Commercial Value)

• Automated Deal Sourcing: Automatically monitor and identify high-yield property investment opportunities (oportunidades de inversión inmobiliaria) across Spanish provinces.
• AI-Driven Property Valuation: Fuel property analysis models, legal assistants, and proptech applications with clean, structured real-time datasets.
• B2G & Judicial Lead Generation: Scan active legal records and judicial files (cuenta de expediente) to track public tenders and court-ordered sales.

Público Objetivo (Target Audience)

• Analistas y Tasadores: Compare appraisal values (valor de tasación) and minimum bids (puja mínima) with official property surface data to calculate discounts and detect market inefficiencies.
• Equipos de Negocio y Subasteros: Scale and automate your auction monitoring pipeline without browsing the slow government portals page by page.
• Desarrolladores e Integradores: Access a developer-friendly API that outputs structured data in CSV, Excel, and JSON formats, with native Model Context Protocol (MCP) compatibility.

---

🚀 Características Clave (Key Technical Capabilities)

• Bilingual & SEO-Optimized Discovery: Captures search queries from both English-speaking investors and Spanish professionals searching for subastas BOE, catastro subastas España, and API inversión inmobiliaria.
• Dropdown Province Selection: Avoid typing error-prone codes. The Actor input schema includes a complete select dropdown featuring all Spanish provinces.
• Direct & Secure HTTPS Crawling: Queries public Catastro REST API over HTTPS, implementing batch request limiting (max 5 concurrently) and 200ms batch pacing to avoid IP bans.
• Automatic Fallback Design: In 20% to 30% of auctions, the cadastral reference (referencia catastral) is missing. The Actor uses regex heuristics on text descriptions, and falls back to a clean partial JSON if the data is not available, avoiding crawler crashes.
• Legal Cargas Detection: Scans description columns, registration details, and notes for keywords such as hipoteca, embargo, carga, deuda, and gravamen to flag pre-existing liens on the property.

---

⚙️ Input Parameters

The Actor accepts the following input parameters in its configuration form (INPUT_SCHEMA):

Field / Campo	Type	Default	Description
tipoBien	String	"inmueble"	Type of asset to search in BOE auctions. Values: inmueble, vehiculo, bien_mueble, todos.
provincia	String	""	Dropdown select list of Spanish provinces (e.g. Madrid (28), Barcelona (08)). Leave empty (Todas) to search all Spain.
precioMaximo	Integer	null	Maximum minimum bid in EUR (puja mínima máxima) to filter out expensive lots.
scoreMinimo	String	"todos"	Minimum investment score to return. Values: MUY_ALTO, ALTO, MEDIO, BAJO, todos.
maxResultados	Integer	20	Maximum number of auctions to return (1-50 limit).

---

📊 Output Schema

To optimize readability, the dataset contains flattened columns for the Apify Table View (substituting ugly nulls for user-friendly labels), while maintaining the full nested structures under the _json_mcp_desarrolladores object.

Flat Table View Columns (Root JSON level)

• subasta_id (String): The unique BOE auction ID.
• score_inversion (String): Automatic rating (MUY_ALTO, ALTO, MEDIO, BAJO).
• score_descripcion (String): Explanatory reason behind the score.
• puja_minima_eur (Number | String): Minimum bid value (or - if none).
• valor_tasacion_eur (Number | String): Court appraisal reference (or - if none).
• cargas_detectadas (String): "Sí" if mortgages or liens are found, "No" otherwise.
• descripcion_cargas (String): Summary of detected liens (or "Ninguna").
• fecha_cierre (String): Conclusion ISO 8601 date.
• estado_subasta (String): Status (e.g., ACTIVA).
• url_boe (String): Direct link to the BOE file.
• expediente_juzgado (String): Court authority.
• expediente_numero (String): Case number (cuenta de expediente).
• expediente_tipo (String): Type of procedure.
• direccion_boe (String): Property address as listed in BOE.
• provincia_boe (String): Province name.
• municipio_boe (String): Municipality name.
• descripcion_boe (String): Detailed text of the judicial edict.
• referencia_catastral (String): 20-char cadastral reference (or "No consta").
• catastro_disponible (String): "Sí" if Catastro OVC returned data, "No" otherwise.
• uso_catastro (String): Property use (Residencial, Comercial, etc., or "No consta").
• superficie_construida_m2 (Number | String): Built size in square meters (or "No consta").
• superficie_suelo_m2 (Number | String): Land size in square meters (or "No consta").
• antiguedad_ano (Number | String): Construction year (or "No consta").
• direccion_catastro (String): Official normalized cadastre address (or "No consta").
• coordenadas_gps (String): Latitude and longitude (e.g., 40.416, -3.703, or "No consta").
• fecha_extraccion (String): Extraction date.
• fuentes (String): Data sources (e.g., BOE subastas.boe.es, Catastro OVC).

---

🧠 Investment Score Methodology

To assist real estate AI agents and property investors, the Actor computes a proprietary rating:

$$\text{ratio_precio_tasacion} = \frac{\text{puja_minima_eur}}{\text{valor_tasacion_eur}}$$

• MUY_ALTO (Very High): Ratio is below 40% (puja < 40% tasación) and no pre-existing charges are detected.
• ALTO (High): Ratio is below 60% and no pre-existing charges are detected.
• MEDIO (Medium): Ratio is below 60% but property liens or mortgages are detected.
• BAJO (Low): Bid is equal to or greater than 60% of the appraisal value.
• SIN_DATOS (No Data): Appraisal is not published by the court (tasación no publicada).

---

🤖 MCP Integration (Model Context Protocol)

This Actor is MCP-native, meaning it integrates directly into AI clients (Cursor, Claude Desktop, VS Code) via mcp.apify.com. AI agents can query the dataset and read the raw 360° structure nested in the _json_mcp_desarrolladores object:

Example Query to AI Agent: "Find active residential property auctions in Madrid with a puja mínima under 120,000€ and a score of ALTO or higher."

---

📋 Example Output (JSON)

{
  "subasta_id": "SUB-JA-2026-258124",
  "score_inversion": "MUY_ALTO",
  "score_descripcion": "Puja < 40% tasación sin cargas detectadas",
  "puja_minima_eur": 0,
  "valor_tasacion_eur": 169838.37,
  "cargas_detectadas": "No",
  "descripcion_cargas": "Ninguna",
  "fecha_cierre": "2026-06-15T18:00:00+02:00",
  "estado_subasta": "ACTIVA",
  "url_boe": "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-258124",
  "expediente_juzgado": "Sección Civil TI Madrid. Plz.n 100",
  "expediente_numero": "5066 0000 06 0046 25",
  "expediente_tipo": "JUDICIAL EN VÍA DE APREMIO",
  "direccion_boe": "CALLE MARTIN MUÑOZ DE LAS POSADAS Nº 8, 8B, 8C Y 6 PLANTA 1 ESCALERA 3 PUERTA 1",
  "provincia_boe": "Madrid",
  "municipio_boe": "MADRID",
  "descripcion_boe": "FINCA 73.435 DEL RP Nº 19 DE MADRID",
  "referencia_catastral": "6998203VK4669H0011DJ",
  "catastro_disponible": "Sí",
  "uso_catastro": "Residencial",
  "superficie_construida_m2": 67,
  "superficie_suelo_m2": 1391,
  "antiguedad_ano": 2012,
  "direccion_catastro": "CL MARTIN MUÑOZ DE POSADAS 8(C) Pl:01 Pt:I 28031 MADRID",
  "coordenadas_gps": "40.3760153304443, -3.62655521993873",
  "fecha_extraccion": "2026-06-11T08:05:42.864Z",
  "fuentes": "BOE subastas.boe.es, Catastro OVC",
  "_json_mcp_desarrolladores": {
    "datos_subasta": {
      "puja_minima_eur": 0,
      "valor_tasacion_eur": 169838.37,
      "cargas_detectadas": false,
      "descripcion_cargas": null,
      "fecha_cierre": "2026-06-15T18:00:00+02:00",
      "estado": "ACTIVA",
      "url_boe": "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-258124"
    },
    "expediente_legal": {
      "juzgado": "Sección Civil TI Madrid. Plz.n 100",
      "numero_expediente": "5066 0000 06 0046 25",
      "tipo_procedimiento": "JUDICIAL EN VÍA DE APREMIO"
    },
    "inmueble_boe": {
      "direccion_boe": "CALLE MARTIN MUÑOZ DE LAS POSADAS...",
      "provincia": "Madrid",
      "municipio": "MADRID",
      "descripcion": "FINCA 73.435 DEL RP...",
      "referencia_catastral": "6998203VK4669H0011DJ"
    },
    "inmueble_catastro": {
      "catastro_disponible": true,
      "uso": "Residencial",
      "superficie_construida_m2": 67,
      "superficie_suelo_m2": 1391,
      "año_construccion": 2012,
      "valor_catastral_eur": null,
      "coordenadas": {
        "lat": 40.3760153304443,
        "lng": -3.62655521993873
      },
      "direccion_oficial_catastro": "CL MARTIN MUÑOZ DE POSADAS 8(C)..."
    },
    "metadatos": {
      "fecha_extraccion": "2026-06-11T08:05:42.864Z",
      "fuentes": ["BOE subastas.boe.es", "Catastro OVC"],
      "advertencias": []
    }
  }
}

---

💳 Pricing & Monetization

This Actor is configured for Pay-Per-Event (PPE) monetization on the Apify Store, which means you only pay for successful results instead of paying for execution time or server runtime.

Apify Console Monetization Settings:

When publishing or setting up monetization for this Actor, use the following configurations:

• Event Name: auction-consolidated (matches the internal code identifier)
• Title: Subasta consolidada y enriquecida (BOE + Catastro)
• Description: Cobro por cada subasta de inmueble del BOE extraída y enriquecida con datos físicos y coordenadas GPS oficiales del Catastro.
• Price Options:
  • $0.05 USD per event (Standard rate - Recommended)
  • $0.02 USD per event (Competitive volume pricing)
  • $0.01 USD per event (Minimum pricing tier)

[!NOTE] Proxy & Platform Costs: Spanish residential proxies (groups: ['RESIDENTIAL'], countryCode: 'ES') are automatically routed for BOE requests. Outgoing platform costs (compute units, residential proxy bandwidth) are fully absorbed by the developer and covered by this PPE pricing, guaranteeing stable proptech margins with no hidden fees for the user.

---

🙋 Frequently Asked Questions

Why does the official cadastral value show as a null or "-" value?

For an inmueble (real estate property) in Spain, el valor catastral (the cadastral value) is protected under la Ley de Protección de Datos (data privacy regulations). It is only accessible to the verified owner using a certificado digital (digital certificate) or Cl@ve. The public API services of the Catastro OVC (Oficina Virtual del Catastro) only return non-protected physical data (such as superficie construida, construction year, and property use) which are highly useful for valoraciones inmobiliarias (property valuations) but never include the financial valor catastral.

Why are some columns displaying "5 fields" or similar text?

Apify Console’s Table View lists all root properties. To keep the spreadsheet clean and avoid displaying unreadable columns with '5 fields' for complex objects, the Actor packages the original, deeply-nested JSON blocks inside the _json_mcp_desarrolladores column. This is a technical column designed for agentes de Inteligencia Artificial (AI agents), developers, and Model Context Protocol integrations. If you are a human inversor (investor) inspecting the Table View or exporting to Excel/CSV, you can completely ignore this column, since all key metrics are already flattened at the root level.

How does the Actor find the referencia catastral if it is missing?

In Spanish foreclosures (subastas judiciales), the court records (cuenta de expediente) sometimes fail to publish the referencia catastral (cadastral reference) explicitly. The Actor scans the descripción del bien (property description) and legal notes using advanced regex heuristics to extract the 20-character code. If no referencia catastral is found or the cadastre service is down, the Actor returns "No consta" and falls back gracefully (caída en cascada), avoiding crawler crashes so you don't lose your scraping progress.

What does the valor de tasación represent?

The valor de tasación is the official appraisal value of the inmueble determined by the court before the auction (subasta BOE) begins. The Actor extracts this value from the general info tab. If the court doesn't explicitly publish the tasación, the Actor falls back to the valor subasta (auction value) or the cantidad reclamada (claimed debt) to calculate the investment score.

How can I filter the results by province using the dropdown?

You can easily select your target provincia (such as Madrid (28), Barcelona (08), or Sevilla (41)) from the interactive dropdown list in the Actor's input interface. If you want to run a search across the entire country (toda España), select the 'Todas / All Spain' option.

How does the Pay-Per-Event (PPE) charging model work?

This Actor charges on a pago por evento (PPE) basis. You only pay for each subasta consolidada e inmueble enriquecido (consolidated auction and enriched property) successfully saved to the dataset. If a search yields zero results, you are not charged, ensuring eficiencia de costes (cost efficiency) for your investment pipeline.

Can I run this Actor as a Model Context Protocol (MCP) tool?

Yes! This Actor is totalmente compatible con MCP (fully compatible with MCP). You can connect it to your local LLM client (like Cursor or Claude Desktop) via mcp.apify.com. This allows your AI agents to perform complex queries such as: 'Búscame subastas inmobiliarias en Valencia con un score de inversión ALTO y una puja mínima de menos de 100.000€'.