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

Это MCP только для чтения, позволяющий запрашивать официальное публичное API данных Onbid Корейской корпорации по управлению активами через 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: поиск результатов торгов по периодам — цена победителя, число участников и т.д.

Related MCP server: MOLIT Real Estate Transactions MCP Server

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

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

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

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

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

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

2. Установка в один клик на Windows (рекомендуется)

Самый простой способ — скачать файл однокликовой установки install-onbid-mcp.bat и дважды щёлкнуть по нему. Мастер установки последовательно объяснит и выполнит следующие действия.

• Описание трёх необходимых API портала открытых данных и открытие страниц заявок

• Подсказка подать заявку с одним и тем же ключом сервиса

• Безопасный ввод обычного ключа аутентификации и однократная проверка API списков

• Добавление или обновление в GitHub Marketplace

• Проверка установки и активности плагина Onbid, а также регистрации ключа

Даже если вы просто скачаете и запустите BAT-файл, последний мастер установки PowerShell будет загружен с GitHub. API-ключ не отображается на экране и не сохраняется в чате или файлах.

3. Установка через Windows PowerShell

Выполните в 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.

Сценарий установки предоставляется в формате UTF-8 BOM, чтобы корейский текст не искажался даже в существующем Windows PowerShell 5.1.

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

Сначала задайте 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

Чтобы удалить плагин и переменную окружения API-ключа вместе в Windows:

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 или в коммиты.

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

Публичная конечная точка MCP — https://onbid-mcp.vercel.app/api/mcp. Общий API-ключ сервера не требуется. Если вы форкнёте репозиторий и развернёте собственную версию, измените URL в plugins/onbid-public-auction/.mcp.json на новый адрес /api/mcp.

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

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