nexusforge-tools/mcp-eu-finance

Загружает последние данные по инфляции, росту ВВП и безработице для 2-10 стран Евросоюза одним параллельным вызовом к Eurostat. Возвращает JSON-объект с полями: countries (массив срезов по каждой стране: country — полное название, country_code, inflation — {rate, period} или null, gdp_growth — {rate, period} или null, unemployment — {rate, period} или null), source и retrieved_at в формате ISO 8601. Каждый показатель возвращает единственное последнее доступное значение. Период инфляции — ГГГГ-ММ; период ВВП — ГГГГ-Ккв; период безработицы — ГГГГ-ММ. Данные кэшируются на 24 часа. ИСПОЛЬЗОВАНИЕ: при сборке дашбордов или сравнении нескольких показателей предпочитайте этот инструмент отдельным вызовам get_eu_inflation, get_eu_gdp и get_eu_unemployment — он снижает задержку за счёт параллелизации трёх запросов к Eurostat. Периоды показателей могут различаться из-за разного графика публикации Eurostat (инфляция отстаёт примерно на 30 дней, ВВП — на 90). Поле показателя равно null, если Eurostat не опубликовал свежие данные — всегда корректно обрабатывайте null. С помощью параметра indicators можно пропустить ненужные метрики и уменьшить число API-вызовов.

Получает три ключевые процентные ставки ЕЦБ из статистического хранилища данных ЕЦБ (SDMX). Возвращает JSON-объект с полем rates, содержащим три записи — deposit_facility, main_refinancing и marginal_lending — каждая с полями date (дата последнего изменения ставки в формате ГГГГ-ММ-ДД) и value (значение в процентах в виде числа). Также включает поля source и retrieved_at в формате ISO 8601. Результаты кэшируются на 1 час. ИСПОЛЬЗОВАНИЕ: это ставки денежно-кредитной политики ЕЦБ, а не рыночные ставки в реальном времени — они меняются только на заседаниях Совета управляющих (примерно каждые 6 недель). Поле date указывает, когда была установлена текущая ставка, а не сегодняшнюю дату. Для конвертации валют используйте get_euro_exchange; эти ставки не подходят для расчётов на форекс. Используйте get_eu_inflation вместе с этим инструментом, чтобы оценить реальную процентную ставку (номинальная ставка минус инфляция).

Получает квартальные данные по ВВП для стран ЕС/еврозоны из Eurostat (набор данных: namq_10_gdp). Возвращает JSON-объект с: data (массив объектов, каждый содержит country — полное название страны строкой, period в формате YYYY-Qq, например "2024-Q3", value — число, и unit — строковое обозначение), source и retrieved_at в формате ISO 8601. По умолчанию возвращает годовой темп роста (в процентах) для EA20, EU27_2020, DE, FR, IT, ES за последние 4 квартала. Данные кэшируются на 24 часа. Отсутствующие периоды пропускаются в массиве (не возвращаются как null). ИСПОЛЬЗОВАНИЕ: Используйте unit=CLV_PCH_SM (по умолчанию) для сравнения роста по странам. Используйте unit=CP_MEUR для сравнения абсолютного размера ВВП. Используйте unit=CLV_PCH_PRE для поквартальной динамики. Используйте unit=CLV10_MEUR для реального объема ВВП без учета ценовых эффектов. Обычно данные Eurostat публикуются с задержкой 60–90 дней после окончания квартала: самый последний квартал может отсутствовать. Запрашивайте quarters=8 или больше для анализа рецессии или построения многолетних трендов.

Получает годовые показатели инфляции HICP (Гармонизированный индекс потребительских цен) для стран ЕС из Eurostat (набор данных: prc_hicp_manr). Возвращает JSON-объект с полями: data (массив объектов, где country — полное название страны, period — в формате ГГГГ-ММ, а rate — числовое годовое процентное изменение), unit ("Годовой темп изменения (%)"), source и retrieved_at в формате ISO 8601. По умолчанию возвращает данные за последний месяц для всех 29 членов ЕС и агрегатов. Данные кэшируются на 24 часа. ИСПОЛЬЗОВАНИЕ: HICP — это гармонизированный стандарт инфляции в ЕС, который ЕЦБ использует для денежно-кредитной политики — используйте его (а не национальный ИПЦ) для межстрановых сравнений. Используйте код страны EA для агрегата еврозоны или EU27_2020 для агрегата всего ЕС-27. Обычная задержка данных — 30-45 дней после отчетного месяца. Установите periods=12, чтобы получить тренд за 12 месяцев. Используйте вместе с get_ecb_rates, чтобы понять, как ключевая ставка ЕЦБ соотносится с текущей инфляцией.

Получает курсы обмена EUR к другим валютам из ECB через Frankfurter API. Возвращает JSON-объект с полями: base ("EUR"), date (дата курса в формате YYYY-MM-DD), rates (объект, отображающий трёхбуквенные коды валют на числовые значения, показывающие, сколько единиц этой валюты равно 1 EUR), source и retrieved_at в формате ISO 8601. Последние курсы кэшируются на 1 час; исторические курсы кэшируются навсегда. ИСПОЛЬЗОВАНИЕ: Поддерживает 33 валюты, включая USD, GBP, JPY, CHF, CNY, SEK, PLN и другие. Опустите date, чтобы получить последние доступные курсы. Укажите date в формате YYYY-MM-DD для исторических курсов (доступны с 1999-01-04). Это справочные курсы ECB, публикуемые примерно в 16:00 CET. Это не реальные межбанковские курсы; ожидайте небольших спредов по сравнению с живыми котировками. Запросы на выходные или праздничные дни ECB возвращают курсы предыдущего рабочего дня. Возвращает ошибку для дат до 1999-01-04 или будущих дат.

Получает ежемесячные уровни безработицы для стран ЕС из Eurostat (набор данных: une_rt_m), с сезонной корректировкой, в процентах от активного населения. Возвращает JSON-объект с: data (массив объектов, содержащих country как полное название, period в формате YYYY-MM, rate как числовой процент, age_group и sex), unit ("Percentage of active population (%)"), source и retrieved_at в формате ISO 8601. По умолчанию используется возрастная группа TOTAL для EA20, EU27_2020, DE, FR, IT, ES, PL, NL за последние 3 месяца. Данные кэшируются на 24 часа. ИСПОЛЬЗОВАНИЕ: укажите age=Y15-24 для молодёжной безработицы, уровень которой обычно в 2-3 раза выше общего. Данные скорректированы с учётом сезонности (SA), не применяйте дополнительную сезонную корректировку. Обычная задержка Eurostat — 30-60 дней после отчётного месяца. Установите months=12 или больше для анализа трендов и циклов. Страны не входящие в ЕС (например, США, Великобритания) недоступны, используйте этот инструмент только для государств-членов ЕС и агрегатов EA20/EU27_2020.