SoapyRED/freightutils-mcp

Рассчитывает баллы освобождения по ADR 1.1.3.6 для "малой загрузки" для партии опасных грузов и сообщает, подпадает ли она под освобождение. Транспортная категория каждого вещества (Таблица A, столбец (15), 0-4) задаёт множитель баллов (1.1.3.6.4: категория 1 x50, 2 x3, 3 x1, 4 x0; девять записей note-a из ADR 1.1.3.6.3 UN 0081/0082/0084/0241/0331/0332/0482/1005/1017 имеют x20); баллы = количество x множитель. Правило (1.1.3.6.2) для опасных грузов, перевозимых в упаковках: грузы ОДНОЙ транспортной категории подпадают под освобождение, когда их ОБЩЕЕ количество на транспортной единице укладывается в максимум столбца (3) 1.1.3.6.3 для этой категории - категория 1: 20, 2: 333, 3: 1 000 (кг или л); записи note-a 50 кг; категория 4 без ограничений; категория 0: 0 - как бы оно ни делилось по строкам; грузы РАЗНЫХ категорий подпадают под освобождение, когда сумма баллов по 1.1.3.6.4 не превышает 1 000. Этот калькулятор также ограничивает каждую строку и каждое вещество, просуммированное по своим строкам, максимумом его категории - на смешанной партии это строже, чем 1.1.3.6.4 (консервативная сторона). Вещества транспортной категории 0 НИКОГДА не могут использовать это освобождение - has_category_zero помечает их. Укажите un_number + quantity для одного вещества ИЛИ items[] для партии - никогда оба: любое поле формы для одного вещества (un_number, quantity, packing_group, variant_index, unit, basis), отправленное рядом с items[], отклоняется (API отвечает 400 и называет поле), а не отбрасывается - поместите его в тот item, к которому оно относится, вещество как отдельный item. Количества указываются в кг или литрах согласно единице ADR для вещества. un_number также принимает воздушный номер с префиксом ID (например, "ID8000") - см. Routing. UN с несколькими вариантами: номер UN, у которого больше одной строки в ADR Table A (вариант по packing group / концентрации - например, UN 1789 PG II и PG III имеют разные транспортные категории), требует packing_group (I|II|III) или variant_index (из adr_lookup), чтобы зафиксировать одну строку. packing_group, после которого всё ещё остаётся несколько строк, достаточно, когда эти строки совпадают по классу, транспортной категории, области применения и учитываемому измерению 1.1.3.6.3 (UN 1790 PG I: две…

Ищет справочные данные по европейским правилам перевозки опасных грузов автомобильным транспортом (ADR 2025) для вещества: класс опасности, код классификации, группа упаковки, знаки опасности, специальные положения, ограниченные/освобождённые количества, транспортная категория, код ограничения проезда через туннели и номер Kemler (идентификация опасности). Охватывает 2 939 записей по всем 9 классам опасности из UNECE ADR 2025 (ECE/TRANS/352). Принимает ровно ОДИН из параметров: un_number (точный поиск, возвращает все варианты группы упаковки для этого номера UN), search (частичное совпадение по надлежащему отгрузочному наименованию без учёта регистра) или hazard_class (все записи класса или подкласса). un_number нормализуется: "1203", "UN1203" и "un 1203" равнозначны, а normalized_input сообщает о приведении; у взрывчатых веществ сохраняется ведущий ноль ("0004"). Поведение: справочный поиск только для чтения; поиск по имени или фильтр по классу выдаёт постраничный список: total, truncated и next_offset вместе с offset и limit (не больше 50 на страницу поиска и 100 на страницу класса), список никогда не обрезается молча. Поиск без результатов отдаёт ошибку с подсказками: ближайшие надлежащие отгрузочные наименования из таблицы A ("acetne" → ACETONE, UN 1090). 28 строк таблицы A содержат примечание о сфере применения вместо группы упаковки: для них возвращается packing_group null и not_subject_to_adr (с conditions_ref, например "5.5.3" для UN 1845, сухой лёд) либо carriage_prohibited, а table_a_remark сохраняет дословный текст таблицы A. Есть ограничение частоты запросов: ошибка лимита содержит reset_at - время в UTC, когда счётчик сбрасывается. Возвращает: count и results[] - по каждой записи: un_number, proper_shipping_name, class, classification_code, packing_group, labels, special_provisions, limited_quantity, excepted_quantity, transport_category, tunnel_restriction_code, hazard_identification_number, variant_index/variant_count, а для строк с пометкой о сфере применения - not_subject_to_adr/carriage_prohibited/conditions_ref/table_a_remark - внутри result, плюс confidence, _source и citation (обёртка ответа FreightUtils v1). Ограничения: фактическая подборка данных из таблицы ADR, а не юридическая консультация и не проверка соответствия…

Проверяет, подпадают ли опасные грузы под освобождение ADR Limited Quantity (LQ, ADR 3.4) или Excepted Quantity (EQ, ADR 3.5). LQ сравнивает количество в каждой внутренней упаковке с максимальным значением LQ для этого вещества; EQ определяет E-код вещества (E0-E5) и проверяет предел для внутренней упаковки, а также предел для внешней упаковки, если указано inner_packaging_qty. Укажите mode ("lq" или "eq") и 1-20 позиций, каждая с un_number, quantity и unit: мл или л для жидкостей, г или кг для твёрдых веществ; quantity указывается на ВНУТРЕННЮЮ упаковку, а не на всю партию. Единицы измерения: столбец (7a) указывает предел в ОДНОМ измерении: массу для одних записей, объём для других, а ADR не предоставляет плотность, поэтому массу НЕЛЬЗЯ сравнить с объёмным пределом (или наоборот). Такие позиции возвращают статус 'inconclusive' с указанием измерения, никогда не 'pass' и не 'fail', и партия, содержащая любую позицию с результатом 'inconclusive', никогда не получает overall_status 'qualifies'. Передайте quantity в единице, указанной в lq_limit_unit, чтобы получить вердикт. Многовариантные UN: номер UN с более чем одной строкой таблицы A ADR (группа упаковки / вариант концентрации, например UN 1789 PG II LQ 1 л против PG III LQ 5 л) требует packing_group (I|II|III) или variant_index (из adr_lookup) для этой позиции, чтобы зафиксировать одну строку. Если packing_group всё ещё оставляет несколько строк, этого достаточно, когда эти строки совпадают по классу, столбцу (7a), столбцу (7b) и области действия (UN 1790 PG I: две концентрационные полосы, обе LQ 0 / E0): позиция получает ответ с equivalent_variants + variant_note, где перечислены строки, которые она охватывает; только когда строки РАЗЛИЧАЮТСЯ, инструмент всё равно запрашивает variant_index, и тогда candidates[] перечисляет только строки этой группы упаковки. Без какого-либо уточняющего параметра: одиночный вызов или партия, где КАЖДАЯ позиция неоднозначна, возвращает blocking_errors[AMBIGUOUS_UN_VARIANT] + human_review_required + candidates[] (для каждого кандидата: item_index, un_number, variant_index, packing_group, proper_shipping_name, limited_quantity, excepted_quantity) и НИКАКОГО вердикта; смешанная партия не возвращает только неоднозначные…

Ищет 6 357 авиакомпаний по названию, коду IATA, коду ICAO, префиксу AWB или стране. Префикс AWB - это первые 3 цифры номера авиагрузовой накладной (air waybill), он указывает на перевозчика, выдавшего документ (например, 176 = Emirates). Принимает ОДИН параметр: query - это ранжированный нечёткий поиск по названиям и кодам; iata / icao / prefix / country - точные фильтры. Поведение: только чтение; попадания по нечёткому запросу сообщают о качестве совпадения через confidence в конверте (основание match_quality, оценка 0-1) с уведомлением FUZZY_BEST_MATCH, которое называет совпавшее поле; запрос, в котором нет названия, откатывается к ближайшим названиям из набора данных («Emirats» → Emirates). Ответ на query или country - это список: сводные строки, 25 на страницу, с total, truncated и next_offset (full: true для полных записей); ответ на iata / icao / prefix - это полные записи владельца. Есть ограничение по частоте запросов: ошибка лимита несёт reset_at - время в UTC, когда лимит сбрасывается. Возвращает: count и results[] - по каждой авиакомпании: airline_name, iata_code, icao_code, awb_prefix[], callsign, country, has_cargo и поля verification (aliases и sources в полных записях) - внутри result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Ограничения: происхождение этого набора данных ждёт независимой проверки (об этом говорит provenance_status в конверте) - критичные для работы коды сверяйте с IATA/ICAO или с самим перевозчиком. Связанные: airport_lookup (ищет АЭРОПОРТЫ, а не перевозчиков), validate (проверяет контрольную цифру номера AWB и определяет его авиакомпанию по этому набору данных).

Ищет аэропорт по коду IATA (3 буквы, например "LHR"), коду ICAO (4 символа, например "EGLL") или по названию/городу в свободном тексте (например "heathrow"). Охватывает 85 555 аэропортов по всему миру (OurAirports, общественное достояние, сверено с OpenFlights + Wikidata). Укажите ОДИН из параметров: iata, icao или query; необязательный фильтр type сужает результаты. Поведение: только чтение; точное совпадение по коду возвращает одну запись; неоднозначный поиск по названию возвращает ранжированных кандидатов (сначала точные коды, потом более крупные аэропорты), качество совпадения передаётся через confidence конверта (основание match_quality); неизвестный код выдаёт ошибку с сообщением not-found. Есть ограничение частоты: ошибка лимита содержит reset_at - время в UTC, когда лимит сбрасывается. Возвращает: count и results[] - по каждому аэропорту: IATA + ICAO/ident, название, type (large/medium/small/heliport/closed/seaplane), municipality, region, country, latitude/longitude и elevation_ft - внутри result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Ограничения: только справочные данные - не для навигации; критичные для работы коды проверяйте в IATA / ICAO. Связанные: nearest_airport (ищет аэропорты ОТ координаты), airline_lookup (ищет ПЕРЕВОЗЧИКОВ / префиксы AWB, не аэропорты), unlocode_lookup (общие транспортные локации, аэропорты - одна из их функций).

Вычисляет кубические метры (CBM) для партии по размерам одной штуки. CBM - стандартная единица объёма в международных перевозках: 1 CBM = 1m x 1m x 1m = 1 000 литров, а стоимость морской перевозки считают за "фрахтовую тонну" (1 CBM или 1 000 кг, что больше). Поведение: детерминированное - одинаковые входные данные всегда дают одинаковые цифры; общий объём = pieces x CBM на штуку (итоги считаются по неокруглённым значениям и округляются только для отображения), с пересчётом в кубические футы, кубические дюймы и литры (точные коэффициенты: 1 ft = 0.3048 m). Отсутствующие или неположительные размеры дают ошибку с сообщением валидации, в котором назван параметр. Ограничение частоты: ошибка лимита содержит reset_at - время UTC, когда сбрасывается лимит. Возвращает: cbm_per_piece, total_cbm, cubic_feet, litres, cubic_inches и pieces внутри result, а также confidence, _source и citation (конверт ответа FreightUtils v1). Имена полей такие, как их отдаёт этот пакет (snake_case); размещённый эндпоинт /api/mcp отдаёт те же поля в camelCase (например, total_cbm → totalCbm). Связанные: chargeable_weight_calculator (оплачиваемый вес для авиаперевозки по тем же размерам), consignment_calculator (итоги по нескольким строкам), unit_converter (отдельные преобразования), shipment_summary (полный составной анализ).

Рассчитывает оплачиваемый вес авиагруза - больший из фактического веса брутто и объёмного веса, именно его авиакомпании и выставляют к оплате. Объёмный вес (кг) = (L x W x H в см) / делитель; стандартный делитель IATA - 6 000 (1 CBM = 166,67 кг), а экспресс-перевозчики (DHL, FedEx, UPS) обычно используют 5 000. Поведение: детерминированное; размеры даны на одну штуку, а gross_weight_kg - это ОБЩИЙ вес всех штук; итоги считаются по неокруглённым значениям и округляются только для отображения (10 000 штук по 5 x 5 x 6 см = 250 кг); basis сообщает, какой вес берётся за основу ("volumetric" = груз лёгкий для своего размера, "actual" = плотный). Только авиарежим - морской W/M (1 CBM = 1 000 кг) покрывается consignment_calculator с mode=sea. Отсутствующие или неположительные входные данные дают ошибку с указанием проблемного параметра. Ограничение по частоте: ошибка лимита несёт reset_at - время UTC, когда лимит сбрасывается. Возвращает: chargeable_weight_kg, basis, volumetric_weight_kg (итоговый; на hosted-эндпоинте называется volumetricWeightTotalKg) и volumetric_weight_per_piece_kg, gross_weight_kg, cbm, ratio, factor и pieces внутри result; normalized_input повторяет интерпретированные входные данные (gross_weight_basis, dimensions_basis) и все применённые значения по умолчанию; плюс confidence, _source и citation (конверт ответа FreightUtils v1). Имена полей такие, как их отдаёт этот пакет (snake_case); hosted-эндпоинт /api/mcp отдаёт те же поля в camelCase (например, total_cbm → totalCbm). Связанные: cbm_calculator (только объём), consignment_calculator (несколько строк, все режимы), uld_lookup (оборудование, в котором летит груз).

Вычисляет построчные и общие итоги для смешанной партии из нескольких позиций: CBM, погрузочные метры (LDM), объёмный вес и зависящий от вида перевозки расчётный показатель (расчётный вес для авиа, доходные тонны для моря, LDM для автоперевозок), а также объективные информационные флаги. Укажите mode (sea | air | road, по умолчанию road) и либо lines[] (канонический вариант - по строке: quantity, dims {l,w,h,unit}, weight {value,unit}, необязательные description / hs_code / un_number / stackable), либо устаревший плоский items[] (размеры в см, вес в кг). Для авиа применяется объёмный делитель IATA (по умолчанию 6000, задаётся через options.air_volumetric_divisor); options.container_number / options.awb_number добавляют флаг проверки контрольной цифры. Поведение: детерминированное; флаги носят только информационный характер - неправдоподобная плотность, несоответствие вида перевозки и опции, наличие опасных грузов по номеру UN согласно ADR 2025 и корректность контрольной цифры контейнера/AWB - и никогда не утверждают, что груз разрешён или соответствует требованиям. Некорректные строки вызывают ошибку с указанием проблемного поля. Каноническая схема: https://www.freightutils.com/schema/consignment.v1.json. Есть ограничение частоты запросов: ошибка лимита содержит reset_at - время UTC, когда счётчик сбрасывается. Возвращает: schema_version, mode, per_line[] (cbm, gross_weight_kg, density, volumetric_weight_kg, ldm, revenue_tonnes, chargeable_weight_kg), totals (включая billing_basis) и flags[] внутри result, а также confidence, _source и citation (обёртка ответа FreightUtils v1). Ограничения: детерминированный расчёт и справочные данные по мере возможностей - это не регуляторная, таможенная консультация или консультация по соответствию для опасных грузов; классификация, документация и приёмка перевозчиком остаются на вашей ответственности. Связанные: cbm_calculator / chargeable_weight_calculator / ldm_calculator (версии с одним показателем), shipment_summary (добавляет подбор транспорта/контейнера и оценку пошлин), adr_lookup (что означает помеченный номер UN).

Получает характеристики морских контейнеров по ISO, с необязательным расчётом загрузки. Охватывает 10 типов: 20ft/40ft standard, 40ft и 45ft high-cube, 20ft/40ft reefer, 20ft/40ft open-top и 20ft/40ft flat-rack. Укажите тип в виде слага (например, "20ft-standard", "40ft-high-cube"), чтобы получить запись одного контейнера; пропустите его, чтобы вывести все 10 строками сводки (full: true для полных записей). Добавьте габариты предмета (item_length_cm/width_cm/height_cm, необязательные item_weight_kg и item_quantity), чтобы ещё посчитать, сколько таких предметов поместится. Поведение: справочные данные только для чтения, с происхождением для каждой записи (sources, audited_at, decision_rationale); тип читается в любом регистре, как код размера-типа ISO ("45G1") или краткая форма названия ("40HC"); неизвестный тип даёт ошибку со списком допустимых слагов и ближайшим из них ("20ft-standrd" → 20ft-standard). Расчёты вместимости - геометрическая прикидка: они не моделируют распределение нагрузки, крепление или смешанный груз. Есть ограничение по частоте запросов: ошибка лимита содержит reset_at - время в UTC, когда лимит сбрасывается. Возвращает: запись контейнера - внутренние/внешние/дверные размеры (см), capacity_cbm, tare_weight_kg, max_gross_kg, max_payload_kg и количество европаллет и паллет GMA - в result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Имена полей такие, как их отдаёт этот пакет (snake_case); размещённый endpoint /api/mcp отдаёт те же поля в camelCase (например, total_cbm → totalCbm). Список (когда отдельная запись не запрошена) возвращает строки сводки с total, truncated, next_offset и detail_hint; full: true возвращает полные записи по пять на страницу, с offset / limit для постраничного вывода. Ограничения: характеристики типичные для производителя, происхождение данных ждёт независимой проверки (об этом говорит provenance_status в конверте) - реальное оборудование различается у разных лизингодателей и линий; сверяйтесь с руководством по оборудованию перевозчика. Связанное: validate (проверяет контрольную цифру ISO 6346 у НОМЕРА контейнера - не характеристики), cbm_calculator / consignment_calculator (объём груза, чтобы его заполнить), uld_lookup (авиагрузовой…

Оценивает выбросы парниковых газов при грузоперевозке (kgCO2e) для отдельного участка отправки по ISO 14083:2023 / GLEC Framework v3.2: выбросы = масса x расстояние x опубликованный коэффициент интенсивности выбросов (kgCO2e/tonne-km). Укажите mass + distance_km + mode (road | rail | sea | air | inland_waterway); при желании выберите sub_mode, region/authority (uk = DEFRA, us = EPA, fr = ADEME) и basis (по умолчанию wtw, либо ttw). ВАЖНО: передавайте ФАКТИЧЕСКУЮ БРУТТО-МАССУ, а не объёмный/заряжаемый вес (частая ошибка в авиаперевозках - см. mass_basis в результате). Расстояние указывать обязательно - этот инструмент НЕ прокладывает маршрут, не геокодирует и не вычисляет расстояния. Поведение: результат детерминирован при одной и той же редакции коэффициента; среднепарковый коэффициент уже учитывает средний порожний пробег (см. empty_running) - НЕ добавляйте собственный участок порожнего возврата; для sea и air используются обобщённые значения по умолчанию с низкой репрезентативностью (реальные выбросы заметно зависят от судна/воздушного судна, коэффициента загрузки и маршрута - см. representativeness и сводку в результате). Неизвестный mode/sub_mode/region возвращает available:false со списком поддерживаемых вариантов, а не выдуманный коэффициент. Ограничение по частоте запросов: ошибка лимита содержит reset_at - время в UTC, когда лимит сбрасывается. Возвращает: выбросы well-to-wheel И tank-to-wheel там, где у коэффициента есть оба значения, точный использованный коэффициент (value, authority, edition), активность в тонно-километрах и _source для каждого результата со ссылкой И на метод ISO, И на конкретный открытый коэффициент - всё внутри result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Ограничения: справочная оценка по открытым коэффициентам (DEFRA / EPA / ADEME), выполненная по мере возможностей - НЕ проверенный и не прошедший аудит углеродный отчёт. Связанные: отличается от cbm_calculator / ldm_calculator / chargeable_weight_calculator (те считают габариты или выставляют счёт за отправку; этот оценивает её CO2e).

Возвращает URL страницы тарифов FreightUtils с лимитом запросов тарифа Pro (50 000 в месяц) и ценой. Используйте, когда пользователь спрашивает о тарифах FreightUtils, ценах или лимитах API. Поведение: статический локальный ответ, без вызова API, без ограничений по частоте запросов, без действий с аккаунтом или оплатой; пользователь открывает URL в браузере. Возвращает: url, tier, monthly_limit, monthly_price, currency и note в result.

Ищет 6 940 кодов товаров WCO Harmonized System (HS 2022) - международный слой классификации таможенных товаров на 6 цифрах. Первые 2 цифры - это глава, 4 - товарная позиция, 6 - субпозиция. Принимает один из: query (поиск по свободному текстовому описанию, минимум 2 символа), code (поиск по 2-6 цифрам, с точками или пробелами или без них - "8471.30" это 847130 - возвращает код и его иерархию) или section (римская цифра I-XXI для просмотра раздела). Поведение: только чтение; поиск по описанию сначала выполняется по официальным описаниям WCO HS; если ни одно не содержит слов, переключается на поисковые ссылки UK Trade Tariff (индекс HMRC для повседневных названий товаров), так "laptop" находит 847130, а "computers" находит товарную позицию 8471. Совпадение при переходе имеет среднюю уверенность: matched_via указывает на индекс HMRC, citation просит подтвердить код, а формальная формулировка тарифа ("automatic data processing machines") остаётся самым надёжным поиском. count 0 с пустым results[] - всё ещё допустимый ответ, когда ни один не находит слова. Ограничение скорости: ошибка лимита содержит reset_at, время UTC, когда лимит сбрасывается. Возвращает: эхо query/code, count и results[] (hscode, description и контекст иерархии) в result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Ограничения: только международный уровень на 6 цифрах - национальные тарифные линии (8-10 цифр) и ставки пошлин устанавливаются по странам; классификация здесь ориентировочная, а не обязательное решение. Связанные: uk_duty_calculator (пошлина/НДС для найденного здесь кода), ics2_check (качество описания товаров в EU ENS - совсем другая проверка).

Проверяет описание товара по официальному списку стоп-слов EU ICS2 - терминов, которые Еврокомиссия считает слишком расплывчатыми или общими для поля описания товара в декларации краткого описания груза (ENS) (элемент данных 18 05 000 000). Передайте description=<goods description>. Как работает: детерминированное сопоставление терминов с действующим списком ЕС; каждый отмеченный термин идёт с примечанием (отдельное стоп-слово означает автоматический отказ, встроенное - значит, описание надо сделать конкретнее); clean=true означает, что ни один термин из списка не совпал, но это НЕ гарантирует принятия, и бинарный вердикт принято/отклонено не выдаётся. Есть ограничение по частоте запросов: ошибка лимита содержит reset_at - время в UTC, когда лимит сбрасывается. Возвращает: эхо описания, flagged[] (термин + примечание), clean, caveat и disclaimer внутри result, а также _source со ссылкой на список ЕС и правовое основание, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Ограничения: СТРОГО справочная проверка - не подача ENS, не определение соответствия таможенным требованиям, не юридическая консультация; список ЕС неисчерпывающий и периодически обновляется. Связанные: hs_code_lookup (коды товаров - другое поле ENS), uk_duty_calculator (пошлины/НДС, к проверке по ENS отношения не имеет). Предназначен для проверки описания товара перед подачей ENS.

Ищет 11 торговых правил Incoterms 2020: кто платит за перевозку, страхование и таможенное оформление и в какой момент риск переходит от продавца к покупателю. 7 правил работают при любом виде транспорта (EXW, FCA, CPT, CIP, DAP, DPU, DDP); 4 только для морских и внутренних водных перевозок (FAS, FOB, CFR, CIF). Принимает code для одного правила, category (any_mode | sea_only) для отфильтрованного списка или ничего, чтобы вывести все 11 (список - это строки-сводки: code, name, category, summary, а full: true даёт полные правила). Поведение: справочник только для чтения; неизвестный код выдаёт ошибку со списком допустимых кодов, а DAT, заменённый в Incoterms 2020, называет своего преемника - DPU (ICC). Есть ограничение частоты запросов: ошибка лимита содержит reset_at - время в UTC, когда лимит сбрасывается. Возвращает: запись правила (name, category, summary, seller_responsibility, buyer_responsibility, risk_transfer, cost_transfer, insurance, export/import clearance, best_for и watch_out) в поле result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Ограничения: сжатые рекомендации по ICC Incoterms 2020; обязательным текстом считается публикация ICC, а приоритет имеет конкретная формулировка контракта. Связанные: uk_duty_calculator (принимает инкотерм при расчёте стоимости CIF), shipment_summary (составной анализ).

Считает погрузочные метры (LDM) для европейских автоперевозок: сколько длины прицепа занимает партия паллет. 1 LDM = 1 погонный метр прицепа шириной 2,4 м; стандартная фура - это 13,6 LDM. Укажите пресет паллеты ИЛИ свои length_mm + width_mm; если не указать ни то, ни другое, вернётся ошибка с подсказкой по использованию. Поведение: детерминированное; stackable=true со stack_height 2 или 3 делит площадь на полу соответственно; fits равен true только когда груз укладывается в ДЛИНУ транспортного средства, в его МЕСТА ПОД ПАЛЛЕТЫ на полу и - если задан weight_kg - в его максимальную ГРУЗОПОДЪЁМНОСТЬ; каждый несоблюдённый лимит назван в warnings[] вместе со своими числами. Паллеты Euro и UK считаются за собственные места на полу (pallet_spaces.basis говорит, какие именно), остальные габариты - как эквиваленты Euro. Места на полу у транспортного средства берутся из собственного количества в его записи только тогда, когда это количество отражает места на полу; количество, ограниченное весом или непроверенное (у 7,5-тонного одиночного грузовика в записи 8, а его платформа 6,1 x 2,4 м вмещает 15), таким не является, и тогда места берутся из платформы - pallet_spaces.floor_positions_basis говорит, откуда именно, record_count - это хранимая цифра. Без weight_kg грузоподъёмность не проверяется: payload_checked равен false, а информационное предупреждение сообщает грузоподъёмность. utilisation_percent считается от длины транспортного средства. Есть ограничение по частоте запросов: ошибка лимита содержит reset_at - время UTC, когда лимит сбрасывается. Возвращает: ldm, vehicle (name, length_m, max_payload_kg), utilisation_percent, pallet_spaces (used, available, basis, floor_positions_basis, floor_positions_note, record_count, record_count_basis), total_weight_kg, payload_checked, fits и warnings внутри result, а также confidence, _source и citation (конверт ответа FreightUtils v1). Имена полей такие, как их отдаёт этот пакет (snake_case); размещённый на хосте эндпоинт /api/mcp отдаёт те же поля в camelCase (например, total_cbm → totalCbm). Связанные: vehicle_lookup (характеристики прицепов, лежащие в основе пресетов транспортных средств), pallet_fitting_calculator (коробки на одну паллету), consignment_calculator (смешанные позиции, включая LDM).

Находит аэропорты, ближайшие к указанным пользователем широте и долготе, сортирует по расстоянию по большому кругу (haversine) и добавляет distance_km к каждому результату. Ищет по 85 555 аэропортам (OurAirports, общественное достояние). Принимает широту и долготу (в десятичных градусах); необязательные radius_km, max_results (1-50, по умолчанию 10) и фильтр по типу (например, только large_airport). Координаты только ВХОДНЫЕ - ничего не сохраняется и не логируется. Поведение: детерминированная сортировка по расстоянию; confidence отражает близость и размер аэропорта (большой аэропорт в пределах 25 км получает высокую оценку; закрытые, вертолётные и гидроаэропорты получают меньший потолок). Этот инструмент НЕ геокодирует названия мест и НЕ вычисляет маршруты - передавайте координаты, которые у вас уже есть. Есть ограничение по частоте: при ошибке лимита возвращается reset_at, время в UTC, когда лимит сбросится. Возвращает: count и results[] (запись аэропорта плюс distance_km) в поле result, а также confidence, _source и citation (конверт ответа FreightUtils v1). Ограничения: только справочные данные - не для навигации; проверяйте коды по IATA / ICAO. Связанные: airport_lookup (поиск по точному коду или названию, без расстояния), unlocode_lookup (поиск по названию транспортного объекта).

Считает, сколько одинаковых коробок влезает на паллету: коробок в слое (с пробой поворота на 90 градусов, когда это разрешено), число слоёв в пределах максимальной высоты, итоги, использование площади и объёма, а также ограничение по весу. Поведение: детерминированная геометрическая укладка одного размера коробки ровными рядами и столбцами - не моделирует перекрёстные схемы или схемы со смешанной ориентацией; weight_limited сообщает, когда max_payload_kg ограничивает количество ниже геометрической вместимости, считая целыми слоями (в примечаниях сказано, когда неполный слой отбрасывается и почему ничего не помещается, когда ни одна коробка не влезает); pallet_deck_height_cm по умолчанию равен 15. Отсутствующие или неположительные размеры дают ошибку с именем параметра. Есть ограничение частоты: ошибка лимита несёт reset_at - время UTC, когда лимит сбрасывается. Возвращает: boxes_per_layer, layers, total_boxes, orientation, boxes_per_row/col, usable_height_cm, utilisation_percent (доля ПЛОЩАДИ паллеты, которую покрывает один слой), volume_utilisation_percent (объём коробок к полезному объёму), total_box_volume_cbm, wasted_space_cbm, max_boxes_by_weight, notes и поля веса внутри result, а также confidence, _source и citation (конверт ответа FreightUtils v1). Имена полей такие, как их отдаёт этот пакет (snake_case); размещённый на сервере эндпоинт /api/mcp отдаёт те же поля в camelCase (например, total_cbm → totalCbm). Ограничения: теоретическая укладка по максимуму - реальная штабелировка подчиняется правилам прочности коробок, свеса и устойчивости груза, которые он не моделирует. Связанные: ldm_calculator (паллеты в длину прицепа), vehicle_lookup (вместимость паллет на транспортное средство), container_lookup (паллеты в контейнеры).

Разрешает произвольный идентификатор груза: на входе одна непрозрачная строка, на выходе типизированные кандидаты с указанием источников. Используйте, когда у вас есть один токен, похожий на идентификатор ("176", "UN1845", "NLRTM", "FOB", "22G1", "MSKU1100810", "D/E"), и вы не знаете, что это за идентификатор: каждый кандидат указывает свой тип сущности и содержит api_url и canonical_url своей полной записи. Укажите q: ОДИН идентификатор (один токен, максимум 32 символа). Запускаются все тринадцать грамматик: номера UN, префиксы AWB, IATA/ICAO авиакомпаний, IATA/ICAO аэропортов, UN/LOCODE, номера контейнеров ISO 6346 (контрольная цифра вычисляется), коды HS (6-10 цифр; национальные строки разрешаются по их 6-значному международному родителю), Incoterms, коды туннелей ADR, серийные номера ULD, коды размера/типа контейнеров ISO. Неоднозначность - это результат: конфликтующие грамматики возвращают НЕСКОЛЬКО ранжированных кандидатов ("LHR" - это Heathrow И ICAO египетского перевозчика), никогда не молчаливая догадка. Поведение: детерминированное - нормализует (обрезка, верхний регистр, сжатие пробелов/дефисов, удаление префикса UN), сопоставляет ВСЕ грамматики, ранжирует по попаданию в запись > статусу верификации > априорной вероятности статического набора данных (авиакомпании/adr/unlocode в первую очередь) > стабильному тай-брейку; каждый кандидат содержит rank_basis, так что порядок можно проверить. Ноль кандидатов - это ДОПУСТИМЫЙ результат (count 0 + note), никогда не ошибка. Неудачная контрольная цифра контейнера возвращает кандидата с valid:false, а не отбрасывает его. Ограничение скорости: ошибка лимита содержит reset_at, время UTC, когда сбрасывается разрешение. Возвращает: query, normalized, count и candidates[] - каждый с entity_type, identifier_type, value_normalized, summary, record (основные поля, которые содержит соответствующий набор данных), verification_status + verification_basis, rank_basis, canonical_url, api_url и ссылкой на набор данных для каждого кандидата - под result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Ограничения: v1 - это РАЗРЕШЕНИЕ ОДНОГО ТОКЕНА, а не извлечение свободного текста - передайте один идентификатор, а не строку манифеста; коды SCAC/BIC пока не поддерживаются; совпадение утверждает, что идентификатор известен/правильно сформирован,…

Комплексный анализ отправки за один вызов: объём (CBM), вес брутто и оплачиваемый вес, дорожный LDM с паллетоместами и подсказкой по транспортному средству (режим road), объёмный вес (air), доходные тонны с подсказкой по контейнеру (sea), наличие опасных грузов для позиций с un_number и оценка пошлины Великобритании для позиций с hs_code + customs_value. Укажите mode (road | air | sea | multimodal) и items[] (габариты в см, вес в кг НА ПОЗИЦИЮ, quantity; необязательные stackable, pallet_type, hs_code, un_number, customs_value НА ПОЗИЦИЮ и adr_quantity - СУММАРНОЕ значение для строки опасного груза, все места вместе); origin/destination и incoterm уточняют расчёт пошлины. Поведение: напрямую вызывает движки ldm_calculator, adr_lookup и uk_duty_calculator; CBM, объёмный вес и доходные тонны считаются той же арифметикой на месте, а не отдельным вызовом. Дорожный LDM использует делитель по конвенции погрузочного метра 2,40 м и, как и ldm_calculator, считает позицию без флага stackable как НЕштабелируемую. modeSpecific.palletSpaces - это ПАЛЛЕТНЫЕ МЕСТА НА ПОЛУ (цифра, которую сообщает ldm_calculator); palletRows - отдельное число рядов. Предлагаемое транспортное средство - самое маленькое, которое вмещает груз по длине, полезной нагрузке и паллетным местам на полу: берётся число из самой записи, если это число мест на полу, иначе оно вычисляется по грузовой платформе ТС (7,5-тонный жёсткий грузовик вмещает 15 европаллет на полу; modeSpecific.suggestedVehicleFloorPositions говорит, какое именно), а trailerUtilisation считается для этого транспортного средства (utilisationBasis его называет); предлагаемый контейнер - самый маленький сухой контейнер, чья запись вмещает объём и полезную нагрузку. Разделы, которые не могут выполниться (например, пошлина без customs_value), попадают в warnings вместо того, чтобы завалить весь вызов. Поля проверяются по имени: поле, которое инструмент не читает, отклоняется с ошибкой инструмента, где оно названо и перечислены допустимые, и никогда не игнорируется. Есть ограничение по частоте: ошибка лимита несёт reset_at - время UTC, когда сбрасывается лимит. Возвращает: mode, itemCount, totals {pieces, grossWeight, volumeCBM,…

Оценивает пошлину и НДС при импорте в Великобританию по коду товара, используя ЖИВОЙ GOV.UK Trade Tariff: ставки запрашиваются на каждый запрос, а не берутся из статичной таблицы. Значение CIF складывается из customs_value + freight_cost + insurance_cost; пошлина = CIF x ставка пошлины для страны происхождения; НДС (обычно 20%) начисляется на стоимость с учётом пошлины. Укажите commodity_code (декларируемый 10-значный код), origin_country (ISO-2) и customs_value в GBP; freight_cost, insurance_cost и incoterm - необязательные уточнения. Поведение: живой запрос плюс детерминированная арифметика по полученной ставке; 6- или 8-значный код отклоняется (никогда не дополняется нулями до кода, который вы не отправляли) вместе с declarable_codes - 10-значными кодами под ним в UK Trade Tariff (610910 → 6109100010, 6109100090); страна происхождения, не входящая в ISO 3166-1, отклоняется; меры, зависящие от происхождения, которые тариф не может определить автоматически, попадают в warnings. Ограничение частоты: ошибка лимита несёт reset_at - время в UTC, когда лимит сбрасывается. Возвращает: commodity_code и description, страну происхождения, cif_value, duty_rate (+ percent), duty_amount, vat_rate, vat_amount, total_import_taxes, total_landed_cost и warnings внутри result (суммы в GBP); validity.as_of отмечает метку времени живой ставки; плюс confidence, _source и citation (конверт ответа FreightUtils v1). Имена полей такие, как их отдаёт этот пакет (snake_case); размещённый эндпоинт /api/mcp отдаёт те же поля в camelCase (например, total_cbm → totalCbm). Ограничения: это оценка, а не таможенное решение - акцизы, квоты, антидемпинговые меры, льготы и требования подтверждения происхождения могут изменить результат; уточните у таможенного брокера или в HMRC, прежде чем полагаться на неё. Связанные инструменты: hs_code_lookup (сначала найдите 6-значный код), incoterms_lookup (кто на самом деле платит эти расходы).

Ищет спецификации авиагрузовых ULD (Unit Load Device) - 16 типов, охватывающих контейнеры нижней палубы (AKE/LD3 и семейство), паллеты основной палубы (PMC, PAG и семейство) и терморегулируемые блоки. Каждая запись содержит внешние/внутренние/дверные размеры (см), тару и максимальный полный вес (кг), полезный объём (м³), позицию на палубе и совместимые воздушные суда. Укажите тип как код IATA ("AKE", "PMC"), слаг ("ake-ld3") или собственное имя записи, когда одна запись его несёт ("LD3" → AKE); опустите его, чтобы вывести все 16; категория (container | pallet | special) и палуба (lower | main) фильтруют список. Поведение: только чтение; неизвестный тип выдаёт ошибку с ближайшими кодами; отдельная запись содержит своё происхождение (sources, audited_at, decision_rationale). Список (если не запрошена отдельная запись) возвращает строки сводки с total, truncated, next_offset и detail_hint; full: true возвращает полные записи по пять на страницу, с offset / limit для постраничного вывода. Ограничение скорости: ошибка лимита содержит reset_at, время UTC, когда сбрасывается лимит. Возвращает: запись ULD (или список) в result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Имена полей такие, как их отдаёт этот пакет (snake_case); размещённый эндпоинт /api/mcp отдаёт те же поля в camelCase (например, total_cbm → totalCbm). Ограничения: спецификации собраны из источников, опубликованных производителями и перевозчиками, с ≥7 цитируемыми источниками на запись. Происхождение PENDING, не проверено - читайте provenance_status конверта, а не это предложение. Покрытие вторым агентом теперь COMPLETE - второй агент открыл и оценил каждую цитируемую пару запись-URL, и 145 из 148 цитирований имеют отметку времени о прочтении (3 без неё никогда не открывались и сообщают об этом). COVERAGE IS NOT AGREEMENT, поэтому происхождение всё ещё pending: чтение каждой страницы сделало разногласия видимыми, а не разрешило их. Второй агент также ОТОЗЫВАЕТ отметки - страницы, которые первый проход подтвердил, оказались не содержащими код или разошлись после…

Преобразует грузовые и логистические единицы: вес (kg, lbs, oz, tonnes, short_tons, long_tons), объём (cbm, cuft, cuin, litres, gal_us, gal_uk), длину (cm, inches, m, feet, mm), плюс две грузовые цели, допустимые только ИЗ cbm: chargeable_kg (объёмный авиационный вес по делителю IATA 6,000: m³ x 1,000,000 / 6000) и freight_tonnes (морской W/M, 1 CBM = 1 freight tonne). Поведение: детерминированное, на точных законодательно установленных коэффициентах (1 lb = 0.45359237 kg, 1 in = 2.54 cm); ответ называет обе единицы и указывает использованную формулу. Кросс-размерные преобразования (например, kg в litres), отрицательное значение и грузовые цели из источника, отличного от cbm, отклоняются, а допустимые единицы перечисляются по категориям. Примечание: short ton (US) = 2,000 lb, long ton (UK) = 2,240 lb, metric tonne = 2,204.6 lb. Ограничение частоты: ошибка лимита содержит reset_at, время UTC, когда сбрасывается квота. Возвращает: input {value, unit, name}, result {value, unit, name}, formula и note внутри result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Связанные: cbm_calculator (сначала размеры в объём), chargeable_weight_calculator (правильный авиационный биллинговый вес с местами и настраиваемым делителем).

Ищет 116 232 транспортных объекта UN/LOCODE по всему миру: порты, аэропорты, железнодорожные и автомобильные терминалы, внутренние контейнерные депо и пограничные переходы. Код состоит из 5 символов: 2-буквенный код страны по ISO + 3-символьный код локации (GBLHR = London Heathrow, NLRTM = Rotterdam). Принимает код для точной записи либо запрос (поиск по названию, минимум 2 символа), который можно сузить по стране и function_type; limit ограничивает число результатов (по умолчанию 20, максимум 100). Запись с пробелом «GB LHR» читается как GBLHR в любом из вариантов. Поведение: только чтение; точные совпадения по коду строятся на основе provenance, а нечёткие совпадения по названию сообщают о качестве совпадения через confidence в конверте (basis match_quality); неизвестный код возвращает ошибку с сообщением о том, что запись не найдена. Есть ограничение частоты: ошибка лимита несёт reset_at - время в UTC, когда сбросится квота. Возвращает: записи о локациях - code, name и name_ascii, country, subdivision, functions[], status, coordinates {lat, lon} и iata_code, где он присвоен - в поле result, а также confidence, _source и citation (конверт ответа FreightUtils v1). Ограничения: это административный список кодов (UNECE UN/LOCODE 2025-1) - перед критичным использованием уточняйте рабочий статус и координаты у порта или ведомства. Связанные: airport_lookup (записи по конкретным аэропортам, включая коды ICAO), nearest_airport (поиск аэропортов по координатам).

Проверяет и разбирает грузовые идентификаторы по их публичным алгоритмам контрольных цифр: номера морских контейнеров (ISO 6346), номера авианакладных (AWB) (IATA, модуль 7) и идентификационные номера судов IMO. Два режима: передайте text=<произвольная строка>, чтобы найти и проверить все идентификаторы в ней (например, строку из письма с бронированием), ИЛИ передайте value=<идентификатор> + type=<container|awb|imo>, чтобы проверить один. Поведение: детерминированная арифметика контрольных цифр; по каждому найденному идентификатору сообщает тип, нормализованную форму, valid (проходит/не проходит), ожидаемую и фактическую контрольную цифру, а также детали (container: префикс владельца + категория оборудования; AWB: префикс авиакомпании + авиакомпания-оператор, определённая из набора данных префиксов AWB; IMO: 7-значный номер); режим text, когда идентификаторы не найдены, возвращает пустой found[] с примечанием. Есть ограничение частоты: ошибка лимита содержит reset_at - время в UTC, когда лимит сбрасывается. Возвращает: found[] (каждая запись со своим _source, указывающим применённый стандарт) и disclaimer внутри result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Ограничения: ТОЛЬКО СТРУКТУРА - валидная контрольная цифра означает корректный формат, а НЕ то, что контейнер, отправка или судно существуют или активны; это не поиск по реестру и не трекинг. Связанные: container_lookup (спецификации ТИПОВ контейнеров, а не номера), airline_lookup (набор данных префиксов AWB, по которому определяется авиакомпания).

Ищет характеристики грузовых автомобилей и прицепов для автоперевозок - 17 типов: прицепы-шторы EU (standard/mega curtainsider, box, reefer, double-deck, flatbed, low-loader), US 53ft/48ft dry vans, жёсткие грузовики (rigid, 7,5-26 т) и фургоны (Luton, Transit, Sprinter). Каждая запись несёт внутренние размеры, полезную нагрузку и полную массу, вместимость по паллетам euro/UK, схему осей и особенности. Укажите slug (например, "standard-curtainsider"), чтобы получить одну запись; опустите его, чтобы вывести список всех 17; category (articulated | rigid | van) и region (EU | US) фильтруют список. Поведение: только чтение; неизвестный slug выдаёт ошибку со списком допустимых и ближайшими slug; одиночная запись несёт сведения о происхождении (sources, audited_at, decision_rationale). Список (когда конкретную запись не запрашивали) возвращает сводные строки с total, truncated, next_offset и detail_hint; full: true возвращает полные записи по пять на страницу, а offset / limit задают постраничный вывод. Есть ограничение по частоте: ошибка лимита несёт reset_at - время в UTC, когда лимит сбрасывается. Возвращает: запись автомобиля (или список) в поле result, плюс confidence, _source и citation (конверт ответа FreightUtils v1). Имена полей такие, как их отдаёт этот пакет (snake_case); размещённый эндпоинт /api/mcp отдаёт те же поля в camelCase (например, total_cbm → totalCbm). Ограничения: типовые характеристики, происхождение ждёт независимой проверки (об этом говорит provenance_status в конверте) - реальное оборудование отличается от оператора к оператору и от сборки к сборке; легальную полезную нагрузку задают паспортные массы автомобиля. Связанные: ldm_calculator (поместится ли паллетная загрузка), pallet_fitting_calculator, consignment_calculator.