mcp-comex-brasil

MCP-сервер внешней торговли Бразилии — с ловушками датасета, исправленными в ответе.

Четыре инструмента, которые не лгут, вместо сорока, которые не знают.

Проблема, которую решает этот сервер

MCP-сервер, который лишь предоставляет датасет, передаёт агенту чистый API для неверного числа. Трубопровод не знает, что поле лжёт.

Comex Stat — официальная база внешней торговли Бразилии, публикуемая Secretaria de Comércio Exterior / Receita Federal, — имеет дефект, о котором не предупреждает ни одна документация:

Фильтрация поля способа перевозки по AÉREA возвращает 139,6 млн кг импорта из Китая в 2026 году (янв–июл). При сопоставлении этих же записей с пунктом оформления лишь 34,0 млн (24%) прошли через аэропорт. Остальные 89,7 млн были оформлены в морских портах и представляют собой сульфат аммония и фосфатные удобрения — груз, который не летает, с фрахтом US$0,29/кг.

Без исправления: авиавес завышен в 4,1 раза, а фрахт за килограмм занижен на 70%. Ошибка молчаливая: ничто в запросе на неё не указывает.

Этот сервер применяет исправление и возвращает вместе с ним доказательства того, почему оно необходимо.

Related MCP server: mcp-comtrade

Две гарантии

1. Каждый ответ содержит известные дефекты, применимые к этому запросу, с измеренными доказательствами и происхождением проверки.

2. Критическое исправление применено к результату, а не только объявлено. Канал air уже означает «авиационный груз, оформленный в аэропорту». Загрязнённый блок остаётся доступным для запросов как air_declared_at_port, намеренно — для тех, кто хочет его проверить.

Что в датасете есть такого, что опубликованные сводки выбрасывают

Файлы импорта содержат VL_FRETE и VL_SEGURO — фрахт и страхование, заявленные таможне. Это лучшее систематическое измерение фактической стоимости из доступных публично, и практически никто им не пользуется.

Китай → Бразилия, янв–июл 2026, уже исправлено:

Авиаперевозка стоит в 76 раз больше за килограмм и лишь в 1,65 раза больше за доллар товара. Модальный сплит этого коридора — это не решение о фрахте, а решение о плотности стоимости.

Установка

Требуется Node ≥ 22.5 (использует встроенный SQLite — ноль нативных зависимостей, никакого node-gyp).

git clone <repo> && cd mcp-comex-brasil
npm install && npm run build
npm run db:build -- --years 2025,2026        # baixa da fonte oficial e monta o SQLite

db:build загружает файлы напрямую с balanca.economia.gov.br. Никакие данные не распространяются этим пакетом — база создаётся на вашей машине, всегда свежая из источника.

Полезные параметры:

npm run db:build -- --years 2026 --countries 160        # só China, base pequena e rápida
npm run db:build -- --years 2024,2025,2026 --flows import,export

Настройка в MCP-клиенте

{
  "mcpServers": {
    "comex": {
      "command": "node",
      "args": ["--experimental-sqlite", "/caminho/para/mcp-comex-brasil/dist/index.js"],
      "env": { "COMEX_LANG": "pt" }
    }
  }
}

COMEX_LANG принимает pt (по умолчанию) или en. COMEX_DB переопределяет путь к базе данных.

Четыре инструмента

Предупреждения, сопровождающие ответы

О simplified_regime_absent: существуют коды способа перевозки для POSTAL и COURIER, но они пусты (13 записей и 72 кг для Китая за весь 2026 год против ~180 миллионов зарегистрированных международных посылок). Отправления малой стоимости проходят по упрощённому режиму и не попадают в статистику торговли. Формальная статистика и объём посылок — это непересекающиеся вселенные — не складывать, не сравнивать арифметически.

Проверка

Агрегаты были проверены перекрёстной реализацией: один и тот же срез, обработанный одним проходом awk по сырому CSV и SQL-представлением этого сервера, даёт одинаковые числа до последней цифры (349 250 записей, 7 каналов, значения фрахта и веса).

npm test     # 12 testes da lógica de classificação e do registro de caveats

Лицензия и источник

MIT. Данные: Comex Stat, Secretaria de Comércio Exterior / Receita Federal do Brasil (balanca.economia.gov.br) — публичный источник, использованный при создании базы.

Автор: Luis Delfin

Английский

MCP-сервер для данных внешней торговли Бразилии — с ловушками датасета, исправленными в ответе.

Четыре инструмента, которые не лгут, вместо сорока, которые не знают.

Проблема

MCP-сервер, который лишь предоставляет датасет, передаёт агенту чистый API для неверного числа. Трубопровод не знает, что поле лжёт.

Официальный торговый датасет Бразилии (Comex Stat, публикуемый Foreign Trade Secretariat / Federal Revenue Service) имеет дефект, о котором не предупреждает ни одна документация:

Фильтрация поля способа перевозки по AIR возвращает 139,6 млн кг импорта из Китая за янв–июл 2026 года. При сопоставлении этих же записей с их пунктом оформления лишь 34,0 млн (24%) прошли через аэропорт. Остальные 89,7 млн были оформлены в морских портах и состоят из сульфата аммония и фосфатных удобрений — груз, который не летает, с фрахтом US$0,29/кг.

Без исправления: вес авиаперевозок завышен в 4,1 раза, а фрахт за кг занижен на 70%. Ошибка молчаливая — ничто в запросе на неё не указывает.

Этот сервер применяет исправление и возвращает доказательства того, почему оно необходимо.

Две гарантии

1. Каждый ответ содержит известные дефекты, применимые к этому запросу, с измеренными доказательствами и происхождением проверки.

2. Критическое исправление применено, а не просто объявлено. Канал air уже означает «авиационный режим, оформленный в аэропорту». Загрязнённый блок остаётся доступным для запросов как air_declared_at_port, намеренно — для тех, кто хочет его проверить.

Что в датасете есть такого, что опубликованные сводки отбрасывают

Файлы импорта содержат VL_FRETE и VL_SEGURO — фрахт и страховку в том виде, как они заявлены таможне. Это лучшее систематическое измерение фактической стоимости из доступных публично, и практически никто им не пользуется.

Китай → Бразилия, янв–июл 2026, исправлено:

Авиаперевозка стоит в 76 раз больше за килограмм и лишь в 1,65 раза больше за доллар товара. Модальный сплит этого коридора — это не решение о фрахте, а решение о плотности стоимости.

Установка

Требуется Node ≥ 22.5 (использует встроенный SQLite — ноль нативных зависимостей, без node-gyp).

npm install && npm run build
npm run db:build -- --years 2025,2026        # fetches from the official source, builds SQLite

db:build загружает файлы напрямую с balanca.economia.gov.br. Пакет не распространяет никакие данные — база создаётся на вашей машине, всегда свежая из источника.

Четыре инструмента

Проверка

Агрегаты были проверены перекрёстной реализацией: один и тот же срез, обработанный одним проходом awk по сырому CSV и SQL-представлением этого сервера, даёт одинаковые значения до последней цифры (349 250 записей, 7 каналов, значения фрахта и веса).

npm test     # 12 tests covering the classification logic and the caveat registry

MIT. Данные: Comex Stat, Brazilian Foreign Trade Secretariat / Federal Revenue Service. Автор: Luis Delfin