온비드 공매 MCP

Dies ist ein schreibgeschütztes MCP, das die offizielle öffentliche Daten-API von 한국자산관리공사 온비드 in Codex abfragt. Es folgt dem BYOK-Prinzip (Bring Your Own Key), bei dem jeder Benutzer seinen eigenen Dienstschlüssel des öffentlichen Datenportals direkt eingibt.

Es gibt keine Funktionen für Gebote, Anmeldung, elektronische Signatur, Sicherheitsleistung oder Zahlung. Die Suchergebnisse dienen lediglich der Kandidatensuche. Vor einem tatsächlichen Gebot müssen Sie unbedingt die Originalbekanntmachung auf 온비드, die beigefügten Unterlagen, das Bewertungsgutachten, das Grundbuch, die Besitz- und Rechtsverhältnisse sowie den aktuellen Stand von Berichtigungen und Rücknahmen direkt prüfen.

Bereitgestellte Werkzeuge

• check_onbid_api_key: Aktuellen API-Schlüssel und Zugriffsberechtigungen für die Listen-API prüfen

• get_onbid_codes: Hinweise zu den repräsentativen Suchcodes

• search_onbid_properties: Suche nach Objekten nach Region, Preis, Fläche, Anteil, Anzahl der erfolglosen Versteigerungen usw.

• get_onbid_property: Objektdetails sowie Zusammenfassungen zu Mietverhältnissen, Grundbuch, Besitz und Warnhinweisen abrufen

• search_onbid_results: Suche von Auktionsergebnissen nach Zeitraum, Zuschlagspreis, Anzahl der Bieter usw.

1. Nutzungsbeantragung beim öffentlichen Datenportal

Jeder Benutzer muss die folgenden APIs jeweils mit einem Konto beim öffentlichen Datenportal beantragen. Sie sind zwar alle als kostenlos und automatisch genehmigt gekennzeichnet, aber die Richtlinien der Betreiberorganisation können sich ändern.

1. 차세대 온비드 부동산 물건목록 조회서비스

2. 차세대 온비드 부동산 물건상세정보 조회서비스

3. 차세대 온비드 부동산 입찰결과 목록 조회서비스

Halten Sie den allgemeinen Authentifizierungsschlüssel bereit, der auf der Mypage des öffentlichen Datenportals ausgestellt wurde. Ganz gleich, ob Sie einen Encoding- oder einen Decoding-Schlüssel eingeben, das Installationsskript normalisiert ihn einmal.

2. Schnellinstallation unter Windows

Führen Sie es in PowerShell aus.

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

Das Skript fragt den API-Schlüssel maskiert ab, validiert ihn durch einen einmaligen Aufruf der Listen-API und führt dann Folgendes aus:

• Speichert ONBID_SERVICE_KEY als Benutzerumgebungsvariable von Windows

• Fügt XamTE/onbid_mcp zum GitHub-Marketplace hinzu

• Installiert das Plugin onbid-public-auction

Starten Sie die Codex-App nach der Installation vollständig neu. Wenn Sie die API-Validierung überspringen möchten, können Sie -SkipValidation hinzufügen.

Manuelle Installation und andere Betriebssysteme

Setzen Sie zuerst ONBID_SERVICE_KEY als Benutzerumgebungsvariable und führen Sie dann Folgendes aus:

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

Damit die Umgebungsvariable gelesen wird, müssen Sie die Codex-App oder das Terminal neu starten. Legen Sie den Schlüssel nicht als Befehlszeilenargument oder in einem Git-Repository ab.

Aktualisierung und Entfernen

codex plugin marketplace upgrade xamte-onbid

Um das Plugin zusammen mit der API-Schlüssel-Umgebungsvariable unter Windows zu entfernen:

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

Fügen Sie -KeepApiKey hinzu, um den Schlüssel zu behalten.

Umgang mit dem API-Schlüssel und Datenschutz

Codex sendet den API-Schlüssel aus der lokalen Umgebungsvariable als Bearer-Token in Remote-MCP-Anfragen. Dieser Server verwendet den Schlüssel nur während der Bearbeitung einer Anfrage, um die API des öffentlichen Datenportals aufzurufen, und speichert ihn weder in einer Datenbank noch in Protokollen. Antwort-Caches und die Steuerung der Anfrageabstände werden pro Benutzer anhand eines SHA-256-Fingerabdrucks getrennt, nicht anhand des Schlüsseltexts.

Da bei Vercel und auf dem Netzwerkweg übliche Anfragemetadaten verarbeitet werden können, finden Sie weitere Einzelheiten in PRIVACY.md. Die Architektur gewährleistet keine vollständige Nichtoffenlegung des Schlüssels bei einer öffentlichen Bereitstellung. Wenn Sie eine strengere Kontrolle benötigen, stellen Sie dieses Repository selbst bereit oder betreiben Sie das MCP lokal.

Aufrufvolumen und Leistung

• Der Abstand zwischen den Startzeitpunkten aufeinanderfolgender Upstream-Aufrufe desselben Benutzers wird auf mindestens 150 ms begrenzt.

• Identische Anfragen werden im Speicher zwischengespeichert: Listen 1 Minute, Details und Ergebnisse 5 Minuten.

• Gleichzeitige identische Anfragen werden zu einer einzigen zusammengefasst.

• Nur Netzwerkfehler und 5xx-Antworten werden einmal erneut versucht; Authentifizierungs- und Kontingentfehler werden nicht wiederholt.

• Die Seitengröße beträgt höchstens 100, der Ergebniszeitraum höchstens 366 Tage pro Aufruf.

Richten Sie das tägliche Datenaufkommen des Entwicklungskontos beim öffentlichen Datenportal an den Limits aus, die auf den jeweiligen API-Seiten angegeben sind. Wenn mehrere PCs oder Automatisierungen denselben Schlüssel verwenden, werden die Limits ebenfalls aufsummiert. Auch bei privater Nutzung sollte man unnötige Wiederholungssuchen und das kurzfristige Durchblättern großer Seitenmengen vermeiden.

Lokale Entwicklung

npm install
npm run check
npm run dev

Testen Sie lokale authentifizierte MCP-Anfragen mit dem Header Authorization: Bearer <본인 서비스 키>. Legen Sie den Schlüssel nicht in .env oder in Commits ab.

Bereitstellung

Nach der Bereitstellung auf Vercel muss nur die URL in plugins/onbid-public-auction/.mcp.json an die tatsächliche /api/mcp-Adresse angepasst werden. Ein gemeinsamer Server-API-Schlüssel ist nicht erforderlich.

Lizenz und Haftung

Der Quellcode wird unter der MIT-Lizenz bereitgestellt. Jeder Benutzer muss die Nutzungsbedingungen der öffentlichen Daten sowie die Richtlinien von 온비드 und des öffentlichen Datenportals selbst prüfen. Dieses Tool garantiert weder Anlagerenditen noch den rechtlichen oder physischen Zustand der Objekte.