MCP 서버

Subastech — subastas judiciales de inmuebles (BOE)

com.subastech/subastas-judiciales

이 MCP로 할 수 있는 일

Searches and analyzes Spanish BOE judicial real-estate auctions, with property details, viability reports, alerts, market statistics, favorites, registral notes, and paid checkout.

alertas_activar
Activar o pausar una alerta
Activa o pausa una alerta tuya sin borrarla. Requiere cuenta verificada (scope `alertas:write`).
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'activa'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la alerta (de `alertas_listar`).'}, 'activa': {'type': 'boolean', 'description': '`true` reanuda la alerta; `false` la pausa sin borrarla.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'activa': {'type': 'boolean'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_crear
Crear una alerta
Crea una alerta de subastas (criterios, tipos de aviso, cadencia, canales). Requiere cuenta verificada (scope `alertas:write`). Envía un correo de confirmación al crearla. Límite de alertas y canales según el plan (`ajustes`). Previsualiza antes con `alertas_previsualizar`.
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['nombre', 'criterios', 'tipos', 'cadencia', 'canales'], 'properties': {'tipos': {'type': 'array', 'items': {'enum': ['new', 'price_drop', 'ending', 'status'], 'type': 'string'}, 'minItems': 1, 'description': '`new`, `price_drop`, `ending`, `status`'}, 'nombre': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Nombre de la alerta'}, 'canales': {'type': 'array', 'items': {'enum': ['inapp', 'email', 'push', 'telegram', 'webhook'], 'type': 'string'}, 'description': '`inapp` siempre; `email`; `push`/`telegram`/`webhook` según el plan'}, 'cadencia': {'enum': ['instant', 'daily', 'weekly'], 'type': 'string', 'description': '`instant` requiere plan Pro (si no, pasa a `daily`)'}, 'criterios': {'type': 'object', 'properties': {'m2Max': {'type': 'number', 'minimum': 0}, 'm2Min': {'type': 'number', 'minimum': 0}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'description': 'Palabras clave (máx. 10Ã\x9740). NO filtran por zona: usa provincia/municipio'}, 'occupied': {'type': 'boolean', 'description': 'Solo ocupadas (true) o solo libres (false)'}, 'priceMax': {'type': 'number', 'minimum': 0}, 'priceMin': {'type': 'number', 'minimum': 0}, 'scoreMin': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Scoring mÃ\xadnimo (0-100): requiere plan Pro'}, 'propertyTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 20, 'description': 'Valores EXACTOS del recurso `subastech://tipos-de-inmueble`'}, 'provinceSlugs': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 60, 'description': 'Slugs de provincia'}, 'discountMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Descuento mÃ\xadnimo sobre tasación (%): requiere plan Pro'}, 'priceDropMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Para el tipo `price_drop`: bajada mÃ\xadnima (%)'}, 'endingWithinDays': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Para el tipo `ending`: dÃ\xadas antes del fin'}, 'municipalityKeys': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 100, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas`)'}}, 'description': 'Filtros que debe cumplir una subasta para disparar la alerta: provincias, municipios, tipo de inmueble, precio, superficie y ocupación.', 'additionalProperties': False}, 'quiet_hours': {'type': 'object', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'days': {'type': 'array', 'items': {'type': 'integer', 'maximum': 6, 'minimum': 0}, 'maxItems': 7, 'description': '0 = domingo â\x80¦ 6 = sábado'}, 'from': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'paused': {'type': 'boolean'}}, 'description': 'Franja en la que no se envÃ\xadan avisos. `paused` la desactiva; `from` y `to` en formato HH:MM; `days` con 0 = domingo â\x80¦ 6 = sábado.', 'additionalProperties': False}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'url'], 'properties': {'id': {'type': 'string'}, 'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'avisos': {'type': 'array', 'items': {'type': 'object', 'required': ['message'], 'properties': {'fix': {}, 'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': {}}}, 'ajustes': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_editar
Editar una alerta
Modifica una alerta existente (nombre, criterios, tipos, cadencia, canales, horas de silencio). Requiere cuenta verificada (scope `alertas:write`). No envía correo.
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'nombre', 'criterios', 'tipos', 'cadencia', 'canales'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la alerta a modificar (de `alertas_listar`).'}, 'tipos': {'type': 'array', 'items': {'enum': ['new', 'price_drop', 'ending', 'status'], 'type': 'string'}, 'minItems': 1, 'description': '`new`, `price_drop`, `ending`, `status`'}, 'nombre': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Nombre de la alerta'}, 'canales': {'type': 'array', 'items': {'enum': ['inapp', 'email', 'push', 'telegram', 'webhook'], 'type': 'string'}, 'description': '`inapp` siempre; `email`; `push`/`telegram`/`webhook` según el plan'}, 'cadencia': {'enum': ['instant', 'daily', 'weekly'], 'type': 'string', 'description': '`instant` requiere plan Pro (si no, pasa a `daily`)'}, 'criterios': {'type': 'object', 'properties': {'m2Max': {'type': 'number', 'minimum': 0}, 'm2Min': {'type': 'number', 'minimum': 0}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'description': 'Palabras clave (máx. 10Ã\x9740). NO filtran por zona: usa provincia/municipio'}, 'occupied': {'type': 'boolean', 'description': 'Solo ocupadas (true) o solo libres (false)'}, 'priceMax': {'type': 'number', 'minimum': 0}, 'priceMin': {'type': 'number', 'minimum': 0}, 'scoreMin': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Scoring mÃ\xadnimo (0-100): requiere plan Pro'}, 'propertyTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 20, 'description': 'Valores EXACTOS del recurso `subastech://tipos-de-inmueble`'}, 'provinceSlugs': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 60, 'description': 'Slugs de provincia'}, 'discountMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Descuento mÃ\xadnimo sobre tasación (%): requiere plan Pro'}, 'priceDropMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Para el tipo `price_drop`: bajada mÃ\xadnima (%)'}, 'endingWithinDays': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Para el tipo `ending`: dÃ\xadas antes del fin'}, 'municipalityKeys': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 100, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas`)'}}, 'description': 'Filtros que debe cumplir una subasta para disparar la alerta: provincias, municipios, tipo de inmueble, precio, superficie y ocupación.', 'additionalProperties': False}, 'quiet_hours': {'type': 'object', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'days': {'type': 'array', 'items': {'type': 'integer', 'maximum': 6, 'minimum': 0}, 'maxItems': 7, 'description': '0 = domingo â\x80¦ 6 = sábado'}, 'from': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'paused': {'type': 'boolean'}}, 'description': 'Franja en la que no se envÃ\xadan avisos. `paused` la desactiva; `from` y `to` en formato HH:MM; `days` con 0 = domingo â\x80¦ 6 = sábado.', 'additionalProperties': False}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'url'], 'properties': {'id': {'type': 'string'}, 'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'avisos': {'type': 'array', 'items': {'type': 'object', 'required': ['message'], 'properties': {'fix': {}, 'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': {}}}, 'ajustes': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_eliminar
Eliminar una alerta
Elimina una alerta tuya de forma permanente. Requiere cuenta verificada (scope `alertas:write`).
파괴적 작업 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la alerta a eliminar (de `alertas_listar`).'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_listar
Listar mis alertas
Lista tus alertas de subastas con sus criterios, tipos de aviso, cadencia, canales y estado. Requiere cuenta (scope `alertas:read`). Paginada (`pagina`, `por_pagina`; máximo 20 por página): usa `total`, `paginas` y `hasMore` para pedir la siguiente.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; 1 por defecto)'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20; 20 por defecto)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['alertas', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'total': {'type': 'number'}, 'pagina': {'type': 'number'}, 'alertas': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'nombre', 'criterios', 'tipos', 'cadencia', 'canales', 'activa'], 'properties': {'id': {'type': 'string'}, 'tipos': {'type': 'array', 'items': {'type': 'string'}}, 'activa': {'type': 'boolean'}, 'nombre': {'type': 'string'}, 'canales': {'type': 'array', 'items': {'type': 'string'}}, 'cadencia': {'type': 'string'}, 'criterios': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'descripcion': {'type': 'string'}, 'quiet_hours': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ultima_notificacion': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
alertas_previsualizar
Previsualizar una alerta
Antes de crear una alerta: cuántas subastas coinciden ahora con los criterios, una muestra y avisos con `fix` aplicable (criterios sospechosos). Requiere cuenta (scope `alertas:read`). Los criterios avanzados (`scoreMin`, `discountMinPct`) requieren plan Pro; si no, se ignoran y se informa en `ajustes`.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['criterios'], 'properties': {'criterios': {'type': 'object', 'properties': {'m2Max': {'type': 'number', 'minimum': 0}, 'm2Min': {'type': 'number', 'minimum': 0}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'description': 'Palabras clave (máx. 10Ã\x9740). NO filtran por zona: usa provincia/municipio'}, 'occupied': {'type': 'boolean', 'description': 'Solo ocupadas (true) o solo libres (false)'}, 'priceMax': {'type': 'number', 'minimum': 0}, 'priceMin': {'type': 'number', 'minimum': 0}, 'scoreMin': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Scoring mÃ\xadnimo (0-100): requiere plan Pro'}, 'propertyTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 20, 'description': 'Valores EXACTOS del recurso `subastech://tipos-de-inmueble`'}, 'provinceSlugs': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 60, 'description': 'Slugs de provincia'}, 'discountMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Descuento mÃ\xadnimo sobre tasación (%): requiere plan Pro'}, 'priceDropMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Para el tipo `price_drop`: bajada mÃ\xadnima (%)'}, 'endingWithinDays': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Para el tipo `ending`: dÃ\xadas antes del fin'}, 'municipalityKeys': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 100, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas`)'}}, 'description': 'Filtros que debe cumplir una subasta para disparar la alerta: provincias, municipios, tipo de inmueble, precio, superficie y ocupación.', 'additionalProperties': False}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['criterios_limpios', 'coinciden', 'muestra', 'avisos', 'ajustes'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'avisos': {'type': 'array', 'items': {'type': 'object', 'required': ['message'], 'properties': {'fix': {}, 'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': {}}}, 'ajustes': {'type': 'array', 'items': {'type': 'string'}}, 'muestra': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'coinciden': {'type': 'object', 'required': ['count', 'capped'], 'properties': {'count': {'type': 'number'}, 'capped': {'type': 'boolean'}}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'criterios_limpios': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': {}}
analisis_subasta
Análisis de una subasta (veredicto y ejes)
Veredicto de viabilidad y ejes (cargas, posesión, rentabilidad, titularidad) de una subasta. Requiere cuenta (scope `informes:read`) y plan Pro o superior; con Radar/Starter devuelve `locked` con `upgradeUrl`. No consume cuota.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subasta', 'analisis_listo', 'informe_url'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'ejes': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'locked': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'subasta': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'veredicto': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'informe_url': {'type': 'string'}, 'analisis_listo': {'type': 'boolean', 'description': 'false si polSaaS aún está generando el veredicto'}}, 'additionalProperties': {}}
buscar_por_codigo
Buscar por referencia catastral, CRU, IDUFIR o BOE
Localiza subastas del BOE a partir de códigos: referencia catastral, CRU, IDUFIR o identificador BOE (hasta 5). Pública, sin cuenta; sin cuenta solo devuelve fichas vigentes en el catálogo público (con cuenta, también las archivadas con `archivada: true`).
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['codigos'], 'properties': {'codigos': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 3}, 'maxItems': 5, 'minItems': 1, 'description': 'Referencias catastrales, CRU, IDUFIR o identificadores BOE (1..5)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items', 'no_encontrados'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'archivada': {'type': 'boolean'}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}, 'no_encontrados': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}
buscar_subastas
Buscar subastas
Busca subastas judiciales de inmuebles del BOE por provincia, municipio, tipo, precio, superficie, texto libre, zona (bbox o radio) y estado. Pública, sin cuenta: devuelve datos oficiales del BOE y la URL de cada ficha. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`. Sin plan con scoring, `orden: score` pasa a `recent` y `solo_viables` se ignora (campo `degradado`). Máximo 20 por página (`por_pagina`, o su alias `limite`); no acepta parámetros que no estén declarados.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'bbox': {'type': 'object', 'required': ['oeste', 'sur', 'este', 'norte'], 'properties': {'sur': {'type': 'number'}, 'este': {'type': 'number'}, 'norte': {'type': 'number'}, 'oeste': {'type': 'number'}}, 'description': 'Zona rectangular en grados (lon/lat)', 'additionalProperties': False}, 'tipo': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 10, 'description': 'Tipos de inmueble, valores EXACTOS de `estadisticas_publicas.tipos` (p. ej. `Vivienda`, `Garaje`)'}, 'cerca': {'type': 'object', 'required': ['lat', 'lon', 'km'], 'properties': {'km': {'type': 'number', 'maximum': 50, 'exclusiveMinimum': 0}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180}}, 'description': 'Radio alrededor de un punto (máximo 50 km)', 'additionalProperties': False}, 'orden': {'enum': ['recent', 'ending', 'discount', 'price', 'score'], 'type': 'string', 'description': '`recent` (por defecto), `ending`, `discount`, `price`; `score` solo con plan Pro (si no, pasa a `recent`)'}, 'texto': {'type': 'string', 'maxLength': 120, 'description': 'Texto libre (calle, barrio, juzgadoâ\x80¦), máximo 120 caracteres'}, 'estado': {'enum': ['activas', 'todas', 'adjudicadas', 'desiertas'], 'type': 'string', 'description': '`activas` (por defecto), `todas`, `adjudicadas` o `desiertas`'}, 'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; máximo 25 sin cuenta, 50 con cuenta)'}, 'area_max': {'type': 'number', 'minimum': 0, 'description': 'Superficie construida máxima (m²)'}, 'area_min': {'type': 'number', 'minimum': 0, 'description': 'Superficie construida mÃ\xadnima (m²)'}, 'municipio': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 20, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas` con `municipio_q`)'}, 'provincia': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 10, 'description': 'Slugs de provincia (p. ej. [`madrid`, `barcelona`]); ver `estadisticas_publicas`'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20)'}, 'precio_max': {'type': 'number', 'minimum': 0, 'description': 'Valor de subasta máximo (euros)'}, 'precio_min': {'type': 'number', 'minimum': 0, 'description': 'Valor de subasta mÃ\xadnimo (euros)'}, 'solo_viables': {'type': 'boolean', 'description': 'Ocultar las no recomendables: solo con plan Pro (si no, se ignora)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'total': {'type': 'number'}, 'locked': {'type': 'object', 'properties': {'scoring': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'pagina': {'type': 'number'}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'degradado': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
cancel_checkout
Cancelar checkout (UCP)
Cancela una sesión de checkout UCP abierta (libera cualquier borrador de pedido). Una sesión completada o cancelada no cambia. Requiere meta['idempotency-key'] además de meta['ucp-agent'].
파괴적 작업 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a cancelar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
complete_checkout
Completar checkout (UCP)
Completa una sesión de checkout UCP. Sin manejador de pago nativo: si checkout.payment.instruments[] trae una credencial Shared Payment Token de Stripe (handler_id 'stripe', credential.token 'spt_…') se cobra y se entrega al instante; si no, la sesión pasa a requires_escalation y el comprador termina en continue_url. Un informe incluido en el plan se completa sin cobro. Requiere meta['idempotency-key'] además de meta['ucp-agent'].
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a completar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}, 'checkout': {'type': 'object', 'properties': {'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'type': {'type': 'string', 'maxLength': 80}, 'selected': {'type': 'boolean'}, 'credential': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': {}}, 'handler_id': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': {}}, 'maxItems': 10}}, 'additionalProperties': {}}, 'signals': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'description': 'Datos finales del pedido si han cambiado. AquÃ\xad viaja la credencial de pago: un Shared Payment Token de Stripe en `payment.instruments[]` se cobra al instante.', 'additionalProperties': {}}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
create_checkout
Crear checkout (UCP)
Crea una sesión de checkout UCP 2026-08-25 para comprar un informe de viabilidad, una nota simple registral o una suscripción de Subastech. Productos (item.id): informe:basico:<publicId> (49 € o incluido según plan), informe:completo:<publicId> (79 € o incluido), nota-simple:<publicId> o nota-simple:cru:<14 dígitos> (20 €, solo se cobra con el PDF verificado) y plan:<starter|pro|team|enterprise>:<month|year> (la suscripción se completa en el navegador). Un producto por sesión, quantity 1. Precios con IVA. Indica checkout.buyer.email: se crea o vincula la cuenta del comprador y recibe un enlace de acceso por correo (o autentícate con un token de Subastech). Devuelve el objeto Checkout (status, line_items, totals, messages, links). Requiere meta['ucp-agent'] = { profile: 'https://<plataforma>/.well-known/ucp' } (identificación de la plataforma UCP).
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'checkout'], 'properties': {'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}, 'checkout': {'type': 'object', 'required': ['line_items'], 'properties': {'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'context': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'type': {'type': 'string', 'maxLength': 80}, 'selected': {'type': 'boolean'}, 'credential': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': {}}, 'handler_id': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': {}}, 'maxItems': 10}}, 'additionalProperties': {}}, 'signals': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['item'], 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'item': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Identificador del producto: informe:basico:<publicId>, informe:completo:<publicId>, nota-simple:<publicId>, nota-simple:cru:<14 dÃ\xadgitos> o plan:<key>:<month|year>'}}, 'additionalProperties': {}}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 1000000, 'minimum': 1}}, 'additionalProperties': {}}, 'maxItems': 10, 'minItems': 1}, 'attribution': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'description': 'Contenido del pedido: `line_items` con los productos del catálogo (1-10) y, opcionalmente, `buyer` y `payment`.', 'additionalProperties': {}}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
estadisticas_publicas
Estadísticas públicas del catálogo
Totales del catálogo, provincias con subastas activas e históricas, tipos de inmueble (valores EXACTOS para filtrar) y búsqueda de municipios (claves `provincia:municipio`). Pública, sin cuenta. No incluye estadísticas de mercado (herramienta `mercado`, plan Pro).
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'estado': {'enum': ['activas', 'historicas'], 'type': 'string', 'description': 'Ã\x81mbito de los tipos de inmueble'}, 'municipio_q': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': 'Buscar municipios por nombre (â\x89¥2 caracteres)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['totales', 'provincias', 'tipos'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'tipos': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'n'], 'properties': {'n': {'type': 'number'}, 'type': {'type': 'string'}}, 'additionalProperties': {}}}, 'totales': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'municipios': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'name', 'province', 'auctionCount', 'url'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'province': {'type': 'string'}, 'auctionCount': {'type': 'number'}}, 'additionalProperties': {}}}, 'provincias': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'active', 'historical', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'active': {'type': 'number'}, 'historical': {'type': 'number'}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
explicar_concepto
Explicar un concepto de subastas judiciales
Explica un concepto de las subastas judiciales en España (depósito, cargas, posesión, cesión de remate, tipos de subasta…) desde la base de conocimiento de Subastech, redactada por personas. Pública, sin cuenta; sin modelo de lenguaje.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pregunta'], 'properties': {'pregunta': {'type': 'string', 'maxLength': 400, 'minLength': 2, 'description': 'Concepto o pregunta (p. ej. «qué es la cesión de remate»)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['concepto'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'fuente': {'type': 'string'}, 'concepto': {'anyOf': [{'type': 'object', 'required': ['id', 'respuesta_md'], 'properties': {'id': {'type': 'string'}, 'titulo': {'type': 'string'}, 'respuesta_md': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'disclosure': {'type': 'string'}, 'sugerencia': {'type': 'string'}, 'relacionados': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}
favoritos_anadir
Guardar en favoritos
Guarda una subasta en tus favoritos. Requiere cuenta (scope `favoritos:write`). Radar y Starter solo pueden guardar subastas activas (`fav.historico` es Pro+).
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'favorito'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'favorito': {'type': 'boolean'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
favoritos_listar
Listar mis favoritos
Subastas que has guardado como favoritas. Requiere cuenta (scope `favoritos:read`). Paginada (`pagina`, `por_pagina`; máximo 20 por página): usa `total`, `paginas` y `hasMore` para pedir la siguiente. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; 1 por defecto)'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20; 20 por defecto)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'total': {'type': 'number'}, 'pagina': {'type': 'number'}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
favoritos_quitar
Quitar de favoritos
Quita una subasta de tus favoritos. Requiere cuenta (scope `favoritos:write`).
파괴적 작업 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'favorito'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'favorito': {'type': 'boolean'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
fetch
Fetch (ChatGPT)
Lee una ficha de subasta por `id` (compatible con la búsqueda profunda de ChatGPT): `id`, `title`, `text` con los datos públicos del BOE en Markdown, `url` y `metadata`. Pública, sin cuenta. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 400, 'minLength': 1, 'description': '`id` devuelto por `search` (o URL de la ficha)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'title', 'text', 'url', 'metadata'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_checkout
Consultar checkout (UCP)
Devuelve el estado actual de una sesión de checkout UCP por id (incomplete, ready_for_complete, requires_escalation, complete_in_progress, completed, canceled), con messages, continue_url y order cuando existan. Requiere meta['ucp-agent'] = { profile: 'https://<plataforma>/.well-known/ucp' } (identificación de la plataforma UCP).
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a consultar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
informe
Informe de viabilidad
Informe de viabilidad de una subasta con las secciones que tu plan permite (resumen, cargas, descripción, catastro, calculadora, valoración, intervinientes, estadísticas); las cerradas se listan en `locked`. Requiere cuenta verificada (scope `informes:read`). Los tiers `basic`/`completo` solo se sirven si ya están desbloqueados: si no, devuelve `unlock_required` con la URL para desbloquearlos en el navegador (y, si el comercio para agentes está activo, `compra.paymentLink` para pagarlos por MPP). Nunca consume cuota ni cobra por sí misma. Parte del texto se genera con IA (`disclosure`).
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}, 'tier': {'enum': ['web', 'basic', 'completo'], 'type': 'string', 'description': '`web` (por defecto, según tu plan), `basic` o `completo` (solo si ya están desbloqueados)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subasta', 'tier', 'secciones', 'locked', 'analisis_listo', 'informe_url'], 'properties': {'ai': {'type': 'object', 'required': ['generated', 'system'], 'properties': {'note': {'type': 'string'}, 'system': {'type': 'string'}, 'generated': {'type': 'boolean'}}, 'additionalProperties': {}}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'tier': {'enum': ['web', 'basic', 'completo'], 'type': 'string'}, 'compra': {'type': 'object', 'required': ['paymentLink', 'precio_cents', 'moneda', 'instrucciones'], 'properties': {'moneda': {'type': 'string', 'const': 'EUR'}, 'paymentLink': {'type': 'string', 'description': 'URL de pago máquina (MPP/Stripe): POST â\x86\x92 402 con reto â\x86\x92 reintento con Shared Payment Token; en navegador, checkout humano'}, 'precio_cents': {'type': 'number'}, 'precio_label': {'type': 'string'}, 'instrucciones': {'type': 'object', 'required': ['agente', 'navegador'], 'properties': {'agente': {'type': 'string'}, 'navegador': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'locked': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'pdfUrl': {'type': 'string'}, 'subasta': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'secciones': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'unlock_url': {'type': 'string'}, 'informe_url': {'type': 'string'}, 'analisis_listo': {'type': 'boolean', 'description': 'false si polSaaS aún está generando el veredicto'}}, 'additionalProperties': {}}
mercado
Estadísticas de mercado
Estadísticas de mercado de subastas resueltas (tasa de adjudicación, descuento real, precios) por provincia y/o tipo de inmueble. Requiere cuenta (scope `informes:read`) y plan Pro o superior; si no, `plan_required` con `locked`.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'tipo': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': 'Tipo de inmueble (valor exacto)'}, 'provincia': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ambito', 'stats'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'stats': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ambito': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'locked': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'minimo': {'type': 'number'}, 'disclosure': {'type': 'string'}, 'muestra_insuficiente': {'type': 'boolean'}}, 'additionalProperties': {}}
mi_cuenta
Mi cuenta
Tu plan, cuota de informes, funciones disponibles, scopes del token, límites de uso y URLs útiles (precios, integraciones). Requiere cuenta (scope `cuenta:read`).
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['usuario', 'plan', 'funciones', 'token', 'limites', 'urls'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'org': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'plan': {'type': 'object', 'required': ['key', 'nombre'], 'properties': {'key': {'type': 'string'}, 'nombre': {'type': 'string'}, 'precio_mes': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'urls': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'token': {'type': 'object', 'required': ['kind', 'scopes'], 'properties': {'kind': {'type': 'string'}, 'client': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'scopes': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}, 'limites': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'usuario': {'type': 'object', 'required': ['email', 'nombre', 'verificado'], 'properties': {'email': {'type': 'string'}, 'nombre': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verificado': {'type': 'boolean'}}, 'additionalProperties': {}}, 'funciones': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'boolean'}}, 'disclosure': {'type': 'string'}, 'cuota_informes': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': {}}
nota_simple_estado
Estado de una nota simple
Estado de un pedido de nota simple registral y URL para verlo o descargar el PDF cuando esté listo. Requiere cuenta (scope `notas:read`).
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedido_id'], 'properties': {'pedido_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador del pedido devuelto por `nota_simple_pedir`.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedido', 'url'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'pedido': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
nota_simple_pedir
Pedir una nota simple
Inicia el pedido de la nota simple registral de una subasta (20 €, retención: solo se cobra con PDF verificado). Requiere cuenta verificada (scope `notas:write`) y que la subasta tenga CRU/IDUFIR (`not_orderable` si no). Devuelve `pedido_id` y la `url` donde el usuario confirma el pago en el navegador (y, si el comercio para agentes está activo, `paymentLink` para pagarlo por MPP); el pago nunca se completa desde aquí. Idempotente: si ya hay un pedido vivo devuelve `pedido_existente`. Máximo 20 inmuebles al día.
외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedido_id', 'url', 'siguiente_paso'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'compra': {'type': 'object', 'required': ['paymentLink', 'precio_cents', 'moneda', 'instrucciones'], 'properties': {'moneda': {'type': 'string', 'const': 'EUR'}, 'paymentLink': {'type': 'string', 'description': 'URL de pago máquina (MPP/Stripe): POST â\x86\x92 402 con reto â\x86\x92 reintento con Shared Payment Token; en navegador, checkout humano'}, 'precio_cents': {'type': 'number'}, 'precio_label': {'type': 'string'}, 'instrucciones': {'type': 'object', 'required': ['agente', 'navegador'], 'properties': {'agente': {'type': 'string'}, 'navegador': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'pedido_id': {'type': 'string'}, 'disclosure': {'type': 'string'}, 'paymentLink': {'type': 'string'}, 'precio_cents': {'type': 'number'}, 'siguiente_paso': {'type': 'string'}}, 'additionalProperties': {}}
notas_simples_listar
Listar mis notas simples
Pedidos de nota simple registral (20 €) con su estado. Requiere cuenta (scope `notas:read`). Paginada (`pagina`, `por_pagina`; máximo 20 por página): usa `total`, `paginas` y `hasMore` para pedir la siguiente.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; 1 por defecto)'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20; 20 por defecto)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedidos', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'total': {'type': 'number'}, 'pagina': {'type': 'number'}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'pedidos': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
planes
Planes y precios de Subastech
Planes de Subastech (Radar gratuito, Starter, Pro, Team, Enterprise) con precios y comparativa de funciones. Pública, sin cuenta.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['planes', 'comparativa', 'url'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'planes': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}, 'comparativa': {}}, 'additionalProperties': {}}
recomendaciones
Recomendaciones para ti
Subastas recomendadas según tu historial (tipo, precio, provincias), como el bloque «para ti» de la web. Requiere cuenta (scope `cuenta:read`). Con plan Pro o superior usa el ranking por scoring; si no, se construye con tu perfil y orden por fecha de fin.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'nota': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'titulo': {'type': 'string'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
resultados_recientes
Adjudicaciones recientes
Últimas subastas del BOE con resultado oficial (adjudicadas), opcionalmente por provincia, con el remate y el descuento real sobre la tasación (aritmética del BOE). Pública, sin cuenta. Máximo 15.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 15, 'minimum': 1, 'description': 'Máximo 15'}, 'provincia': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente', 'remate', 'descuento_real_pct'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'remate': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'descuento_real_pct': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
search
Search (ChatGPT)
Búsqueda en lenguaje natural de subastas judiciales del BOE (compatible con la búsqueda profunda de ChatGPT): devuelve `results` con `id`, `title` y `url`. Pública, sin cuenta. Usa `fetch` con el `id` para leer la ficha.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Búsqueda en lenguaje natural'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
similares
Subastas similares
Subastas parecidas a una dada (mismo tipo de inmueble, banda de precio, cercanía). Requiere cuenta (scope `informes:read`). Con plan Pro o superior se ordenan por scoring (`metodo: scoring`); si no, por fecha de fin (`metodo: publico`).
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}, 'limite': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Número máximo de subastas similares a devolver (1-10).'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['base', 'items', 'metodo'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'base': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'metodo': {'enum': ['scoring', 'publico'], 'type': 'string'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
subasta
Ficha de una subasta
Ficha pública de una subasta del BOE por identificador (10 caracteres), URL de app.subastech.com o identificador BOE (SUB-…): dirección, valores, fechas, resultado, lotes y un resumen citable. Pública, sin cuenta. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}, 'url': {'type': 'string', 'format': 'uri', 'maxLength': 400, 'description': 'URL de la ficha en app.subastech.com'}, 'boe_id': {'type': 'string', 'maxLength': 60, 'description': 'Identificador del BOE (p. ej. `SUB-JA-2026-123456`): devuelve todos los lotes'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subasta', 'resumen'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'lotes': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'locked': {'type': 'object', 'properties': {'scoring': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'resumen': {'type': 'string', 'description': 'Frase citable con los datos del BOE'}, 'subasta': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
update_checkout
Actualizar checkout (UCP)
Reemplaza el contenido de una sesión de checkout UCP (line_items y buyer) y recalcula precio y estado. No admite sesiones en complete_in_progress ni terminadas. Requiere meta['ucp-agent'] = { profile: 'https://<plataforma>/.well-known/ucp' } (identificación de la plataforma UCP).
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id', 'checkout'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a modificar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}, 'checkout': {'type': 'object', 'required': ['line_items'], 'properties': {'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'context': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'type': {'type': 'string', 'maxLength': 80}, 'selected': {'type': 'boolean'}, 'credential': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': {}}, 'handler_id': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': {}}, 'maxItems': 10}}, 'additionalProperties': {}}, 'signals': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['item'], 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'item': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Identificador del producto: informe:basico:<publicId>, informe:completo:<publicId>, nota-simple:<publicId>, nota-simple:cru:<14 dÃ\xadgitos> o plan:<key>:<month|year>'}}, 'additionalProperties': {}}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 1000000, 'minimum': 1}}, 'additionalProperties': {}}, 'maxItems': 10, 'minItems': 1}, 'attribution': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'description': 'Nuevo contenido del pedido, que sustituye al de la sesión abierta.', 'additionalProperties': {}}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
추가됨
cancel_checkout
2026년 9월 17일 12:37 PM
추가됨
complete_checkout
2026년 9월 17일 12:37 PM
추가됨
update_checkout
2026년 9월 17일 12:37 PM
추가됨
get_checkout
2026년 9월 17일 12:37 PM
추가됨
create_checkout
2026년 9월 17일 12:37 PM
추가됨
nota_simple_pedir
2026년 9월 17일 12:37 PM
추가됨
nota_simple_estado
2026년 9월 17일 12:37 PM
추가됨
notas_simples_listar
2026년 9월 17일 12:37 PM
추가됨
mi_cuenta
2026년 9월 17일 12:37 PM
추가됨
favoritos_quitar
2026년 9월 17일 12:37 PM
추가됨
favoritos_anadir
2026년 9월 17일 12:37 PM
추가됨
favoritos_listar
2026년 9월 17일 12:37 PM
추가됨
alertas_activar
2026년 9월 17일 12:37 PM
추가됨
alertas_eliminar
2026년 9월 17일 12:37 PM
추가됨
alertas_editar
2026년 9월 17일 12:37 PM
추가됨
alertas_crear
2026년 9월 17일 12:37 PM
추가됨
alertas_previsualizar
2026년 9월 17일 12:37 PM
추가됨
alertas_listar
2026년 9월 17일 12:37 PM
추가됨
mercado
2026년 9월 17일 12:37 PM
추가됨
recomendaciones
2026년 9월 17일 12:37 PM
추가됨
similares
2026년 9월 17일 12:37 PM
추가됨
informe
2026년 9월 17일 12:37 PM
추가됨
analisis_subasta
2026년 9월 17일 12:37 PM
추가됨
fetch
2026년 9월 17일 12:37 PM
추가됨
search
2026년 9월 17일 12:37 PM
추가됨
planes
2026년 9월 17일 12:37 PM
추가됨
explicar_concepto
2026년 9월 17일 12:37 PM
추가됨
estadisticas_publicas
2026년 9월 17일 12:37 PM
추가됨
resultados_recientes
2026년 9월 17일 12:37 PM
추가됨
buscar_por_codigo
2026년 9월 17일 12:37 PM