MCP для публичных торгов Onbid

Это MCP только для чтения, который позволяет запрашивать официальное API открытых данных Onbid от Korea Asset Management Corporation через Codex. Каждый пользователь вводит собственный ключ сервиса портала открытых данных — схема BYOK (Bring Your Own Key).

Функции участия в торгах, входа в систему, электронной подписи, внесения задатка и оплаты отсутствуют. Результаты поиска предназначены для предварительного отбора кандидатов; перед фактическим участием в торгах необходимо самостоятельно проверить оригинальное объявление Onbid, прилагаемые документы, отчёт об оценке, регистрационные записи, сведения о владении и правах, а также актуальный статус исправлений и отмен.

Предоставляемые инструменты

• check_onbid_api_key: проверка текущего ключа API и прав доступа к API списков

• get_onbid_codes: справочная информация по основным кодам поиска

• search_onbid_properties: поиск объектов по региону, цене, площади, доле, числу несостоявшихся торгов и т.д.

• get_onbid_property: просмотр деталей объекта, сводки по аренде и регистрации, владению, предупреждениям

• search_onbid_results: поиск результатов торгов по периодам — цена продажи, число участников и т.д.

1. Заявка на использование портала открытых данных

Каждый пользователь должен отдельно подать заявку на использование следующих API через учётную запись портала открытых данных. Все они указаны как бесплатные с автоматическим одобрением, однако политика эксплуатирующей организации может измениться.

1. Сервис просмотра списка объектов недвижимости Onbid нового поколения

2. Сервис просмотра детальной информации об объектах недвижимости Onbid нового поколения

3. Сервис просмотра списка результатов торгов по недвижимости Onbid нового поколения

Подготовьте обычный ключ аутентификации, выданный в личном кабинете портала открытых данных. Неважно, введёте ли вы Encoding или Decoding ключ — установочный скрипт нормализует его один раз.

2. Быстрая установка в Windows

Выполните в PowerShell.

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

Скрипт принимает ключ API в виде маскированного ввода, один раз вызывает API списков для проверки, а затем выполняет следующие действия.

• Сохраняет переменную окружения Windows ONBID_SERVICE_KEY

• Добавляет GitHub Marketplace XamTE/onbid_mcp

• Устанавливает плагин onbid-public-auction

После установки полностью перезапустите приложение Codex. Чтобы пропустить проверку API, можно добавить -SkipValidation.

Ручная установка и другие операционные системы

Сначала задайте 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 из локальной переменной окружения как Bearer-токен в удалённых запросах MCP. Этот сервер использует ключ только во время обработки запроса для вызова API портала открытых данных и не сохраняет его в базе данных или журналах. Разделение по пользователям для кэша ответов и контроля интервалов запросов выполняется по SHA-256 отпечатку, а не по исходному тексту ключа.

На Vercel и в сетевых сегментах могут обрабатываться обычные метаданные запросов, поэтому подробнее см. PRIVACY.md. Эта архитектура не гарантирует полного нераскрытия ключа в публичном развёртывании; если нужен более строгий контроль, разверните этот репозиторий самостоятельно или запускайте MCP локально.

Объём вызовов и производительность

• Минимальный интервал между началом вышестоящих вызовов одного пользователя ограничен 150 мс.

• Одинаковые запросы кэшируются в памяти: списки — 1 минуту, детали и результаты — 5 минут.

• Одновременные одинаковые запросы объединяются в один.

• Сетевые ошибки и 5xx повторяются один раз; ошибки аутентификации и лимитов не повторяются.

• Максимальный размер страницы — 100, период результатов — до 366 дней за один раз.

Суточный трафик аккаунта разработчика портала открытых данных рассчитывайте исходя из лимитов, указанных на странице каждого API. Если несколько ПК или автоматизация используют один и тот же ключ, лимиты суммируются. Даже при личном использовании лучше избегать ненужных повторных поисков и массового перебора страниц с короткими интервалами.

Локальная разработка

npm install
npm run check
npm run dev

При тестировании аутентифицированных запросов MCP локально используйте заголовок Authorization: Bearer <ваш ключ сервиса>. Не помещайте ключ в .env или в коммиты.

Развёртывание

После развёртывания на Vercel укажите в plugins/onbid-public-auction/.mcp.json фактический адрес /api/mcp в URL. Общий ключ API сервера не требуется.

Лицензия и ответственность

Исходный код распространяется под лицензией MIT. Условия использования открытых данных и политики Onbid и портала открытых данных каждый пользователь должен проверять самостоятельно; этот инструмент не гарантирует инвестиционной доходности или юридического и физического состояния объектов.