SidneyBissoli/ibge-br-mcp

Запрашивает календарь публикаций и сборов данных IBGE. Возможности: - Выводит список предстоящих опросов - Фильтрует по продукту (IPCA, PNAD, GDP и т.д.) - Фильтрует по периоду - Различает публикации и полевые сборы Типы событий: - **Публикация (Release)**: выход результатов опроса - **Сбор (Collection)**: период полевого исследования Примеры: - Предстоящие публикации: (без параметров) - Публикации IPCA: produto="IPCA" - Календарь на 2024 год: de="01/01/2024", ate="31/12/2024" - Полевые сборы: tipo="coleta" Используйте другой инструмент, если: - Требуются уже опубликованные новости и пресс-релизы → ibge_noticias Поведение: только чтение и идемпотентность — прямой GET-запрос к публичному API Calendário IBGE. Возвращает список в формате Markdown.

Запрашивает данные демографической переписи IBGE (1970-2022). Упрощённый инструмент для доступа к данным переписи без знания кодов таблиц SIDRA. Доступные годы: 1970, 1980, 1991, 2000, 2010, 2022 Доступные темы: - populacao: постоянное население - alfabetizacao: уровень грамотности - domicilios: характеристики жилья - idade_sexo: возрастная пирамида - religiao: распределение по религии - cor_raca: раса/цвет кожи - rendimento: ежемесячный доход - educacao: уровень образования - trabalho: занятость Примеры: - Население 2022: ano="2022", tema="populacao" - Исторический ряд: ano="todos", tema="populacao" - Уровень грамотности 2010 по штатам: ano="2010", tema="alfabetizacao", nivel_territorial="3" - Список таблиц: tema="listar" Используйте другой инструмент, когда: - Текущее население Бразилии в реальном времени → ibge_populacao - Текущая панель одного муниципалитета (оценка, ИРЧП, ВВП) → ibge_cidades - Сравнение/ранжирование населённых пунктов → ibge_comparar - Произвольная таблица SIDRA → ibge_sidra Поведение: только чтение и идемпотентность - живой GET-запрос к публичному API IBGE SIDRA. Возвращает Markdown и типизированную полезную нагрузку structuredContent.

Запрашивает муниципальные показатели из IBGE (аналогично порталу Cidades@). Возможности: - Общий обзор муниципалитета (население, ИЧР, ВВП и т.д.) - Запрос конкретных показателей - Исторические данные показателей за годы - Список доступных обследований и показателей Доступные показатели: populacao, area, densidade, pib_per_capita, idh, escolarizacao, mortalidade, salario_medio, receitas, despesas Примеры: - Обзор Сан-Паулу: tipo="panorama", municipio="3550308" - История населения: tipo="historico", municipio="3550308", indicador="populacao" - Просмотр обследований: tipo="pesquisas" - Доступные показатели: tipo="indicador" Этот инструмент - панель для ОДНОГО муниципалитета (Cidades@). Используйте другой инструмент в следующих случаях: - Население Бразилии в реальном времени → ibge_populacao - Темы переписи / исторические ряды → ibge_censo - Сравнение нескольких муниципалитетов → ibge_comparar - Временной ряд макропоказателей → ibge_indicadores Поведение: только чтение и идемпотентно — живой GET к публичным API IBGE (Cidades@/agregados). Возвращает Markdown и типизированный structuredContent payload.

Запрашивает CNAE (Национальную классификацию экономических видов деятельности) от IBGE. CNAE: официальная классификация экономических видов деятельности в Бразилии. Иерархическая структура: - Секция (буква A-U): 21 основная категория - Раздел (2 цифры): 87 разделов - Группа (3 цифры): 285 групп - Класс (4-5 цифр): 673 класса - Подкласс (7 цифр): 1 332 подкласса Возможности: - Поиск по коду CNAE - Поиск по описанию деятельности - Вывод списка по иерархическому уровню - Отображение полной иерархии Примеры: - Поиск по слову software: busca="software" - Конкретный код: codigo="6201-5/01" - Просмотр секции: codigo="J" - Вывод разделов: nivel="divisoes" Поведение: только для чтения и идемпотентно. Отправляет живой GET-запрос к публичному API CNAE от IBGE. Возвращает Markdown.

Сравнивает данные между населёнными пунктами (муниципалитетами или штатами). Доступные показатели: - populacao: Текущая оценка численности населения - populacao_censo: Численность населения по переписи 2022 года - pib: ВВП на душу населения - area: Площадь территории (км²) - densidade: Плотность населения (чел/км²) - alfabetizacao: Уровень грамотности - domicilios: Количество домохозяйств Возможности: - Сравнение до 10 населённых пунктов за один раз - Расчёт статистики (максимум, минимум, среднее, разброс) - Вывод в виде рейтинга - Принимает коды муниципалитетов (7 цифр) или коды штатов (2 цифры) Примеры: - Сравнение столиц: localidades="3550308,3304557,4106902", indicador="populacao" - Сравнение штатов: localidades="35,33,41", indicador="pib" - Рейтинг по площади: localidades="3550308,3304557", formato="ranking" - Список показателей: indicador="listar" Используйте этот инструмент ТОЛЬКО для ранжирования/сравнения 2–10 населённых пунктов по одному показателю. Для одного населённого пункта используйте ibge_cidades (панель муниципалитета), ibge_censo или ibge_sidra. Поведение: только чтение и идемпотентность — прямой GET-запрос к публичным API IBGE (SIDRA и Localidades). Возвращает Markdown и типизированную структуру structuredContent.

Запрашивает показатели здоровья Бразилии, предоставляемые через SIDRA от IBGE (некоторые исходно подготовлены DataSUS, например смертность и рождаемость). Смертность и рождаемость: - mortalidade_infantil: Коэффициент младенческой смертности - nascidos_vivos: Живорождения по месту - obitos: Смерти по месту жительства - obitos_causas: Смерти по причинам (МКБ-10) Демографические показатели: - esperanca_vida: Ожидаемая продолжительность жизни при рождении - fecundidade: Коэффициент фертильности Санитария: - saneamento_agua: Водоснабжение - saneamento_esgoto: Канализация Охват здравоохранением: - plano_saude: Охват медицинским страхованием - autoavaliacao_saude: Самооценка состояния здоровья Уровни территории: 1=Бразилия, 2=Регион, 3=Штат, 6=Муниципалитет Примеры: - Младенческая смертность: indicador="mortalidade_infantil" - Ожидаемая продолжительность жизни по штатам: indicador="esperanca_vida", nivel_territorial="3" - Смерти в SP: indicador="obitos", nivel_territorial="3", localidade="35" - Список показателей: indicador="listar" Используйте другой инструмент, когда: - Общая панель одного муниципалитета (включает также младенческую смертность) → ibge_cidades - Данные о численности и демографии (не связанные со здоровьем) → ibge_censo или ibge_sidra Поведение: только чтение и идемпотентность — живой GET-запрос к публичному API IBGE SIDRA. Возвращает Markdown и типизированный structuredContent.

Выводит список всех штатов Бразилии из IBGE. Возможности: - Выводит все 27 штатов (26 штатов + Федеральный округ) - Фильтр по региону (Север, Северо-Восток, Юго-Восток, Юг, Центро-Запад) - Сортировка по ID, названию или аббревиатуре Примеры: - Список всех штатов: (без параметров) - Штаты Северо-Востока: regiao="NE" - Сортировка по аббревиатуре: ordenar="sigla" Используйте другой инструмент, когда: - Муниципалитеты штата → ibge_municipios - Детали/иерархия одной локации по коду → ibge_localidade Поведение: только чтение и идемпотентно — живой GET-запрос к публичному API IBGE Localidades. Возвращает таблицу в Markdown.

Декодирует коды IBGE или ищет коды по названию местности. Возможности: - Декодировать коды региона, штата, муниципалитета или округа - Искать код IBGE по названию - Показывать полную географическую иерархию - Возвращать связанные коды Структура кода: - 1 цифра: Регион (1=Северный, 2=Северо-восточный, 3=Юго-восточный, 4=Южный, 5=Центрально-западный) - 2 цифры: Штат (11-53) - 7 цифр: Муниципалитет - 9 цифр: Округ Примеры: - Декодировать муниципалитет: codigo="3550308" - Декодировать штат: codigo="35" - Поиск по названию: nome="São Paulo" - Муниципалитет в штате: nome="Campinas", uf="SP" Этот инструмент декодирует структуру кода и разрешает название→код на любом уровне. Используйте другой инструмент, когда: - Нужно только вывести список или найти муниципалитеты → ibge_municipios - Нужна полная подробная запись одной местности → ibge_localidade Поведение: только чтение и идемпотентность — прямой GET-запрос к публичному API IBGE Localidades. Возвращает Markdown.

Запрашивает экономические и социальные индикаторы IBGE. Доступные индикаторы: **Экономические:** - pib: ВВП в текущих ценах - pib_variacao: Изменение ВВП (%) - pib_per_capita: ВВП на душу населения - industria: Промышленное производство - comercio: Розничная торговля - servicos: Объём услуг **Цены:** - ipca: Ежемесячный IPCA - ipca_acumulado: Накопленный за 12 месяцев IPCA - inpc: Ежемесячный INPC **Труд:** - desemprego: Уровень безработицы - ocupacao: Занятое население - rendimento: Средний доход - informalidade: Уровень неформальной занятости **Население:** - populacao: Оценка численности населения - densidade: Плотность населения Примеры: - ВВП: indicador="pib" - IPCA за последние 12 месяцев: indicador="ipca", periodos="last 12" - Безработица по штатам: indicador="desemprego", nivel_territorial="3" - Список индикаторов: indicador="listar" Используйте другой инструмент в случаях: - Сравнение/ранжирование населённых пунктов → ibge_comparar - Темы переписи → ibge_censo - Панель одного муниципалитета → ibge_cidades Поведение: только для чтения и идемпотентный — живой GET-запрос к публичному API IBGE SIDRA. Возвращает Markdown и типизированный structuredContent payload.

Возвращает сведения о конкретном населённом пункте по коду IBGE. Возможности: - Информация о штате (2-значный код) - Информация о муниципалитете (7-значный код) - Информация о районе (9-значный код) - Полная иерархия (регион, мезорегион, микрорегион) Примеры: - Штат Сан-Паулу: codigo=35 - Город Сан-Паулу: codigo=3550308 - Район: codigo=355030805 Этот инструмент возвращает полную запись ОДНОГО населённого пункта, для которого у вас уже есть код. Используйте другой инструмент, когда: - У вас есть название и нужен код → ibge_municipios (муниципалитеты) или ibge_geocodigo (любой уровень) - Вы хотите разобрать/понять структуру кода → ibge_geocodigo Поведение: только чтение и идемпотентность — это живой GET-запрос к публичному API IBGE Localidades. Возвращает запись в формате Markdown.

Получает географические сетки (карты) от IBGE в форматах GeoJSON, TopoJSON или SVG. Возможности: - Сетки для Бразилии, регионов, штатов, муниципалитетов - Разные уровни разрешения (внутренние деления) - Разные уровни качества - Форматы: GeoJSON (данные), TopoJSON (компактный), SVG (изображение) Типы местностей: - "BR" или "1" = вся Бразилия - Аббревиатура штата (например, "SP", "RJ") - Код штата (например, "35" для SP) - Код муниципалитета (7 цифр) Разрешение (внутренние деления): - 0 = только контур - 2 = штаты - 5 = муниципалитеты Примеры: - Бразилия с делением на штаты: localidade="BR", resolucao="2" - Сан-Паулу с делением на муниципалитеты: localidade="SP", resolucao="5" - Формат SVG: localidade="BR", formato="svg" Используйте другой инструмент, когда нужны: - Тематические сетки (биомы, Легальная Амазония, полузасушливые районы, столичные регионы) → ibge_malhas_tema Поведение: доступно только для чтения и идемпотентно — выполняет GET-запрос к публичному API IBGE Malhas. Возвращает сетку в запрошенном формате (GeoJSON, TopoJSON или SVG).

Получает тематические географические меши из IBGE. Доступные темы: - biomas: бразильские биомы (Амазония, Серрадо, Атлантический лес, Каатинга, Пампа, Пантанал) - amazonia_legal: территория Легальной Амазонии - semiarido: полузасушливый регион - costeiro: прибрежная зона - fronteira: пограничная полоса - metropolitana: метрополитенские регионы - ride: интегрированные регионы развития Коды биомов: - 1: Амазония - 2: Серрадо - 3: Атлантический лес - 4: Каатинга - 5: Пампа - 6: Пантанал Примеры: - Все биомы: tema="biomas" - Биом Амазония: tema="biomas", codigo="1" - Легальная Амазония: tema="amazonia_legal" - Метрополитенские регионы: tema="metropolitana" - С муниципалитетами: tema="biomas", resolucao="5" - Список тем: tema="listar" Используйте другой инструмент, когда: - Административные меши (очертания Бразилии/региона/штата/муниципалитета) → ibge_malhas Поведение: только для чтения и идемпотентен — живой GET-запрос к публичному IBGE Malhas API. Возвращает меш в запрошенном формате (GeoJSON, TopoJSON или SVG).

Выдаёт список бразильских муниципалитетов из IBGE. Возможности: - Список муниципалитетов по штату (с использованием аббревиатуры штата) - Список всех муниципалитетов Бразилии (5 570 муниципалитетов) - Поиск по названию муниципалитета - Возвращает 7-значный код IBGE Примеры: - Муниципалитеты Сан-Паулу: uf="SP" - Поиск по названию: busca="Campinas" - Муниципалитеты MG, содержащие «Belo»: uf="MG", busca="Belo" Используйте другой инструмент, когда: - Нужно раскодировать код любого уровня (регион, штат, округ), а не только муниципалитеты → ibge_geocodigo - Полные сведения/иерархия одной местности по коду → ibge_localidade - Соседние муниципалитеты → ibge_vizinhos Поведение: только чтение и идемпотентность — живой GET-запрос к публичному API IBGE Localidades. Возвращает таблицу в Markdown.

Запрашивает частоту имён и рейтинги в Бразилии (IBGE). Возможности: 1. **Частота имени** (tipo='frequencia'): - Частота рождений по десятилетиям - Несколько имён через запятую - Фильтр по полу и местности 2. **Рейтинг имени** (tipo='ranking'): - Самые популярные имена - Фильтр по десятилетию, полу и местности Доступные десятилетия: 1930-2010 Примеры: - Частота "Maria": tipo="frequencia", nomes="Maria" - Сравнение имён: tipo="frequencia", nomes="João,José,Pedro" - Рейтинг 2000-х: tipo="ranking", decada=2000 - Женские имена: tipo="ranking", sexo="F" Поведение: только чтение и идемпотентно - живой GET-запрос к публичному API IBGE Nomes (Censo). Возвращает таблицу в Markdown.

Ищет и перечисляет уже опубликованные новостные статьи и пресс-релизы IBGE. Используйте этот инструмент для поиска последних публикаций или анонсов IBGE по опросу или теме — когда вышел показатель, или новости, где упоминается термин вроде «censo». Результаты сортируются от новых к старым; без параметров возвращаются 10 последних элементов. Параметры: - busca: текст для поиска по свободному вводу (например, «PIB», «censo») - tipo: «release» (официальная публикация результатов опроса) или «noticia» (обычная новость); опустите, чтобы вернуть и то, и другое - de / ate: диапазон дат, формат ДД/ММ/ГГГГ (например, de=«01/01/2024», ate=«31/12/2024») - destaque: true, чтобы вернуть только избранные записи - quantidade: сколько вернуть (по умолчанию 10, максимум 100); pagina: номер страницы для пролистывания Каждый элемент возвращает: заголовок, тип (релиз / новость), дату публикации, редакцию (editoria), связанные продукты/опросы, флаг избранного, краткое описание в виде обычного текста и ссылку на полную статью. В заголовке ответа указывается общее количество и текущая страница. Примеры: - Последние 10 новостей: (без параметров) - Поиск по переписи: busca=«censo» - Новости за 2024 год: de=«01/01/2024», ate=«31/12/2024» - Только релизы: tipo=«release» Используйте другой инструмент, когда: - Планируемые даты выхода (ещё не опубликованы) → ibge_calendario Поведение: только чтение и идемпотентность — живой GET-запрос к публичному API IBGE Notícias. Возвращает список в Markdown.

Запрашивает международные данные о странах через IBGE. Возможности: - Получает список всех стран (по методологии UN M49) - Детали страны (площадь, языки, валюта, местоположение) - Ищет страны по названию - Фильтрует по региону/континенту Доступные регионы: americas, europa, africa, asia, oceania Коды стран: используйте ISO-ALPHA-2 (например, BR, US, AR, PT, JP) Примеры: - Получить все: tipo="listar" - Детали Бразилии: tipo="detalhes", pais="BR" - Поиск: tipo="buscar", busca="Argentina" - Страны Америки: tipo="listar", regiao="americas" - Доступные индикаторы: tipo="indicadores" Поведение: только для чтения и идемпотентно — выполняет прямой GET-запрос к публичному API IBGE Países. Возвращает Markdown.

Перечисляет доступные опросы IBGE и их таблицы. Возможности: - Вывод всех опросов IBGE (перепись, PNAD, GDP и т.д.) - Поиск по названию или коду - Показ подробностей и таблиц конкретного опроса - Группировка опросов по темам Основные опросы: - **Перепись**: демографическая, сельскохозяйственная, MUNIC - **PNAD Contínua**: занятость, доходы, образование - **Национальные счета**: ВВП, инвестиции - **Экономические опросы**: промышленность, торговля, услуги - **Индексы цен**: IPCA, INPC Примеры: - Вывести все: (без параметров) - Поиск население: busca="população" - Детали PNAD: detalhes="pnad" Этот инструмент перечисляет опросы, а не данные. Чтобы найти коды таблиц, используйте ibge_sidra_tabelas; для запросов данных используйте ibge_sidra (или обёртки: ibge_censo, ibge_indicadores, ibge_comparar, ibge_cidades). Поведение: только чтение и идемпотентность — живой GET-запрос к публичному API IBGE SIDRA/Pesquisas. Возвращает список в Markdown.

Возвращает прогноз населения Бразилии в реальном времени. Возможности: - Текущая оценка численности населения - Рождаемость (среднее время между рождениями) - Смертность (среднее время между смертями) - Ежедневный прирост населения Источник: IBGE — Прогноз населения Бразилии Этот инструмент возвращает ТОЛЬКО общенациональный прогноз Бразилии в реальном времени. Используйте другой инструмент, если нужно: - Население конкретного муниципалитета/штата → ibge_cidades (панорама) - Перепись или исторические данные → ibge_censo - Сравнение/ранжирование нескольких населённых пунктов → ibge_comparar - Временные ряды населения → ibge_indicadores - Произвольная таблица SIDRA → ibge_sidra Поведение: только чтение и идемпотентность — прямой GET-запрос к публичному API прогноза населения IBGE. Возвращает Markdown и типизированный structuredContent с полезными данными.

Запрашивает таблицы SIDRA (Автоматическая система восстановления IBGE). SIDRA содержит данные опросов IBGE — перепись, PNAD, ВВП и другие. Часто используемые таблицы: - 6579: Оценки численности населения (ежегодные) - 9514: Перепись 2022 — население - 200: Перепись населения (1970–2010) - 4714: Уровень безработицы (PNAD Contínua) - 6381: Средний доход (PNAD Contínua) - 6706: ВВП в текущих ценах - 5938: ВВП на душу населения Территориальные уровни: - 1: Бразилия - 2: Регион (Север, Северо-Восток и т.д.) - 3: Штат (UF) - 6: Муниципалитет - 7: Столичная область Примеры: - Население Бразилии 2023: tabela="6579", periodos="2023" - Население по штатам: tabela="6579", nivel_territorial="3" - Перепись 2022 по муниципалитетам: tabela="9514", nivel_territorial="6", localidades="3550308" ibge_sidra — низкоуровневый движок. Если подходит, используйте более удобную обёртку: - Темы переписи (1970–2022) → ibge_censo - Экономические/социальные временные ряды → ibge_indicadores - Рейтинг/сравнение 2–10 населённых пунктов → ibge_comparar - Панель одного муниципалитета → ibge_cidades Перед запросом используйте ibge_sidra_tabelas и ibge_sidra_metadados, чтобы найти код таблицы и её структуру. Поведение: только чтение, идемпотентно — живой GET-запрос к публичному API SIDRA IBGE. Возвращает Markdown и типизированный structuredContent.

Возвращает метаданные для конкретной таблицы SIDRA. Возможности: - Общая информация (название, обследование, тема, периодичность) - Доступные территориальные уровни - Список переменных с единицами измерения - Классификации и категории - Доступные периоды Используйте этот инструмент, чтобы понять структуру таблицы ДО того, как запрашивать данные с помощью ibge_sidra. Примеры: - Метаданные таблицы населения: tabela="6579" - Метаданные переписи 2022: tabela="9514" - Безработица PNAD: tabela="4714" Используйте после того, как нашли код таблицы (ibge_sidra_tabelas), и перед запросом с ibge_sidra. Поведение: только чтение и идемпотентность — живой GET-запрос к публичному API IBGE SIDRA. Возвращает Markdown.

Перечисляет и ищет доступные таблицы SIDRA. Возможности: - Перечисляет все таблицы SIDRA (агрегаты) - Ищет по имени таблицы - Фильтрует по обследованию (Census, PNAD, GDP и т.д.) - Показывает код и название каждой таблицы SIDRA содержит данные из различных обследований: - Demographic Census - PNAD Contínua (занятость, доход) - National Accounts (GDP) - Industrial Survey - Agricultural Survey Примеры: - List tables: (без параметров) - Search population tables: busca="população" - Census tables: pesquisa="censo" Это шаг 1 рабочего процесса SIDRA: найти код таблицы → ibge_sidra_metadados (структура) → ibge_sidra (запрос). Для обычных данных обычно проще использовать обёртку: ibge_censo, ibge_indicadores, ibge_comparar, ibge_cidades. Поведение: только чтение и идемпотентно - живой GET-запрос к публичному API IBGE SIDRA. Возвращает таблицу Markdown.

Находит соседние/близлежащие муниципалитеты. Возможности: - Поиск по коду IBGE (7 цифр) или названию муниципалитета - Возвращает муниципалитеты в том же мезорегионе (приближение близости) - Опционально включает данные о населении Примечание: использует мезорегион как прокси географической близости. Для точного пространственного соседства потребовалась бы обработка сетки. Примеры: - По коду: municipio="3550308" - По названию: municipio="Campinas", uf="SP" - С населением: municipio="3550308", incluir_dados=true Примечание: близость аппроксимируется общим мезорегионом (не точная пространственная смежность). Для перечисления/поиска муниципалитетов используйте ibge_municipios. Поведение: только для чтения и идемпотентно - живой GET-запрос к публичному API IBGE Localidades. Возвращает список в Markdown.