MCP de subasta pública de Onbid

Es un MCP de solo lectura que consulta 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 modelo 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 solo para explorar candidatos; antes de la licitación real, debe verificar directamente el anuncio original en Onbid, los documentos adjuntos, el informe de tasación, el registro de la propiedad, la ocupación y los derechos, y las últimas correcciones o cancelaciones.

Herramientas disponibles

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

• get_onbid_codes: Muestra los códigos de búsqueda representativos.

• search_onbid_properties: Busca bienes por región, precio, superficie, cuota, número de subastas fallidas, etc.

• get_onbid_property: Consulta el detalle del bien, el arrendamiento, el resumen del registro, la ocupación y las advertencias.

• search_onbid_results: Busca resultados de licitación por período, como precio de adjudicación y número de postores.

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

Cada usuario debe solicitar el uso de cada una de las siguientes API 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 institución operadora pueden cambiar.

1. Servicio de consulta de listado de bienes inmuebles de Onbid de nueva generación

2. Servicio de consulta de información detallada de bienes inmuebles de Onbid de nueva generación

3. Servicio de consulta de lista de resultados de licitación de bienes inmuebles 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 Encoding como la Decoding, el script de instalación la normaliza una vez.

2. Instalación rápida en Windows

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 de API como entrada enmascarada, la verifica llamando una vez a la API de listados y realiza lo siguiente:

• Guarda la variable de entorno de Windows ONBID_SERVICE_KEY.

• Añade XamTE/onbid_mcp al marketplace de GitHub.

• Instala el plugin onbid-public-auction.

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

Instalación manual y otros sistemas operativos

En primer lugar, establezca 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 cargue, debe reiniciar la aplicación Codex o la terminal. No introduzca 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 el plugin y la variable de entorno de la clave de API a la vez en Windows:

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

Para conservar la clave, añada -KeepApiKey.

Tratamiento de la clave de API y privacidad

Codex envía la clave de API de la variable de entorno local como token Bearer en las solicitudes MCP remotas. Este servidor utiliza la clave únicamente mientras procesa la solicitud para llamar a la API del Portal de Datos Públicos y no la guarda en bases de datos ni en registros. La caché de respuestas y el control de intervalos de solicitud separan a los usuarios mediante una huella SHA-256, no mediante la clave original.

Como Vercel y los segmentos de red pueden procesar metadatos de solicitud habituales, consulte PRIVACY.md para más detalles. Esta estructura no garantiza la completa no exposición de la clave en un despliegue público; si necesita un control más estricto, despliegue este repositorio por su cuenta u opere el MCP localmente.

Volumen de llamadas y rendimiento

• Limita el intervalo mínimo entre el inicio de llamadas ascendentes del mismo usuario a 150 ms.

• Almacena en caché en memoria la misma solicitud durante 1 minuto para listados y 5 minutos para detalles y resultados.

• Combina las solicitudes simultáneas idénticas en una sola.

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

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

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

Desarrollo local

npm install
npm run check
npm run dev

Para probar solicitudes MCP autenticadas en local, utilice la cabecera Authorization: Bearer <본인 서비스 키>. No ponga la clave en .env ni en los commits.

Despliegue

Después de desplegar en Vercel, ajuste la URL de plugins/onbid-public-auction/.mcp.json a la dirección real de /api/mcp. No se necesita una clave de API pública para el servidor.

Licencia y responsabilidad

El código fuente se distribuye bajo la licencia MIT. Cada usuario debe revisar 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 el rendimiento de la inversión ni el estado legal o físico de los bienes.