# RADAR · Operador Hospitality Piloto público de investigación de casas completas en La Paz, Los Cabos y Chihuahua, en MXN. Una persona introduce los enlaces de su propiedad y una estancia; RADAR inicia la investigación en el servidor y entrega un resultado o un informe de cobertura parcial. No necesita contratar otro agente, copiar un encargo ni transportar archivos JSON. ## Entradas - Inicio de investigaciones restringido por invitación privada: X-Radar-Invite. Nunca copiar invitaciones a documentos, resultados o URLs. - Interfaz para personas: https://radaroperador.com/comparar/#investigacion - Capacidades y límites: https://radaroperador.com/api/v1/capacidades - Operación para integradores: https://radaroperador.com/agentes/operacion.md - Contrato HTTP: https://radaroperador.com/openapi.json - Prueba independiente: https://radaroperador.com/agentes/prueba-externa.txt - Protocolo de producto: https://radaroperador.com/agentes/evaluacion.md - Formato de observaciones: https://radaroperador.com/agentes/observaciones.md ## Flujo principal: investigación interna POST /api/v1/investigaciones recibe property:{name,publicUrls}, market (la-paz|los-cabos|chihuahua), checkin, checkout, adults, type:entire_home y maxCompetitors:20. PublicUrls contiene 1–5 enlaces públicos, uno por elemento; no hace falta proporcionar competidores. Content-Type: application/json. Idempotency-Key debe contener 32 bytes aleatorios criptográficos en hexadecimal o base64url; conservar la misma clave al reintentar exactamente la misma solicitud. La respuesta 202 contiene id, accessToken y statusUrl. Consultar GET statusUrl cada tres segundos con Authorization: Bearer . El token nunca va en parámetros de URL, enlaces públicos ni reportes. Una respuesta 202 acredita la admisión, no una búsqueda terminada ni precios encontrados. Estados: queued, running, completed, partial, failed y expired. Las fases comunicadas por el ejecutor incluyen profiling, discovering, quoting y evaluating; no son porcentajes ni garantía de cobertura. result contiene report, coverage y limitations; analysis solo existe si la evidencia permite construir el análisis. El dashboard sustituye el estudio anterior únicamente con el resultado del caso solicitado; un informe parcial sigue correspondiendo a esa propiedad. Nunca usar el estudio histórico de Altamar como resultado de una nueva consulta. El motor busca fuentes públicas y registra observaciones. Bloqueos de plataformas, páginas sin totales y datos incompletos pueden impedir cotizar: no se garantizan precios ni 20 competidores útiles. El despliegue del motor y una respuesta HTTP no prueban por sí solos que cotice correctamente cada plataforma. La prueba de aceptación de Naya (1–4 octubre 2026, seis adultos) está pendiente de verificación integral; esos parámetros no son una cotización publicada. ## Privacidad y capacidad del piloto Sin cuentas, suscripciones operativas ni perfiles sincronizados. Los resultados de investigaciones internas son privados mediante el token de acceso y caducan a las 24 horas desde su creación; no se publican en el catálogo. El navegador conserva la investigación de esta sesión para reanudarla. Guardar el resultado antes de su vencimiento si se necesita conservarlo. Capacidad global del piloto: cinco investigaciones por día UTC, una simultánea. No es una cuota por usuario ni un plan comercial de membresía. El modo Full admite como máximo 20 candidatos, no promete que todos sean comparables o tengan precios utilizables. Casas completas, MXN, sin menores, 1–30 adultos y 1–30 noches. No monitorización OTA programada, reservas, pagos, cambios de precios ni servidor MCP. POST investigaciones: JSON UTF-8 de hasta 32 KiB, sin compresión. Sin parámetros de consulta en creación ni lectura de trabajos. Errores 400/405/409/410/413/415/429/503 según el contrato; un acceso de lectura inexistente o incorrecto responde 404. Respetar Retry-After; no generar nuevos trabajos para forzar límites. Usar clientes HTTP de servidor o la propia web; no hay CORS abierto para páginas de otros dominios. Solo enlaces públicos HTTPS. No enviar credenciales, sesiones, paneles privados, huéspedes, enlaces de pago privados ni iCal. Los iCal no proporcionan tarifas ni prueban ocupación vendida. ## API opcional para integradores con evidencia propia POST /api/v1/encargos prepara un prompt: status=ready_for_external_agent, automaticExecution=false. Esta ruta no inicia la investigación interna. Solo sirve a integradores que eligen operar su propio agente. POST /api/v1/analisis valida {study,assessment?,selectedPropertyIds?} y calcula summary, classification, primaryBenchmark y contextBenchmark. Devuelve normalized, provenance=external_agent_submission, independentlyVerified=false y persisted=false. No visita ni autentica las fuentes recibidas. Máximo 512 KiB, 50 observaciones y 21 perfiles incluyendo la propiedad propia. Estas rutas son alternativas técnicas; el usuario de la web no tiene que utilizarlas ni importar JSON. ## Referencias directas y capturas: flujo separado - GET https://radaroperador.com/api/v1/referencias lee el catálogo almacenado. Parámetros: alojamiento, llegada, salida, adultos. retrieval.upstreamFetch=false: el GET no investiga las OTAs. La función programada de fuentes directas está configurada cada seis horas; las fechas y registros de ejecución demuestran cada actualización. - https://radaroperador.com/data/catalogo.json es una captura estática; cambiar parámetros no la renueva. - https://radaroperador.com/data/cobertura.json resume esa captura. - https://radaroperador.com/agentes/guia.md explica las clases de referencias y cálculos. - https://radaroperador.com/data/ejemplo-agente.json prueba el contrato sobre la captura, no una búsqueda nueva. Altamar y Marvela publican bases; Coronel conserva una instantánea; Plaza una propuesta; El Ganzo es editorial sin precio conectado. El catálogo no es un promedio del mercado ni vigilancia OTA. published_base no es total de estancia; published_proposal no es oferta confirmada; dated_snapshot conserva la fecha original. generatedAt, checkedAt y sourceUpdatedAt son distintos. availability:unknown y los bloqueos no acreditan disponibilidad, reservas ni demanda. Leer una tarifa antigua no renueva su fecha. ## Evidencia y estudios históricos - https://radaroperador.com/data/consultas/altamar-2026-11-05-full.json: estudio histórico de 24 observaciones y 20 candidatos únicos, con variantes y duplicados reconciliados. - https://radaroperador.com/data/evaluaciones/altamar-full.json: evaluación y portadas atribuidas de ese estudio. El ejemplo inicial del dashboard no ejecuta una búsqueda al abrirse. Conservar observedAt original, incluyendo observaciones importadas; nunca reemplazarlo por la hora de consulta. El rango principal requiere equivalencia acreditada, total completo, misma estancia y vigencia. El contexto admite diferencias explícitas. Elegir un candidato no certifica equivalencia. Los precios mayores de 24 horas quedan fuera del rango vigente. Ni una muestra pequeña ni tres ofertas representan por sí solas todo el mercado. No convertir datos ausentes en cero, bloqueos en demanda ni diferencias de precios en descuentos automáticos. Las fuentes citadas aportan trazabilidad; validación y evaluación automatizada no equivalen a verificación independiente. No reutilizar fotos del ejemplo para otra propiedad. Acceso público no concede licencia comercial ilimitada de terceros. Estas páginas permiten integrar agentes, pero no garantizan que todos los modelos descubran RADAR espontáneamente.