API y agentes de IA

1. API pública (JSON)

Base: https://api.vixoraai.com/public/v1 · OpenAPI 3.1. Solo acepta GET. Precios en pesos colombianos (COP); cada respuesta trae la URL canónica de la ficha.

Ejemplo: fincas en venta en Rionegro por menos de 900 millones

curl "https://api.vixoraai.com/public/v1/properties?type=finca&operation=venta&municipality=rionegro&price_max=900000000"

{
  "data": [
    {
      "code": "FIN-0012",
      "title": "Finca en venta con quebrada en Rionegro",
      "type": "finca",
      "operation": "venta",
      "price": { "amount": 850000000, "currency": "COP", "period": null },
      "location": { "municipality": "Rionegro", "department": "Antioquia", "vereda": "Cabeceras", "approximate": false },
      "areas": { "built_m2": 180, "lot_m2": 12000, "lot_ha": null },
      "bedrooms": 4,
      "url": "https://vixoraai.com/colombia/antioquia/rionegro/finca-en-venta-con-quebrada-a1b2c3",
      "markdown_url": "https://vixoraai.com/colombia/antioquia/rionegro/finca-en-venta-con-quebrada-a1b2c3.md"
    }
  ],
  "pagination": { "page": 1, "page_size": 20, "total": 1, "total_pages": 1, "next": null }
}

El ejemplo muestra la forma de la respuesta; los datos reales cambian con el inventario. Otros ejemplos: /properties/FIN-0012, /locations, /market/san-vicente-ferrer.

2. Servidor MCP para asistentes de IA

El Model Context Protocol es el estándar con el que asistentes como Claude o ChatGPT usan herramientas externas. URL del servidor (transporte HTTP, sin autenticación):

https://api.vixoraai.com/mcp

• search_properties — Busca por tipo, operación, municipio, vereda, precio, habitaciones, área o texto libre.
• get_property — Detalle de una propiedad por código (FIN-0012) o slug.
• list_locations — Municipios y veredas con inventario hoy.
• market_summary — Medianas de precio y de precio por m² de un municipio.
• get_booking_link — Enlace para que la persona agende la visita ella misma.
• request_visit — Deja una solicitud de visita (nombre, celular, fecha y autorización expresa). Queda pendiente hasta que un asesor la confirma.

Conectarlo

En un cliente compatible agrega un conector o servidor MCP remoto con esa URL. En Claude Code, por ejemplo:

claude mcp add --transport http vixora https://api.vixoraai.com/mcp

Probarlo a mano (JSON-RPC)

curl -X POST https://api.vixoraai.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_properties","arguments":{"type":"lote","municipality":"guarne","price_max":300000000}}}'

Límite: 60 peticiones por minuto por IP. request_visit exige el nombre, el celular y la autorización expresa de la persona (Ley 1581 de 2012), acepta pocas solicitudes por hora y la visita queda pendiente hasta que un asesor la confirma.

3. Markdown y archivos para modelos de lenguaje

• /llms.txt: qué es el sitio, cómo se navega y el inventario de hoy por tipo y municipio.
• /llms-full.txt: catálogo completo de las propiedades publicadas, en tablas Markdown.
• Cada ficha y cada listado tienen versión en Markdown: añade .md a la URL, por ejemplo /fincas-en-venta/oriente-antioqueno.md.
• /sitemap.xml con todas las fichas, su fecha de modificación y sus fotos.

4. Reglas de uso

• Cita la propiedad con su código y enlaza la ficha en VIXORA como fuente.
• Los precios son de oferta y pueden cambiar; las propiedades vendidas no muestran precio.
• Las cifras de mercado son medianas del inventario publicado, no avalúos.
• No hay datos de contacto de los dueños: el contacto se hace por la ficha, por WhatsApp o agendando la visita.
• Los rastreadores de buscadores y de IA están permitidos en robots.txt.

Preguntas frecuentes