Onbid Zwangsversteigerung MCP

Ein schreibgeschütztes MCP zum Abrufen der offiziellen öffentlichen Daten-API der Onbid-Plattform der Korea Asset Management Corporation (KAMCO) über Codex. Es verwendet das BYOK-Prinzip (Bring Your Own Key), d. h. jeder Benutzer gibt seinen eigenen Dienstschlüssel des Portals für öffentliche Daten ein.

Bietgebote, Anmeldung, elektronische Signatur, Anzahlung und Zahlung sind nicht enthalten. Die Suchergebnisse dienen nur der Kandidatensuche; vor einem tatsächlichen Gebot müssen Sie unbedingt die Originalbekanntmachung auf Onbid, die Anhangsunterlagen, das Gutachten, die Grundbucheintragung, die Besitz- und Rechtsverhältnisse sowie den aktuellen Stand von Korrekturen und Aufhebungen direkt prüfen.

Bereitgestellte Werkzeuge

• check_onbid_api_key: Prüft den aktuellen API-Schlüssel und den Zugriff auf die Listen-API

• get_onbid_codes: Zeigt die wichtigsten Suchcodes an

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

• get_onbid_property: Ruft Objektdetails, Miet- und Grundbuchzusammenfassung, Besitzverhältnisse und Warnhinweise ab

• search_onbid_results: Sucht Versteigerungsergebnisse nach Zeitraum, z. B. Zuschlagspreis und Anzahl der Bieter

Related MCP server: MOLIT Real Estate Transactions MCP Server

1. Nutzungsbeantragung beim Portal für öffentliche Daten

Jeder Benutzer muss die folgenden APIs separat mit seinem Konto beim Portal für öffentliche Daten beantragen. Sie werden alle als kostenlos und automatisch genehmigt angezeigt, aber die Richtlinien der Betreiberorganisation können sich ändern.

1. Dienst zur Abfrage der Objektliste für die nächste Generation von Onbid-Immobilien

2. Dienst zur Abfrage der Objektdetails für die nächste Generation von Onbid-Immobilien

3. Dienst zur Abfrage der Versteigerungsergebnisliste für die nächste Generation von Onbid-Immobilien

Bereiten Sie den allgemeinen Authentifizierungsschlüssel vor, der auf der MyPage des Portals für öffentliche Daten ausgestellt wurde. Egal ob Sie den Encoding- oder Decoding-Schlüssel eingeben, das Installationsskript normalisiert ihn einmal.

2. Windows-Ein-Klick-Installation (empfohlen)

Der einfachste Weg ist, die Ein-Klick-Installationsdatei install-onbid-mcp.bat herunterzuladen und per Doppelklick auszuführen. Der Installationsassistent führt Sie Schritt für Schritt durch die folgenden Aufgaben und führt sie aus.

• Erläutert die 3 erforderlichen APIs des Portals für öffentliche Daten und öffnet die Antragsseiten

• Weist darauf hin, dass Sie mit demselben Dienstschlüssel beantragen sollen

• Sichere Eingabe des allgemeinen Authentifizierungsschlüssels und einmalige Überprüfung der Listen-API

• Hinzufügen oder Aktualisieren des GitHub-Marketplace-Eintrags

• Prüft, ob das Onbid-Plugin installiert und aktiv ist und ob der Schlüssel registriert wurde

Auch wenn Sie nur die BAT-Datei herunterladen und ausführen, wird der neueste PowerShell-Installationsassistent von GitHub heruntergeladen und ausgeführt. Der API-Schlüssel wird nicht auf dem Bildschirm angezeigt und nicht im Chat oder in Dateien gespeichert.

3. Windows-PowerShell-Installation

Führen Sie in PowerShell aus.

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

Das Skript empfängt den API-Schlüssel als maskierte Eingabe, ruft die Listen-API einmal zur Überprüfung auf und führt dann die folgenden Aufgaben aus.

• Speichert die Windows-Benutzerumgebungsvariable ONBID_SERVICE_KEY

• Fügt den GitHub-Marketplace-Eintrag XamTE/onbid_mcp hinzu

• Installiert das Plugin onbid-public-auction

Starten Sie die Codex-App nach der Installation vollständig neu. Um die API-Überprüfung zu überspringen, können Sie -SkipValidation hinzufügen.

Das Installationsskript wird im UTF-8-BOM-Format bereitgestellt, damit auch in der vorhandenen Windows PowerShell 5.1 keine koreanischen Zeichen beschädigt werden.

Manuelle Installation und andere Betriebssysteme

Setzen Sie zuerst ONBID_SERVICE_KEY als Benutzerumgebungsvariable und führen Sie dann 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. Geben Sie den Schlüssel nicht als Befehlszeilenargument oder in ein Git-Repository.

Aktualisierung und Deinstallation

codex plugin marketplace upgrade xamte-onbid

Um unter Windows das Plugin und die API-Schlüssel-Umgebungsvariable zusammen zu löschen:

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

Um den Schlüssel zu behalten, fügen Sie -KeepApiKey hinzu.

Verarbeitung des API-Schlüssels und Datenschutz

Codex sendet den API-Schlüssel aus der lokalen Umgebungsvariable als Bearer-Token in entfernten MCP-Anfragen. Dieser Server verwendet den Schlüssel nur während der Verarbeitung einer Anfrage, um die API des Portals für öffentliche Daten aufzurufen, und speichert ihn nicht in einer Datenbank oder in Protokollen. Antwort-Cache und Anforderungsintervall-Steuerung werden pro Benutzer anhand des SHA-256-Fingerabdrucks getrennt, nicht anhand des Schlüsseltextes.

Bei Vercel und im Netzwerkabschnitt können allgemeine Anforderungsmetadaten verarbeitet werden; weitere Einzelheiten finden Sie in PRIVACY.md. Die Struktur garantiert keine vollständige Nichtoffenlegung des Schlüssels bei öffentlichen Bereitstellungen. Wenn Sie eine strengere Kontrolle benötigen, stellen Sie dieses Repository selbst bereit oder betreiben Sie das MCP lokal.

Aufrufvolumen und Leistung

• Der Startabstand zwischen aufeinanderfolgenden Aufrufen desselben Benutzers ist auf mindestens 150 ms begrenzt.

• Identische Anfragen werden für Listen 1 Minute und für Details und Ergebnisse 5 Minuten im Speicher zwischengespeichert.

• Gleichzeitige identische Anfragen werden zu einer zusammengefasst.

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

• Die Seitengröße beträgt maximal 100, und der Ergebniszeitraum beträgt maximal 366 Tage auf einmal.

Betreiben Sie den täglichen Datenverkehr des Entwicklungskontos des Portals für öffentliche Daten auf der Grundlage der auf den jeweiligen API-Seiten angegebenen Grenzwerte. Wenn mehrere PCs oder Automatisierungen denselben Schlüssel verwenden, werden die Grenzwerte ebenfalls summiert. Auch für den privaten Gebrauch sollten Sie unnötige wiederholte Suchen und das Durchblättern großer Seitenmengen in kurzen Abständen vermeiden.

Lokale Entwicklung

npm install
npm run check
npm run dev

Verwenden Sie beim Testen authentifizierter MCP-Anfragen lokal den Header Authorization: Bearer <Ihr Dienstschlüssel>. Geben Sie den Schlüssel nicht in .env oder in Commits ein.

Bereitstellung

Der öffentliche MCP-Endpunkt ist https://onbid-mcp.vercel.app/api/mcp. Ein öffentlicher Server-API-Schlüssel ist nicht erforderlich. Wenn Sie eine eigene Bereitstellung über einen Fork vornehmen, ändern Sie die URL in plugins/onbid-public-auction/.mcp.json auf die neue Adresse /api/mcp.

Lizenz und Haftung

Der Quellcode wird unter der MIT-Lizenz vertrieben. Die Nutzungsbedingungen der öffentlichen Daten sowie die Richtlinien von Onbid und des Portals für öffentliche Daten müssen von jedem Benutzer selbst geprüft werden. Dieses Werkzeug garantiert weder Anlagerenditen noch den rechtlichen oder physischen Zustand der Objekte.