Estimatiz
Estimaciones de propiedades francesas a partir de ventas DVF, con un rango de precios y un informe compartible.
Servidor MCP alojado
npx add-mcp 'https://www.estimatiz.fr/api/mcp.php'Se instala en Claude Code, Codex, Cursor y más
Documentación
Elegir entre API y MCP
La API HTTP está dirigida a desarrolladores de sitios, aplicaciones y agentes de IA capaces de enviar solicitudes HTTP. Devuelve los resultados en formato JSON.
MCP (Model Context Protocol) permite que un asistente compatible utilice las herramientas de Estimatiz durante una conversación. La persona que configura el asistente añade el servidor MCP; el asistente puede entonces buscar una dirección y solicitar una estimación.
Ambos accesos ofrecen los mismos montos y el enlace del mismo tipo de informe. MCP no es necesario para llamar a la API.
Acceso y funcionamiento
La API está diseñada para un acceso sin clave, sin cuenta y sin cuota de aplicación. No solicita nombre, correo electrónico ni teléfono. Su disponibilidad depende del servidor y de los servicios de datos utilizados.
Todos los ejemplos a continuación llaman al servicio público https://www.estimatiz.fr. Los comandos cURL deben copiarse en una terminal de macOS o Linux; no requieren ninguna instalación de Estimatiz.
Enviar las solicitudes de estimación en JSON con Content-Type: application/json. El tamaño máximo de una solicitud es de 16 KiB. Este límite se refiere al contenido de una llamada, no al número de llamadas.
Un agente puede llamarla directamente por HTTP. El conector MCP es opcional. La documentación no garantiza que los asistentes descubran o elijan automáticamente Estimatiz.
Esquema OpenAPI Consultar el método Estimatiz Consultar las fuentes
De la dirección al informe
- Buscar la dirección y hacer que se confirme el resultado correcto.
- Enviar esa dirección numerada, el tipo de propiedad y la superficie; añadir las habitaciones si se conocen.
- Presentar el precio mediano, el rango, los límites del resultado y el enlace al informe guardado.
El informe y la respuesta de la API utilizan la misma selección de ventas y los mismos cálculos. El informe da acceso a la información complementaria disponible, incluidas las ventas comparables y el mapa.
El informe no es indexable y es accesible para cualquier persona que tenga su enlace. Informar al usuario de este registro antes de la llamada de estimación. No transmitir datos de contacto.
Buscar una dirección
GET https://www.estimatiz.fr/api/public/v1/addresses.php
Parámetro requerido: q, texto de 3 a 200 caracteres que contenga la dirección buscada. Ningún resultado corresponde a un arreglo addresses vacío.
Abrir este ejemplo de búsqueda en el navegador
curl --get 'https://www.estimatiz.fr/api/public/v1/addresses.php' \
--data-urlencode 'q=146 boulevard Voltaire 75011 Paris'
La respuesta contiene ok y addresses. Cada dirección proporciona label, code_voie, voie, commune, cp, no_voie y btq. Conservar el objeto devuelto después de la confirmación del usuario. No elegir arbitrariamente el primer resultado ni inventar un identificador.
Crear una estimación
POST https://www.estimatiz.fr/api/public/v1/estimate.php
Esta dirección espera una solicitud POST con un cuerpo JSON. Abrirla en la barra de direcciones del navegador envía un GET y no crea una estimación.
El cuerpo JSON contiene address (el objeto confirmado), property_type y surface. Los parámetros rooms, rooms_mode y location_fallback son opcionales.
property_type
Una categoría: Apartamento, Casa, Local u Otros bienes.
surface
Número de 5 a 500 m².
rooms y rooms_mode
Número entero de 1 a 30 habitaciones, si se conoce. Modo exact por defecto o minimum con un número de habitaciones proporcionado.
location_fallback
nearby_number por defecto: permite un punto de referencia vecino si se cumplen las reglas de confirmación. none desactiva el recurso a un número vecino.
Ningún precio, coordenada geográfica ni comparable calculado por el cliente se acepta como base del cálculo.
Ejemplo completo con cURL
Este comando estima un apartamento de 60 m² en el 146 bulevar Voltaire en París y guarda un informe compartible. Para otro bien, retomar la dirección confirmada por la búsqueda y modificar sus características.
curl 'https://www.estimatiz.fr/api/public/v1/estimate.php' \
--header 'Content-Type: application/json' \
--data-raw '{
"address": {
"label": "146 BD VOLTAIRE 75011 Paris 11e Arrondissement",
"code_voie": "9907",
"voie": "BD VOLTAIRE",
"commune": "Paris 11e Arrondissement",
"cp": "75011",
"no_voie": "146",
"btq": ""
},
"property_type": "Appartement",
"surface": 60
}'
Montos e informe
estimation.median, low, high
Monto mediano y rango bajo y alto en euros. price_m2 indica el precio por m² mediano.
report.url
Enlace compartible del informe guardado. Mostrar este enlace con los montos; no reconstruirlo.
comparables, location, warnings
Número y fechas de las ventas, estado de localización y advertencias. Una localización aproximada debe permanecer explícita.
sources, methodology_url, generated_at
Fuentes utilizadas, método y fecha de generación del resultado.
Ejemplo completo en JavaScript
Este código contiene la solicitud y llama directamente a la API pública. Puede ejecutarse en una aplicación JavaScript que disponga de fetch, o en un archivo con Node.js 18 o posterior. Desde un sitio web, su política de seguridad debe autorizar las conexiones a https://www.estimatiz.fr. Su ejecución también crea un informe.
async function estimerAvecEstimatiz() {
const demande = {
"address": {
"label": "146 BD VOLTAIRE 75011 Paris 11e Arrondissement",
"code_voie": "9907",
"voie": "BD VOLTAIRE",
"commune": "Paris 11e Arrondissement",
"cp": "75011",
"no_voie": "146",
"btq": ""
},
"property_type": "Appartement",
"surface": 60
};
const reponse = await fetch('https://www.estimatiz.fr/api/public/v1/estimate.php', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(demande)
});
const resultat = await reponse.json();
if (!reponse.ok || !resultat.ok) {
throw new Error(resultat.error?.message || 'Estimation indisponible');
}
console.log(resultat.estimation);
console.log(resultat.report.url);
return resultat;
}
estimerAvecEstimatiz().catch(console.error);
La estimación no es un precio de venta garantizado. En caso de datos insuficientes, explicar el límite sin inventar un monto. Un resultado puede reutilizarse; consultar su fecha de generación.
Tratar los errores
{"ok": false, "error": {"code": "INVALID_PARAMETERS", "message": "Paramètres invalides."}}
| Estado | Significado | Acción |
|---|---|---|
| 400 | JSON inválido | Verificar el cuerpo de la solicitud. |
| 405 | Método incorrecto | Usar GET para la búsqueda, POST para la estimación. |
| 413 | Solicitud demasiado grande | Limitar el cuerpo a 16 KiB. |
| 422 | Parámetros inválidos o datos insuficientes | Leer el código y el mensaje; no inventar un monto. |
| 500 / 503 | Error interno o servicio no disponible | Señalar la indisponibilidad y reintentar más tarde. |
REPORT_CREATION_FAILED significa que el guardado del informe falló: no anunciar un éxito completo ni inventar un enlace. El contrato OpenAPI describe las respuestas esperadas.
Conectar un asistente con MCP
En un cliente que admita servidores MCP remotos, añadir un servidor con el transporte Streamable HTTP y sin autenticación. La dirección del servidor es https://www.estimatiz.fr/api/mcp.php.
Copie esta URL completa en el campo «URL del servidor» de su cliente MCP:
https://www.estimatiz.fr/api/mcp.php
El cliente MCP gestiona las llamadas POST y la inicialización del protocolo. Abrir esta URL en la barra de direcciones del navegador no inicia una estimación.
- Conectar el cliente al servidor y verificar que ofrezca las herramientas
search_addressesyestimate_property. - Solicitar la búsqueda de una dirección, luego confirmar el resultado y las características de la propiedad.
- Solicitar la estimación y mostrar los montos, las advertencias y el enlace del informe en la respuesta.
El cliente gestiona la inicialización MCP. Para una integración técnica, enviar Content-Type: application/json y Accept: application/json, text/event-stream. Las revisiones compatibles son 2025-03-26, 2025-06-18 y 2025-11-25.
El punto de acceso https://www.estimatiz.fr/api/mcp.php expone las herramientas search_addresses y estimate_property. Utilizan el mismo servicio que la API. La estimación guarda un informe; por lo tanto, esta herramienta tiene un efecto de escritura.
Estimatiz es un servicio independiente, sin afiliación con una administración. Las atribuciones y los límites de los datos permanecen disponibles en el informe y en las fuentes devueltas.