Real Estate Actual Price

MVP de consulta de registros de precios reales de Taiwán para uso personal. Web/PWA y las herramientas MCP comparten la misma base de datos SQLite y lógica de consulta; no se necesita clave de API de OpenAI.

Funciones de la primera fase

• Importar el CSV ZIP oficial de transacciones de compraventa del registro real de precios del Ministerio del Interior (período actual o trimestres históricos)

• Consultar por dirección, distrito administrativo y texto de comunidad/edificio identificable dentro de la dirección

• Mostrar fecha de transacción, precio unitario, precio total, área en ping, planta, antigüedad del edificio y tipo de edificio

• Calcular el número de registros, la mediana del precio unitario, la media, el máximo, el mínimo y la tendencia mensual de los últimos 1/3 años

• Proporciona las herramientas MCP search_transactions, get_market_stats, list_areas y get_data_status

• Web/PWA responsive utilizable desde el móvil

Inicio local en Windows

Utilice Python 3.11–3.14; los siguientes comandos usarán la versión de Python que actualmente funcione correctamente en este equipo.

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"
python scripts\sync_data.py --current
python web.py

Navegue a http://127.0.0.1:5000. La primera sincronización solo importa los datos del período actual; si necesita estadísticas completas de tres años, importe también los últimos 12 trimestres finalizados, por ejemplo:

python scripts\sync_data.py --season 112S3 --season 112S4 --season 113S1 --season 113S2 --season 113S3 --season 113S4 --season 114S1 --season 114S2 --season 114S3 --season 114S4 --season 115S1 --season 115S2

También puede importar solo las ciudades o condados especificados para reducir el tiempo:

python scripts\sync_data.py --current --city 臺北市 --city 新北市

Las importaciones repetidas se actualizan según el número de caso oficial; no se acumulan duplicados.

PWA pública en Render (versión de demostración de las seis municipalidades)

El repositorio incluye render.yaml y Dockerfile. Tras crear un Web Service en Render y conectar este repositorio, seleccione el plan Free; durante la compilación se descargarán e importarán los datos oficiales del período actual de Taipéi, Nueva Taipéi, Taoyuan, Taichung, Tainan y Kaohsiung. Al finalizar, Render proporcionará una URL HTTPS que puede abrirse desde el móvil e instalarse como PWA.

El servicio gratuito de Render pasa a modo de suspensión después de 15 minutos de inactividad; la primera reapertura tarda aproximadamente un minuto. Cada nueva implementación vuelve a descargar los datos de las seis municipalidades. Esta versión pública de demostración no ofrece endpoint de MCP; MCP y la base de datos local completa siguen utilizándose en el ordenador personal.

Servidor MCP

python mcp_server.py

Por defecto ofrece http://127.0.0.1:8001/mcp mediante Streamable HTTP. Puede comprobarlo primero con MCP Inspector:

npx @modelcontextprotocol/inspector@latest

El modo desarrollador de ChatGPT no puede conectarse directamente a un localhost normal; según la documentación oficial de OpenAI, las pruebas locales personales deben usar Secure MCP Tunnel o implementar /mcp en un endpoint HTTPS de acceso público. La primera fase no incluye implementación pública ni verificación.

Pruebas

python -m pytest

Fuentes de datos y limitaciones

La fuente de datos principal es el Open Data «Información real de transacciones de bienes raíces» del Departamento de Administración de Tierras del Ministerio del Interior. Los datos estáticos del período actual suelen publicarse los días 1, 11 y 21 de cada mes; el sitio de consulta dinámica puede contener datos más recientes. Los datos son contenido declarado y anonimizado; las direcciones pueden incluir solo el tramo de calle, un intervalo de números o el número de parcela. Los datos de viviendas existentes no tienen un campo fiable y uniforme para el nombre de la comunidad, por lo que la búsqueda por nombre de comunidad/edificio se basa en la comparación de texto de la dirección y las observaciones; puede haber omisiones o coincidencias erróneas con nombres homónimos. La antigüedad del edificio se estima a partir del año y mes de finalización disponibles; si falta el valor, se muestra como desconocida. El precio unitario se convierte del campo oficial de precio por metro cuadrado a precio por ping. Cuando se incluyan plazas de aparcamiento o transacciones especiales, deben leerse las observaciones; no debe considerarse una tasación ni un consejo de inversión.

Fuentes oficiales:

• https://data.gov.tw/dataset/25119

• https://plvr.land.moi.gov.tw/DownloadOpenData