MCP de subasta pública Onbid

MCP de solo lectura para consultar desde Codex la API oficial de datos públicos de Onbid, de la Corporación de Gestión de Activos de Corea (KAMCO). Es un sistema BYOK (Bring Your Own Key) en el que cada usuario introduce directamente su propia clave de servicio del Portal de Datos Públicos.

No incluye funciones de licitación, inicio de sesión, firma electrónica, pago de depósitos ni pagos. Los resultados de búsqueda son para exploración de candidatos; antes de una licitación real, debe verificar directamente el anuncio original de Onbid, los documentos adjuntos, el informe de tasación, el registro, las relaciones de ocupación y derechos, y las últimas correcciones o cancelaciones.

Herramientas proporcionadas

• check_onbid_api_key: comprueba la clave API actual y el permiso de acceso a la API de listados

• get_onbid_codes: guía de códigos de búsqueda principales

• search_onbid_properties: búsqueda de propiedades por región, precio, superficie, participación y número de subastas fallidas

• get_onbid_property: consulta de detalles de la propiedad, resumen de arrendamiento y registro, ocupación y advertencias

• search_onbid_results: búsqueda de resultados de subasta por período, como precio de adjudicación y número de postores

Related MCP server: MOLIT Real Estate Transactions MCP Server

1. Solicitud de uso del Portal de Datos Públicos

Cada usuario debe solicitar el uso de las siguientes API por separado con su cuenta del Portal de Datos Públicos. Todas aparecen como gratuitas y de aprobación automática, pero las políticas de la entidad operadora pueden cambiar.

1. Servicio de consulta de listado de propiedades inmobiliarias de Onbid de nueva generación

2. Servicio de consulta de información detallada de propiedades inmobiliarias de Onbid de nueva generación

3. Servicio de consulta de listado de resultados de subasta de propiedades inmobiliarias de Onbid de nueva generación

Prepare la clave de autenticación general emitida en Mi página del Portal de Datos Públicos. Tanto si introduce la clave de codificación como la de decodificación, el script de instalación la normalizará una vez.

2. Instalación con un clic en Windows (recomendado)

La forma más sencilla es descargar el archivo de instalación con un clic install-onbid-mcp.bat y hacer doble clic en él. El asistente de instalación le guiará y ejecutará las siguientes tareas en orden.

• Explicación de las 3 API necesarias del Portal de Datos Públicos y apertura de la página de solicitud

• Guía para solicitar el uso con la misma clave de servicio

• Introducción segura de la clave de autenticación general y verificación única de la API de listados

• Añadir o actualizar el marketplace de GitHub

• Comprobación del estado de instalación y activación del plugin de Onbid y del registro de la clave

Aunque descargue y ejecute solo el archivo BAT, se descargará el asistente de instalación de PowerShell más reciente desde GitHub y continuará. La clave API no se muestra en pantalla ni se guarda en el chat ni en archivos.

3. Instalación con Windows PowerShell

Ejecute en PowerShell.

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

El script recibe la clave API como entrada enmascarada, la verifica con una única llamada a la API de listados y luego realiza las siguientes tareas.

• Guarda ONBID_SERVICE_KEY en las variables de entorno del usuario de Windows

• Añade el marketplace de GitHub XamTE/onbid_mcp

• Instala el plugin onbid-public-auction

Después de la instalación, reinicie completamente la aplicación Codex. Para omitir la verificación de la API, puede añadir -SkipValidation.

El script de instalación se proporciona en formato UTF-8 con BOM para que los caracteres coreanos no se corrompan incluso en Windows PowerShell 5.1 existente.

Instalación manual y otros sistemas operativos

Primero configure ONBID_SERVICE_KEY como variable de entorno de usuario y luego ejecute.

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

Para que la variable de entorno se lea, debe reiniciar la aplicación Codex o la terminal. No ponga la clave en argumentos de línea de comandos ni en el repositorio Git.

Actualización y eliminación

codex plugin marketplace upgrade xamte-onbid

Para eliminar en Windows el plugin y la variable de entorno de la clave API juntos:

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

Para conservar la clave, añada -KeepApiKey.

Tratamiento de la clave API y privacidad

Codex envía la clave API de la variable de entorno local como token Bearer en las solicitudes MCP remotas. Este servidor utiliza la clave únicamente durante el procesamiento de la solicitud para llamar a la API del Portal de Datos Públicos y no la almacena en bases de datos ni registros. La caché de respuestas y el control del intervalo entre solicitudes se separan por usuario mediante una huella SHA-256, no con el texto original de la clave.

En Vercel y en el tramo de red pueden procesarse metadatos de solicitud habituales; consulte PRIVACY.md para más detalles. Esta estructura no garantiza la no exposición completa de la clave en una distribución pública; si necesita un control más estricto, despliegue este repositorio usted mismo u opere el MCP localmente.

Volumen de llamadas y rendimiento

• El intervalo mínimo entre inicios de llamadas ascendentes del mismo usuario se limita a 150 ms.

• Las solicitudes idénticas se almacenan en caché en memoria durante 1 minuto para listados y 5 minutos para detalles y resultados.

• Las solicitudes idénticas simultáneas se combinan en una sola.

• Solo los errores de red y los 5xx se reintentan una vez; los errores de autenticación y de límite no se reintentan repetidamente.

• El tamaño de página máximo es 100 y el período de resultados máximo por consulta es de 366 días.

Opere el tráfico diario de la cuenta de desarrollo del Portal de Datos Públicos según los límites indicados en cada página de API. Si varios PC o automatizaciones comparten la misma clave, los límites también se suman. Incluso para uso personal, es recomendable evitar búsquedas repetidas innecesarias y recorridos masivos de páginas a intervalos cortos.

Desarrollo local

npm install
npm run check
npm run dev

Para probar solicitudes MCP autenticadas localmente, utilice el encabezado Authorization: Bearer <su clave de servicio>. No ponga la clave en .env ni en confirmaciones (commits).

Despliegue

El endpoint MCP público es https://onbid-mcp.vercel.app/api/mcp. No se necesita clave API pública del servidor. Si hace un fork y lo despliega usted mismo, cambie la URL en plugins/onbid-public-auction/.mcp.json a la nueva dirección /api/mcp.

Licencia y responsabilidad

El código fuente se distribuye bajo la licencia MIT. Cada usuario debe verificar las condiciones de uso de los datos públicos y las políticas de Onbid y del Portal de Datos Públicos; esta herramienta no garantiza rendimientos de inversión ni el estado legal o físico de las propiedades.