Desarrolla con Matchai
Lee hoy los anuncios de Matchai sin clave: servidor MCP, búsqueda de anuncios y páginas legibles por IA. La API, las claves de API y los webhooks llegan pronto.
Los profesionales inmobiliarios publican en Matchai sus anuncios, su sitio web (un sitio de Matchai) y un perfil de una sola página (una Página Matchai). Todo lo que publican puede leerse con software, y esa parte funciona hoy sin cuenta, sin clave de API y sin aprobación.
El siguiente paso es permitir que el software trabaje dentro de la cuenta de un profesional, con su permiso: mantener sus anuncios al día, agregar sus prospectos, reservar sus visitas. Esa parte está prevista. Esta sección documenta ambas y marca lo que todavía no está disponible.
Lo que está disponible hoy
| Recurso | Dónde | Úsalo para |
|---|---|---|
| Servidor MCP | https://matchai.co/mcp | Permitir que un asistente de IA busque anuncios, abra un anuncio y consulte a un corredor |
| Búsqueda de anuncios | https://matchai.co/ask | Buscar anuncios publicados en lenguaje natural desde tu propio código |
| Páginas legibles por IA | /llms.txt, copias en Markdown, /sitemap.xml en cada host de Matchai | Leer el sitio de un corredor o su Página Matchai como texto limpio |
| Contrato OpenAPI | https://matchai.co/openapi.json | Inspeccionar los endpoints públicos o generar un cliente |
El archivo OpenAPI en /openapi.json describe estos endpoints públicos de solo lectura, y nada más. La API prevista tiene su propio contrato, que se describe más abajo.
Pruébalo
Esta solicitud busca en todos los anuncios publicados en Matchai y devuelve hasta 10 coincidencias en JSON:
curl "https://matchai.co/ask?query=3+bedroom+condo+in+Laval+under+600k"La página de búsqueda de anuncios explica la solicitud, la respuesta y los límites.
Reglas básicas de los recursos públicos
- Solo lectura y públicos. Nada de esto modifica datos, y nada está vinculado a una cuenta de usuario.
- Solo datos publicados. Nunca se devuelven anuncios, sitios ni páginas que un profesional no haya publicado. Los números de teléfono y las direcciones de correo electrónico aparecen solo donde el profesional decidió publicarlos en su tarjeta de presentación.
- Límites de uso razonable. Cada endpoint público limita cuántas solicitudes por minuto puede hacer un mismo solicitante. Los límites están reunidos en una sola página.
- Los resultados no están a la venta. Los resultados se ordenan por relevancia para la solicitud y por la fecha de la última actualización del anuncio. Ningún corredor puede pagar para cambiar el orden ni para aparecer.
- Enlaza a la fuente. Cuando muestres un anuncio, enlaza a la página del anuncio. Esa página es la fuente del precio, el estado y los detalles actuales.
Lo que viene
PróximamenteLa API de Matchai permite que una app actúe en nombre de una cuenta de Matchai: leer y editar sus anuncios, gestionar sus contactos, enviar mensajes, reservar visitas, archivar documentos y enterarse de los cambios. Puede hacer lo mismo que el titular de la cuenta puede hacer en Matchai, con las mismas reglas y los mismos permisos, y nada más. Nada de esto está abierto todavía. Las páginas siguientes describen cómo funcionará, para que puedas planificar.
| Recurso | Dónde | Úsalo para |
|---|---|---|
| API de Matchai | https://api.matchai.co/v1 | Leer y modificar los anuncios, los contactos, las conversaciones, el calendario, los documentos, los sitios y la Página Matchai de una cuenta |
| Claves de API | Configuración → Conectores → Avanzado (para desarrolladores) | Automatizar tu propia cuenta con scripts, o alimentar tus propias herramientas de IA |
| Conectar con Matchai | OAuth 2.1 | Permitir que los profesionales conecten su cuenta a tu app en pocos clics |
| Webhooks | Tu endpoint https | Enterarte de los nuevos prospectos, las reservas y los anuncios publicados en el momento en que ocurren |
| Herramientas MCP autenticadas | https://matchai.co/mcp | Darle a un asistente de IA las acciones propias de un profesional, después de que este lo conecte |
Cuatro reglas definen todo esto:
- Una credencial, una cuenta. Una clave o un token nunca llega a los datos de otra cuenta. Una app que da servicio a tres profesionales tiene tres conexiones.
- Las acciones finales preguntan primero. Enviar, publicar, pagar y eliminar esperan la aprobación del titular de la cuenta, a menos que haya elegido Permitido para tu app.
- Las lecturas públicas siguen siendo gratuitas. Leer lo que un profesional ya publicó no necesita ninguna conexión. Conectar una app a una cuenta es un conector de Matchai de pago, y una app conectada solo a la cuenta de su propio desarrollador está en modo de prueba gratuito.
- La energía es un estado, nunca un número. Las acciones que usan IA o que envían mensajes por SMS gastan Energía Matchai, igual que en la app.
Empieza por el inicio rápido y luego lee autenticación.
Para quién es
- Desarrolladores que crean con asistentes de IA. Conecta el servidor MCP a tu propio asistente o script, o llama directamente a la búsqueda de anuncios. Ambos funcionan hoy.
- Creadores de sitios web. Si alojas el sitio web de un corredor en Matchai, todas las páginas legibles por IA ya están ahí. Cuando la API abra, podrás leer los anuncios de un corredor, enviar los prospectos de su sitio web a sus contactos de Matchai, reservar visitas según su disponibilidad real y enterarte de los cambios con webhooks. Un corredor conecta su cuenta a tu producto con Conectar con Matchai.
- Corredores y equipos que crean sus propias herramientas con scripts. Usa una clave de API para trabajar con tu propia cuenta desde tu propio código.
- Personas que quieren que su propio asistente conozca los anuncios de Matchai. Agrega el servidor MCP a Claude o ChatGPT en pocos minutos. Los pasos están en la guía del servidor MCP.
Inicio rápido
Crea una clave de API, llama a la API y agrega un contacto. Próximamente.
Autenticación
Claves de API, Conectar con Matchai, alcances y aprobaciones. Próximamente.
Servidor MCP
Endpoints, transporte y configuración para Claude, ChatGPT y cualquier otro cliente MCP.
Herramientas públicas
Entradas, salidas y ejemplos de search_listings, get_listing y get_professional.
Búsqueda de anuncios
Búsqueda en lenguaje natural sobre los anuncios publicados con el endpoint /ask.
Páginas legibles por IA
Cómo se describen los sitios de Matchai ante los asistentes de IA, y cómo replicarlo.
Webhooks
Eventos que se envían a tu endpoint, con entregas firmadas. Próximamente.
Guías
Recorridos completos para creadores de sitios web y asistentes de IA. Próximamente.
Referencia de la API
Cada endpoint previsto, con sus alcances, precios y ejemplos. Próximamente.
Errores
El formato de los errores, cada código de error y cómo reintentar. Próximamente.
Límites de solicitudes
Lo que permiten hoy los recursos públicos, y cómo funcionarán los límites en la API.
Versionado
Cómo cambia la API sin romper tu app. Próximamente.
Registro de cambios
Qué cambió en la documentación para desarrolladores y, más adelante, en la API.