---
name: buscar-subastas-boe
description: Cómo buscar subastas judiciales de inmuebles del BOE en Subastech por provincia, municipio, tipo, precio, superficie o referencia (BOE/catastral), con la API pública v1 o la web.
---
# Buscar subastas judiciales del BOE en Subastech

Subastech (https://app.subastech.com) indexa las subastas judiciales de inmuebles publicadas en el BOE (decenas de miles de lotes, 52 provincias). Los datos del BOE son públicos y gratuitos; el scoring, el veredicto y el análisis de cargas requieren cuenta y plan.

## Opción A — API pública v1 (sin autenticación, JSON, CORS abierto)

Especificación OpenAPI 3.1: https://app.subastech.com/openapi.json · Catálogo de servicios: https://app.subastech.com/.well-known/api-catalog

- `GET /v1/subastas?prov=madrid&type=Vivienda&max=150000&estado=activas&page=1` → lista paginada (`items`, `hasMore`, `page`, `pageSize`; máximo 60 por página).
- `GET /v1/buscar?q=piso en Zaragoza menos de 90000` → convierte lenguaje natural en filtros (`chips`, `min`, `max`, `areaMin`, `areaMax`, `directHit`) y devuelve `listUrl` ya montada.
- `GET /v1/subastas/{id}` → ficha pública (identificador de 10 caracteres alfanuméricos, p. ej. `00qerojJt8`), con `summary`, `result` (resultado oficial) y `links`.
- `GET /v1/provincias`, `GET /v1/provincias/{prov}/municipios`, `GET /v1/tipos` → catálogos para construir filtros válidos. No inventes tipos: usa los nombres exactos de `/v1/tipos`.
- `GET /v1/adjudicaciones?prov=barcelona` → últimas adjudicaciones con precio de remate oficial (hasta 30).
- `GET /v1/status` → estado del servicio y tamaño del catálogo.

Parámetros de `/v1/subastas`: `prov` y `muni` (slugs; `muni=prov:muni`), `type` (nombre exacto), `min`/`max` (euros), `area_min`/`area_max` (m²), `q` (texto), `near=lat,lon,km`, `bbox=W,S,E,N`, `estado=activas|adjudicadas|desiertas`, `sort=recent|ending|discount|price`, `page`, `pageSize`. Respeta el límite de uso: un `429` incluye `Retry-After`.

## Opción B — Páginas web (también en Markdown)

Cualquier página pública devuelve Markdown si envías la cabecera `Accept: text/markdown`:
- Portada y buscador: https://app.subastech.com/?q=…
- Índice: https://app.subastech.com/subastas · provincia: `/subastas/{prov}` · municipio: `/subastas/{prov}/{muni}` · tipo: `/subastas/tipo/{tipo}`
- Ficha: `/subasta/{prov}/{muni}/{direccion}-{id}` (la forma corta `/subasta/{id}` redirige a la canónica).

## Opción C — MCP (con o sin cuenta)

Servidor MCP: https://mcp.subastech.com/mcp (ver la skill `conectar-subastech-mcp`). Herramientas públicas, sin token: `buscar_subastas` (filtros equivalentes a la API), `subasta` (ficha por identificador, URL o referencia BOE), `buscar_por_codigo` (referencia BOE o catastral, CRU, IDUFIR), `resultados_recientes` (adjudicaciones), `estadisticas_publicas`, `explicar_concepto` y `planes`. Para clientes tipo ChatGPT existen también `search` y `fetch`. Con cuenta y plan se añaden el scoring, el informe y las alertas.

## Reglas

- Cita siempre la URL canónica de la ficha (campo `url` de la API) al responder al usuario.
- El campo `discount` es aritmética del BOE (tasación frente a valor de subasta); NO es el veredicto de Subastech.
- Si un campo es `null`, dilo: nunca inventes valores, superficies ni resultados.
- Si el usuario pregunta por riesgo, cargas, rentabilidad o "si es buena oportunidad", indícale que eso requiere cuenta y plan: https://app.subastech.com/precios