SidneyBissoli/ibge-br-mcp

Возвращает полный документ по идентификатору, полученному из search, в виде { id, title, text, url, metadata }: text - это читаемый контент (Markdown), а url - каноническая публичная страница для цитирования. Дополняет search в контракте OpenAI Deep Research, работая по каталогу IBGE (официальная бразильская статистика: таблицы SIDRA, муниципалитеты, известные показатели). Допустимы только идентификаторы, возвращённые search; неизвестный идентификатор возвращает ошибку. Инструменты ibge_* (ibge_sidra, ibge_cidades, ibge_indicadores, ibge_comparar…) остаются инструментами для запросов данных. Поведение: только чтение и идемпотентность. Выполняет реальный GET-запрос к публичному источнику, когда документ этого требует.

Запрашивает календарь релизов и сборов IBGE. Возможности: - Список предстоящих выпусков опросов - Фильтр по продукту (IPCA, PNAD, ВВП и т.д.) - Фильтр по периоду - Различие между релизами и полевыми сборами Типы событий: - Релиз: публикация результатов опроса - Сбор: период полевого исследования Примеры: - Предстоящие релизы: (без параметров) - Релизы 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" Режим статистики: для вопросов о наибольшем/наименьшем/среднем/медиане/распределении/рейтингах по данным переписи («какой муниципалитет имел наибольшее население в 2022 году?») используйте estatisticas=true - полное распределение + верхние/нижние значения вычисляются по ВСЕМ строкам до усечения; agruparPor="<column label>" ранжирует группы по убыванию суммы. В этом режиме campos/formato игнорируются, а registros возвращается пустым. Используйте другой инструмент, когда: - Текущие данные одного муниципалитета (оценка, ИЧР, ВВП) → 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="indicadores" Этот инструмент - панель для ОДНОГО муниципалитета (Cidades@). Используйте другой инструмент, когда: - Темы переписи / исторические ряды → ibge_censo - Сравнение нескольких муниципалитетов → ibge_comparar - Временной ряд макропоказателей → ibge_indicadores Поведение: только чтение и идемпотентность - живой GET-запрос к публичным API IBGE (Cidades@/agregados). Возвращает Markdown и типизированный payload structuredContent.

Запрашивает CNAE (Национальную классификацию экономических видов деятельности) из IBGE. CNAE — официальная классификация экономических видов деятельности в Бразилии. Иерархическая структура: - Раздел (буква A-U): 21 основная категория - Подраздел (2 цифры): 87 подразделов - Группа (3 цифры): 285 групп - Класс (4-5 цифр): 673 класса - Подкласс (7 цифр): 1 332 подкласса Возможности: - Поиск по коду CNAE - Поиск по описанию деятельности - Просмотр по уровням иерархии - Отображение полной иерархии Примеры: - Поиск ПО: 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: Смертность по месту жительства Демографические показатели: - 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" Режим статистики: для вопросов о наибольшем/наименьшем значении, среднем, медиане, распределении, рейтингах («в каком штате самая высокая младенческая смертность?», «медианная ожидаемая продолжительность жизни по штатам») используйте estatisticas=true: полное распределение + верхние/нижние строки по ВСЕМ строкам до усечения; agruparPor="<название столбца>" ранжирует группы по убыванию суммы. В этом режиме campos/formato игнорируются, а registros приходит пустым. Используйте другой инструмент, когда: - Общая панель по отдельному муниципалитету (включая младенческую смертность) → 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: IPCA за 12 месяцев - inpc: Ежемесячный INPC Рынок труда: - desemprego: Уровень безработицы - ocupacao: Численность занятых - rendimento: Средний доход - informalidade: Уровень неформальной занятости Население: - populacao: Оценка численности населения - densidade: Плотность населения Примеры: - ВВП: indicador="pib" - IPCA за последние 12 месяцев: indicador="ipca", periodos="last 12" - Безработица по штатам: indicador="desemprego", nivel_territorial="3" - Список индикаторов: indicador="listar" Режим статистики: для вопросов о наибольшем/наименьшем/среднем/медиане/распределении/ранжировании ("в каком штате самая высокая безработица?", "медианный ВВП на душу населения по штатам") используйте estatisticas=true — полное распределение + верхние/нижние значения ПО ВСЕМ строкам до обрезания; agruparPor="<название столбца>" (например, "Unidade da Federação", "Trimestre") ранжирует группы по убыванию суммы. В этом режиме поля campos/formato игнорируются, а registros возвращается пустым. Используйте другой инструмент, когда: - Сравнение/ранжирование населённых пунктов → ibge_comparar - Темы переписи → ibge_censo - Панель одного муниципалитета → ibge_cidades Поведение: только чтение, идемпотентно — живой GET-запрос к публичному API IBGE SIDRA. Возвращает Markdown и типизированный структурированный контент structuredContent.

Возвращает сведения о конкретном населённом пункте по коду 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. Возможности: - Выводит список муниципалитетов по штату (с использованием аббревиатуры штата) - Выводит все муниципалитеты Бразилии (5570 муниципалитетов) - Ищет по названию муниципалитета - Возвращает 7-значный код IBGE Примеры: - Муниципалитеты Сан-Паулу: uf="SP" - Поиск по названию: busca="Campinas" - Муниципалитеты Минас-Жерайс, содержащие "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: номер страницы для пролистывания Каждый элемент возвращает: заголовок, тип (release/noticia), дату публикации, 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, ВВП и др.) - Ищет по названию или коду - Показывает подробности и таблицы выбранного обследования - Категоризирует обследования по темам Основные обследования: - Перепись: Демографическая, сельскохозяйственная, 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.

Запрашивает таблицы SIDRA (система автоматического восстановления IBGE). SIDRA содержит данные опросов IBGE, таких как перепись, PNAD, ВВП и др. Распространённые таблицы: - 6579: Оценка численности населения (ежегодно) - 9514: Перепись населения 2022 года - 200: Перепись населения (1970–2010) - 4714: Население, площадь и плотность (перепись 2022) - 4099: Уровень безработицы (PNAD Continua, ежеквартально) - 5436: Средний реальный доход (PNAD Continua, ежеквартально) - 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" Режим статистики: для вопросов о наибольшем/наименьшем/среднем/медиане/распределении/ранжировании («какой муниципалитет имеет наибольшее население?», «медианный ВВП по штатам») используйте estatisticas=true — он вычисляет минимум/максимум/среднее/медиану/стандартное отклонение/процентили по ВСЕМ строкам данных ДО пагинации и возвращает верхние/нижние ранги (по умолчанию 10, максимум 100 через topN), так что один вызов отвечает на то, что иначе потребовало бы перебора тысяч записей. С agruparPor="<метка столбца>" (например, «Единица федерации», «Год») он ранжирует группы по убыванию суммы, каждая со своим мини-распределением. Запросы, смешивающие несколько переменных, автоматически группируются по «Переменной» (единицы различаются). Маркеры отсутствия SIDRA («-», «..», «...», «X») исключаются из n. В этом режиме pagina/campos/formato игнорируются, а registros возвращается пустым. Сам запрос по-прежнему соблюдает официальный лимит SIDRA в 100 000 значений. ibge_sidra — низкоуровневый движок. Предпочитайте более дружелюбную обёртку, когда она подходит: - Перепись (1970–2022) → ibge_censo - Экономические/социальные временные ряды → ibge_indicadores - Сравнение 2–10 муниципалитетов → ibge_comparar - Панель одного муниципалитета → ibge_cidades Используйте ibge_sidra_tabelas и ibge_sidra_metadados, чтобы найти код таблицы…

Возвращает метаданные для конкретной таблицы 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 Примеры: - Список таблиц: (без параметров) - Поиск таблиц по населению: busca="população" - Таблицы Census: 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.

Ищет в каталоге IBGE (официальная бразильская статистика: таблицы SIDRA, муниципалитеты, известные показатели) и возвращает до 10 подходящих документов в виде { id, title, url }, отсортированных по релевантности (пустой список означает, что ничего не найдено). Этот инструмент существует для контракта OpenAI Deep Research: глубокие исследования ChatGPT, корпоративные знания и исследовательские процессы через Responses API требуют именно инструментов search и fetch. Передайте один из возвращённых идентификаторов в fetch, чтобы прочитать документ. Для прямых вопросов и для данных (значения, ряды, рейтинги) предпочитайте инструменты ibge_* (ibge_sidra, ibge_cidades, ibge_indicadores, ibge_comparar…), которые возвращают фактические данные с указанием источника: это индекс каталога, а не запрос данных. Запрос: естественный язык или ключевые слова, португальский или английский; акценты и регистр игнорируются. Поведение: только чтение и идемпотентность. Каталог берётся из публичного источника и кэшируется в памяти.