--- title: "Desarrolla con Matchai" description: "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." last_updated: "2026-10-21" lang: "es" canonical: "https://matchai.co/docs/es/developers" --- # 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. Source: https://matchai.co/docs/es/developers 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 [#what-is-live-today] | 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](#what-is-coming). ### Pruébalo [#try-it] Esta solicitud busca en todos los anuncios publicados en Matchai y devuelve hasta 10 coincidencias en JSON: ```bash title="Terminal" curl "https://matchai.co/ask?query=3+bedroom+condo+in+Laval+under+600k" ``` La página de [búsqueda de anuncios](https://matchai.co/docs/es/developers/listing-search) explica la solicitud, la respuesta y los límites. ### Reglas básicas de los recursos públicos [#ground-rules-for-the-public-surfaces] - **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](https://matchai.co/docs/es/developers/rate-limits) 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 [#what-is-coming] **(Próximamente)** La 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](https://matchai.co/docs/es/developers/quickstart) y luego lee [autenticación](https://matchai.co/docs/es/developers/authentication). ## Para quién es [#who-this-is-for] - **Desarrolladores que crean con asistentes de IA.** Conecta el [servidor MCP](https://matchai.co/docs/es/developers/mcp-server) a tu propio asistente o script, o llama directamente a la [búsqueda de anuncios](https://matchai.co/docs/es/developers/listing-search). Ambos funcionan hoy. - **Creadores de sitios web.** Si alojas el sitio web de un corredor en Matchai, todas las [páginas legibles por IA](https://matchai.co/docs/es/developers/agent-readable-pages) 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](https://matchai.co/docs/es/developers/authentication/connect-with-matchai). - **Corredores y equipos que crean sus propias herramientas con scripts.** Usa una [clave de API](https://matchai.co/docs/es/developers/authentication/api-keys) 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](https://matchai.co/docs/es/developers/mcp-server#connect-an-assistant). Crea una clave de API, llama a la API y agrega un contacto. Próximamente. Claves de API, Conectar con Matchai, alcances y aprobaciones. Próximamente. Endpoints, transporte y configuración para Claude, ChatGPT y cualquier otro cliente MCP. Entradas, salidas y ejemplos de search_listings, get_listing y get_professional. Búsqueda en lenguaje natural sobre los anuncios publicados con el endpoint /ask. Cómo se describen los sitios de Matchai ante los asistentes de IA, y cómo replicarlo. Eventos que se envían a tu endpoint, con entregas firmadas. Próximamente. Recorridos completos para creadores de sitios web y asistentes de IA. Próximamente. Cada endpoint previsto, con sus alcances, precios y ejemplos. Próximamente. El formato de los errores, cada código de error y cómo reintentar. Próximamente. Lo que permiten hoy los recursos públicos, y cómo funcionarán los límites en la API. Cómo cambia la API sin romper tu app. Próximamente. Qué cambió en la documentación para desarrolladores y, más adelante, en la API. ## Sitemap - [Todas las páginas de la documentación de Matchai](https://matchai.co/docs/sitemap.md) - [llms.txt](https://matchai.co/docs/es/llms.txt)