Saltar al contenido
Demostración ficticia. Sin inmuebles, clientes ni agencias reales.Iniciar sesión
Speaking BricksUna red inmobiliaria profesional
Registrarse con invitación
Menú

Interfaces abiertas

Registros públicos para personas y sistemas.

Solo los inmuebles autorizados como públicos están disponibles de forma anónima. La información profesional requiere una cuenta verificada y un token limitado.

Última actualización:

Leer un inmueble sin conectar nada.

Las páginas legibles por IA no garantizan la indexación en buscadores ni su inclusión en una respuesta de IA.

Cada inmueble abierto tiene una dirección estable. Las personas ven una página; los asistentes de IA y los buscadores reciben el mismo registro en Markdown, JSON o JSON-LD, sin iniciar sesión.

Conectar un asistente de IA.

Añade el servidor MCP público como conector personalizado en Claude, ChatGPT o cualquier cliente MCP. No hace falta iniciar sesión. Busca inmuebles abiertos y devuelve los motivos, lo que se desconoce y la agencia responsable.

listing.searchdatabase.queryproperty.getproperty.compareproperty.verify_availabilityproperty.get_evidenceproperty.contact_representative

Los profesionales verificados usan un token con permisos limitados para consultar solicitudes anónimas de compradores autorizadas y el estado de las conexiones. El acceso a inmuebles off-market requiere además la autorización explícita del vendedor para asistentes de IA.

  • MCPhttps://speakingbricks.eu/mcp

Crear una integración.

La API REST pública devuelve las mismas respuestas, con los mismos derechos verificados, que el servidor MCP. Su descripción OpenAPI funciona con GPT Actions y generadores de código.

  • OpenAPIhttps://speakingbricks.eu/v1/openapi.json
  • POSThttps://speakingbricks.eu/v1/property-searches
  • POSThttps://speakingbricks.eu/v1/database-queries
  • GEThttps://speakingbricks.eu/v1/properties/{id}
  • GEThttps://speakingbricks.eu/v1/properties/{id}/availability
  • GEThttps://speakingbricks.eu/v1/properties/{id}/evidence
  • GEThttps://speakingbricks.eu/v1/properties/{id}/contact-route

Las páginas JSONL firmadas y el feed de cambios con cursor permiten sincronizar datos públicos. Los cambios son actualizaciones observadas, no un historial completo de cada edición. Quien recibe los datos debe volver a comprobar la autorización antes de reutilizarlos.

Usarlo desde la página.

Cada página de inmueble abierto ofrece también tres herramientas de solo lectura a los agentes de navegador compatibles con WebMCP: leer el registro, comprobar la disponibilidad y obtener la vía de contacto. Usan la misma API, así que la respuesta es la misma.

Lo que los clientes públicos nunca reciben.

Las herramientas públicas solo devuelven inmuebles abiertos cuya autorización sigue vigente. La identidad privada de los clientes nunca se expone mediante estas herramientas. Cada verificación indica el rol profesional de quien la comunicó y la fecha; las verificaciones pendientes siguen siendo desconocidas.

Prueba una integración de lectura

Estos ejemplos usan la demostración ficticia online. No necesitas una cuenta ni una clave de API. Los resultados dependen de los permisos de publicación y de la disponibilidad actuales; el número de coincidencias puede cambiar.

Buscar por municipio, presupuesto y dormitorios

curl --fail-with-body 'https://speakingbricks.eu/v1/property-searches' \
  -H 'Content-Type: application/json' \
  --data '{"municipalities":["Cascais"],"max_price_eur":900000,"min_bedrooms":3,"limit":5}'

Leer el registro y sus verificaciones

curl --fail-with-body 'https://speakingbricks.eu/properties/L-DEMO-01.md'
curl --fail-with-body 'https://speakingbricks.eu/v1/properties/L-DEMO-01/evidence'
curl --fail-with-body 'https://speakingbricks.eu/v1/properties/L-DEMO-01/availability'

Sustituye L-DEMO-01 por un listing_id devuelto en la búsqueda. Comprueba el rol de quien informó, la fecha, las verificaciones desconocidas y la disponibilidad actual antes de mostrar una respuesta al usuario.

Mantener actualizada la copia de un socio

curl --fail-with-body 'https://speakingbricks.eu/feeds/open-listings.json'

Sigue el enlace next del feed para obtener las páginas siguientes. Para la sincronización incremental, usa los endpoints de snapshot firmado y cambios indicados arriba. Aplica los avisos de eliminación, consulta los registros actuales y elimina las copias no disponibles o caducadas. El feed recoge cambios observados; no es un historial completo ni una garantía demostrada de entrega en cinco minutos.

Conectar mediante un cliente MCP

Usa un SDK MCP o un cliente compatible con Streamable HTTP, que gestiona la inicialización y la negociación del protocolo. Usa la cabecera Accept: application/json, text/event-stream; usa Content-Type: application/json en las solicitudes JSON. Un HTTP 202 puede confirmar una notificación; no demuestra que una búsqueda haya terminado.

Gestionar permisos y errores

Los registros privados o no disponibles no devuelven detalles públicos. Un 404 puede indicar un registro inexistente o que ha dejado de ser público; no deduzcas cuál es el caso. Los filtros inválidos devuelven un error del cliente. Respeta los límites 429 y Retry-After cuando esté presente. Comprueba la disponibilidad al usar los datos; un resultado en caché no es un permiso permanente.

Conectar la agencia conservando los documentos de sus clientes

El área profesional permite entrada manual, importación CSV y exportaciones limitadas a la agencia. Los documentos y la relación con el cliente permanecen con el profesional. Un conector CRM real necesita un mapeo de campos acordado, reglas de autorización y un proceso de eliminación probado. La sincronización CRM bidireccional automática y las asociaciones colaboradoras no están activas en esta demostración.

¿Una IA lo encuentra sin recibir un enlace?

Las páginas y enlaces públicos ayudan al descubrimiento; estas APIs permiten integraciones explícitas. No garantizan la indexación por buscadores ni las citas de asistentes. Mide esos resultados por separado con la inspección de URL y pruebas guardadas sin proporcionar enlaces.