Real Estate Actual Price

Личный MVP для поиска по тайваньскому реестру реальных цен на недвижимость. Web/PWA и MCP-инструменты используют одну и ту же базу данных SQLite и логику запросов; ключ OpenAI API не требуется.

Функции первого этапа

• Импорт официальных CSV ZIP-файлов с данными о сделках из реестра реальных цен Департамента земельного администрирования Министерства внутренних дел (текущий период или исторические кварталы)

• Поиск по адресу, административному району, тексту сообщества/здания, распознаваемому в адресе

• Отображение даты сделки, цены за единицу площади, общей цены, площади в пингах, этажа, возраста здания и типа строения

• Расчёт количества сделок за последние 1/3 года, медианной цены за единицу, средней, максимальной, минимальной и месячного тренда

• Предоставление MCP-инструментов search_transactions, get_market_stats, list_areas, get_data_status

• Адаптивный Web/PWA для мобильных устройств

Локальный запуск в Windows

Используется Python 3.11–3.14; приведённые ниже команды используют ту версию Python, которая в данный момент корректно работает на этом компьютере.

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

Откройте в браузере http://127.0.0.1:5000. При первой синхронизации импортируются только данные текущего периода; если нужна полная трёхлетняя статистика, дополнительно импортируйте последние 12 завершённых кварталов, например:

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

Можно также импортировать только указанные города/уезды, чтобы сократить время:

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

Повторный импорт обновляет записи по официальным номерам дел и не приводит к дублированию.

Публичный PWA на Render (демонстрационная версия для шести городов)

В репозиторий уже включены render.yaml и Dockerfile. После создания Web Service в Render и подключения этого репозитория выберите план Free; при сборке будут загружены и импортированы официальные данные текущего периода для Тайбэя, Нового Тайбэя, Таоюаня, Тайчжуна, Тайнаня и Гаосюна. После завершения Render предоставит HTTPS-адрес, который можно открыть с телефона и установить как PWA.

Бесплатный сервис Render переходит в спящий режим после 15 минут простоя; первое повторное открытие занимает около минуты; при каждом повторном развёртывании данные по шести городам загружаются заново. Эта публичная демонстрационная версия не предоставляет MCP endpoint; MCP и полная локальная база данных по-прежнему используются на персональном компьютере.

MCP server

python mcp_server.py

По умолчанию предоставляется через Streamable HTTP по адресу http://127.0.0.1:8001/mcp. Сначала можно проверить с помощью MCP Inspector:

npx @modelcontextprotocol/inspector@latest

Режим разработчика ChatGPT не может напрямую подключаться к обычному localhost; согласно официальной документации OpenAI, для локального тестирования следует использовать Secure MCP Tunnel или развернуть /mcp на HTTPS endpoint, доступном из публичной сети. Первый этап не включает публичное развёртывание и проверку.

Тестирование

python -m pytest

Источники данных и ограничения

Основной источник данных — Open Data «不動產成交案件實際資訊» Департамента земельного администрирования Министерства внутренних дел. Текущие статические данные обычно публикуются 1, 11 и 21 числа каждого месяца; данные на динамическом сайте запросов могут быть новее. Данные представляют собой задекларированное и деидентифицированное содержимое; адрес может указывать только на участок дороги, диапазон номеров или кадастровый номер земельного участка. В существующих данных о готовом жилье нет надёжного единого поля с названием сообщества, поэтому поиск по названию сообщества/здания выполняется сопоставлением текста адреса и примечаний; возможны пропуски или ложные совпадения из-за одинаковых названий. Возраст здания оценивается по доступным данным о дате завершения строительства; при отсутствии значения отображается «неизвестно». Цена за единицу пересчитывается из официального поля «за квадратный метр» в цену за пин; при сделках с парковочными местами и особыми условиями следует читать примечания; данные не следует рассматривать как оценку или инвестиционную рекомендацию.

Официальные источники:

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

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