NBB MCP-сервер: годовая отчётность Бельгии

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → NBB Central Balance Sheet Office, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

NBB Central Balance Sheet Office

Годовая отчётность бельгийских компаний из Центрального балансового бюро Национального банка Бельгии (веб-сервис аутентичных данных): список всех годовых отчётов, поданных компанией, по номеру предприятия, справочные данные подачи и её бухгалтерские данные в формате JSON-XBRL или XBRL либо опубликованный PDF. Только чтение.

Настройка

Когда NBB одобрит ваши подписки, настройка займёт несколько минут. Нужны подписка на веб-сервисы NBB CBSO и аккаунт на портале разработчиков CBSO с одобренной подпиской на продукт NBB CBSO Web Services - Authentic Data.

1. Оформите подписку на веб-сервисы CBSO через форму на nbb.be (Central Balance Sheet Office, продукты). NBB пришлёт CLIENT_ID для вашего технического пользователя; самому коннектору нужен только ключ подписки из следующих шагов.
2. Зарегистрируйтесь на портале разработчиков developer.cbso.nbb.be, откройте Products и подпишитесь на NBB CBSO Web Services - Authentic Data. Запрос одобряет NBB.
3. Откройте на портале свой Profile и скопируйте primary key подписки Authentic Data в NBB_CBSO_SUBSCRIPTION_KEY (secondary key тоже подойдёт; только латинские буквы и цифры). Коннектор передаёт его в заголовке NBB-CBSO-Subscription-Key.
4. Установите коннектор и проверьте подключение через nbb_cbso_list_annual_accounts с номером предприятия 0203201340: это сам NBB.

Cloud и self-hosting работают одинаково: коннектору нужен только ключ подписки, больше ничего настраивать не нужно.

Номера предприятий и подач: номер предприятия состоит из 10 цифр и берётся из Банка-перекрёстка предприятий (KBO/BCE), без точек и без префикса BE: 0203201340 для BE 0203.201.340. У каждой подачи (deposit) свой номер, например 2023-00123456, в поле ReferenceNumber списка. year означает год окончания финансового года и не может быть позже текущего.

Исправления заменяют первую подачу: у финансового года может быть первая подача и исправление (DepositType). Берите последнюю подачу за финансовый год и проверяйте, за какой период указаны цифры.

Цифры только для стандартизированной отчётности: nbb_cbso_get_annual_account_data по умолчанию возвращает JSON-XBRL, либо XBRL, с кодами статей бельгийской схемы: например, 10/15 собственный капитал, 70 выручка, 9904 прибыль или убыток за период, 9087 среднее число работников в эквиваленте полной занятости. Нестандартизированная отчётность есть только в PDF; nbb_cbso_get_annual_account_pdf работает для обеих.

Вложенные файлы: JSON-XBRL и XBRL могут прийти вложенным файлом, а не текстом; PDF приходит так всегда. Крупные подачи могут превысить лимит вложения в 10 MB.

Идентификаторы запросов: каждый вызов содержит X-Request-Id, UUID версии 4 для трассировки. Инструменты подставляют его сами; через request_id можно передать свой.

Частые ошибки: NBB отвечает в формате problem JSON (title, status, violations). 400 означает неверный формат номера предприятия или подачи либо год в будущем, 401 отсутствующий или неверный ключ подписки, 403 ключ, подписка которого не охватывает продукт Authentic Data или ещё не одобрена, 404 то, что ничего не найдено, 429 слишком много вызовов.

Не входит: архив, выгрузки (ежедневные пакеты в zip) и продукты с улучшенными данными (improved data) NBB требуют отдельных подписок и здесь недоступны. У компаний, освобождённых от публикации, нет публичных документов.

Что читает коннектор: годовую отчётность, которую бельгийские компании и ассоциации подали в Центральное балансовое бюро и которую принял NBB. По каждой подаче: дату подачи, даты начала и конца финансового года, модель (полная, сокращённая, микро или модель для ассоциаций), тип подачи, язык и валюту, а также название, адрес, правовую форму, правовое положение, код деятельности и дату общего собрания компании. Кроме того, сами бухгалтерские данные (баланс, отчёт о прибылях и убытках, примечания и социальный баланс) в JSON-XBRL или XBRL и опубликованную отчётность в PDF.

Только чтение: все четыре инструмента только читают. В NBB ничего не подаётся, не исправляется и не изменяется.

Предварительные требования: NBB_CBSO_SUBSCRIPTION_KEY

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите NBB Central Balance Sheet Office и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

Примеры запросов

• «Перечислите все годовые отчёты, которые подало предприятие 0203.201.340, с датами финансового года, датой подачи и моделью.»
• «Каковы были собственный капитал, выручка и прибыль или убыток за период в последней годовой отчётности предприятия 0203201340 и за какой финансовый год?»
• «Какие правовая форма, адрес и код деятельности указаны в последней подаче и когда было общее собрание?»
• «Как менялось среднее число работников в эквиваленте полной занятости за последние три годовых отчёта этой компании?»
• «Скачайте опубликованный PDF последней годовой отчётности компании.»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT