Real Estate Actual Price

個人用の台湾実価登録検索MVP。Web/PWAとMCPツールは同じSQLiteデータベースと検索ロジックを共有し、OpenAI APIキーは不要です。

第一段階の機能

• 内政部地政司公式の実価登録売買CSV ZIPをインポート（当期または過去の四半期）

• 住所、行政区、住所内で識別可能なコミュニティ/建物の文字で検索

• 成約日、単価、総額、坪数、階層、築年数、建物タイプを表示

• 直近1年/3年の件数、単価の中央値、平均、最高、最低、月次トレンドを計算

• search_transactions、get_market_stats、list_areas、get_data_status のMCPツールを提供

• スマートフォンで利用可能なレスポンシブWeb/PWA

Windows ローカルでの起動

Python 3.11–3.14を使用。以下のコマンドは、このPCで現在正常に実行できる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 をブラウザで開きます。初回の同期では当期データのみインポートされます。完全な3年分の統計が必要な場合は、直近の完了した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 新北市

重複してインポートした場合、公式の案件番号に基づいて更新され、重複して累積されることはありません。

Render 公開PWA（六都デモ版）

リポジトリには render.yaml と Dockerfile が同梱されています。Render で Web Service を作成し、このリポジトリを接続した後、Free プランを選択します。ビルド時に台北市、新北市、桃園市、台中市、台南市、高雄市の当期公式データをダウンロードしてインポートします。完了後、Render が HTTPS URL を提供するので、スマートフォンから開いて PWA としてインストールできます。

Render の無料サービスは15分間アイドル状態が続くとスリープし、最初の再開には約1分かかります。再デプロイのたびに六都のデータを再ダウンロードします。この公開デモ版は MCP エンドポイントを提供しません。MCP と完全なローカルデータベースは個人のPCで使用します。

MCP サーバー

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 エンドポイントにデプロイする必要があります。第一段階には公開デプロイと検証は含まれません。

テスト

python -m pytest

データソースと制限

主要なデータソースは内政部地政司の「不動産成約案件実態情報」Open Data です。当期の静的データは通常、毎月1日・11日・21日に公開され、動的検索サイトの方が新しい場合があります。データは申告・匿名化後の内容であり、住所は道路区間、番号範囲、地番までしかない場合があります。既存の中古住宅データには信頼できる統一されたコミュニティ名フィールドがないため、コミュニティ/建物名の検索は住所と備考の文字照合で行い、見落としや同名の誤マッチが発生する可能性があります。築年数は利用可能な建築完了年月から推定し、欠損値の場合は「不明」と表示します。単価は公式の1平方メートルあたりのフィールドから1坪あたりに換算しています。駐車場や特殊取引が含まれる場合は必ず備考を読む必要があり、鑑定評価や投資アドバイスと見なすべきではありません。

公式ソース：

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

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