オン bid 公売 MCP

韓国資産管理公社オン bid の公式公共データ API を Codex から照会する読み取り専用 MCP です。各ユーザーが自分の公共データポータルサービスキーを直接入力する BYOK(Bring Your Own Key)方式です。

入札、ログイン、電子署名、保証金納付、決済機能はありません。検索結果は候補探索用であり、実際の入札前には必ずオン bid 原文公告と添付書類、鑑定評価書、登記、占有・権利関係、最新の訂正・取消有無を直接確認する必要があります。

提供ツール

• check_onbid_api_key: 現在の API キーとリスト API アクセス権限の確認

• get_onbid_codes: 代表検索コードの案内

• search_onbid_properties: 地域・価格・面積・持分・流札回数などの物件検索

• get_onbid_property: 物件詳細、賃貸借・登記要約・占有・注意事項の照会

• search_onbid_results: 期間別落札価格・入札者数などの入札結果検索

Related MCP server: Korea Real Estate MCP

1. 公共データポータル活用申請

ユーザーごとに公共データポータルアカウントで以下の API をそれぞれ活用申請する必要があります。すべて無料・自動承認と表示されていますが、運営機関のポリシーは変更される可能性があります。

1. 次世代オン bid 不動産物件リスト照会サービス

2. 次世代オン bid 不動産物件詳細情報照会サービス

3. 次世代オン bid 不動産入札結果リスト照会サービス

公共データポータルのマイページで発行された一般認証キーを準備してください。Encoding または Decoding キーのどちらを入力しても、インストールスクリプトが一度正規化します。

2. Windows ワンクリックインストール(推奨)

最も簡単な方法は、install-onbid-mcp.bat ワンクリックインストールファイルをダウンロードしてダブルクリックすることです。インストールウィザードが次の作業を順番に案内し、実行します。

• 必要な公共データポータル API 3つの説明および申請ページを開く

• 同一サービスキーで活用申請するよう案内

• 一般認証キーのセキュリティ入力およびリスト API 1回検証

• GitHub マーケットプレイス追加または更新

• オン bid プラグインのインストール・アクティブ状態とキー登録有無の確認

BAT ファイルだけを別途ダウンロードして実行しても、GitHub から最新の PowerShell インストールウィザードを取得して進めます。API キーは画面に表示せず、チャットやファイルに保存しません。

3. Windows PowerShell インストール

PowerShell で実行します。

git clone https://github.com/XamTE/onbid_mcp.git
powershell -ExecutionPolicy Bypass -File .\onbid_mcp\scripts\install.ps1

スクリプトが API キーをマスキング入力で受け取り、リスト API を1回呼び出して検証した後、次の作業をします。

• Windows ユーザー環境変数 ONBID_SERVICE_KEY を保存

• XamTE/onbid_mcp GitHub マーケットプレイスを追加

• onbid-public-auction プラグインをインストール

インストール後、Codex アプリを完全に再起動してください。API 検証をスキップするには -SkipValidation を追加できます。

既存の Windows PowerShell 5.1 でも韓国語が文字化けしないよう、インストールスクリプトを UTF-8 BOM 形式で提供します。

手動インストールおよび他のオペレーティングシステム

まず ONBID_SERVICE_KEY をユーザー環境変数として設定してから実行します。

codex plugin marketplace add XamTE/onbid_mcp --ref main
codex plugin add onbid-public-auction@xamte-onbid

環境変数を読み込むには、Codex アプリやターミナルを再起動する必要があります。キーをコマンドライン引数や Git リポジトリに入れないでください。

アップデートと削除

codex plugin marketplace upgrade xamte-onbid

Windows でプラグインと API キー環境変数を一緒に削除するには:

powershell -ExecutionPolicy Bypass -File .\scripts\uninstall.ps1

キーを維持するには -KeepApiKey を追加します。

API キー処理と個人情報

Codex はローカル環境変数の API キーをリモート MCP リクエストの Bearer トークンとして送信します。このサーバーはリクエスト処理中にのみキーを使用して公共データポータル API を呼び出し、データベースやログに保存しません。レスポンスキャッシュとリクエスト間隔制御は、キー原文ではなく SHA-256 フィンガープリントでユーザー別に分離されます。

Vercel とネットワーク区間で一般的なリクエストメタデータが処理される可能性があるため、詳細は PRIVACY.md を確認してください。公共配布でキーの完全な非露出を保証する構造ではないため、より強い統制が必要な場合は、このリポジトリを直接配布するか、MCP をローカルで運用してください。

呼び出し量とパフォーマンス

• 同一ユーザーの上流呼び出し開始間隔を最小 150ms に制限します。

• 同一リクエストはリスト 1分、詳細・結果 5分間メモリキャッシュします。

• 同時の同一リクエストは1つにまとめます。

• ネットワークエラーと 5xx のみ1回再試行し、認証・限度エラーは繰り返し再試行しません。

• ページサイズは最大 100、結果期間は一度に最大 366日です。

公共データポータル開発アカウントの日次トラフィックは、各 API ページに表示された限度を基準に運用してください。複数の PC や自動化が同じキーを共有すると限度も合算されます。個人利用でも、不要な繰り返し検索や短い間隔での大量ページ巡回は避けることをお勧めします。

ローカル開発

npm install
npm run check
npm run dev

ローカルで認証された MCP リクエストをテストするときは、Authorization: Bearer <本人サービスキー> ヘッダーを使用します。キーを .env やコミットに入れないでください。

配布

公開 MCP エンドポイントは https://onbid-mcp.vercel.app/api/mcp です。サーバー共通 API キーは必要ありません。フォークして自社配布する場合は、plugins/onbid-public-auction/.mcp.json の URL を新しい /api/mcp アドレスに変更してください。

ライセンスと責任

ソースは MIT ライセンスで配布されます。公共データの利用条件とオン bid・公共データポータルのポリシーは各ユーザーが確認する必要があり、このツールは投資収益や物件の法的・物理的状態を保証しません。