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
追加
complete_checkout
2026年9月17日12:37
追加
update_checkout
2026年9月17日12:37
追加
get_checkout
2026年9月17日12:37
追加
create_checkout
2026年9月17日12:37
追加
nota_simple_pedir
2026年9月17日12:37
追加
nota_simple_estado
2026年9月17日12:37
追加
notas_simples_listar
2026年9月17日12:37
追加
mi_cuenta
2026年9月17日12:37
追加
favoritos_quitar
2026年9月17日12:37
追加
favoritos_anadir
2026年9月17日12:37
追加
favoritos_listar
2026年9月17日12:37
追加
alertas_activar
2026年9月17日12:37
追加
alertas_eliminar
2026年9月17日12:37
追加
alertas_editar
2026年9月17日12:37
追加
alertas_crear
2026年9月17日12:37
追加
alertas_previsualizar
2026年9月17日12:37
追加
alertas_listar
2026年9月17日12:37
追加
mercado
2026年9月17日12:37
追加
recomendaciones
2026年9月17日12:37
追加
similares
2026年9月17日12:37
追加
informe
2026年9月17日12:37
追加
analisis_subasta
2026年9月17日12:37
追加
fetch
2026年9月17日12:37
追加
search
2026年9月17日12:37
追加
planes
2026年9月17日12:37
追加
explicar_concepto
2026年9月17日12:37
追加
estadisticas_publicas
2026年9月17日12:37
追加
resultados_recientes
2026年9月17日12:37
追加
buscar_por_codigo
2026年9月17日12:37