Consulta a taxa de alfabetização (15 anos ou mais) por município com ranking. Tabela IBGE: 9543 (Censo 2022), Variável 2513.

Args:

• estado_id (string, opcional): 2 dígitos do estado (ex: "35"=SP, "31"=MG, "29"=BA, "26"=PE) Sem estado_id = consulta as 27 capitais brasileiras.

• top_n (number): quantos retornar no ranking (padrão 20, máx 100)

• ordenar: "maior" (melhor taxa) | "menor" (pior taxa)

Exemplos:

• "Mais alfabetizados em SP" → estado_id:"35", top_n:20

• "Pior escolaridade na BA" → estado_id:"29", ordenar:"menor"

• "Ranking das capitais" → sem estado_id

Busca municípios em todo o Brasil pelo nome. Args:

• nome (string): nome ou parte do nome (mínimo 3 caracteres)

• uf (opcional): sigla do estado para restringir a busca Retorna: código IBGE, nome, UF, mesorregião de todos os municípios encontrados.

Busca países cujo nome contenha o termo especificado (busca case-insensitive). Útil para encontrar código ISO de um país antes de consultar informações detalhadas.

Parâmetros: • nome: Termo de busca (busca em português, inglês e espanhol)

Retorna: Lista de países encontrados com códigos ISO e localização.

Exemplo: nome='brasil' → retorna Brasil (BR/BRA)

Busca atividades econômicas na CNAE (Classificação Nacional de Atividades Econômicas) por palavra-chave. Retorna subclasses com hierarquia completa: Seção > Divisão > Grupo > Classe > Subclasse.

Use para:

• Identificar o código CNAE de uma atividade ("qual CNAE de padaria?", "CNAE de software?")

• Verificar se uma atividade pertence a um setor ("é comércio ou serviço?")

• Encontrar atividades similares dentro de um setor

Args:

• termo: palavra-chave em português (ex: "padaria", "software", "construção civil", "restaurante")

• secao_id (opcional): letra da seção para restringir busca (ex: "C"=Indústria, "G"=Comércio, "J"=TI)

• max_resultados: máximo de resultados (padrão 10, máx 50)

Seções principais: A=Agro, B=Mineração, C=Indústria, D=Energia, E=Saneamento, F=Construção, G=Comércio, H=Transporte, I=Alojamento/Alimentação, J=Info/TI, K=Financeiro, L=Imóveis, M=Profissional/Técnico, N=Administrativo, O=Adm.Pública, P=Educação, Q=Saúde, R=Arte/Cultura, S=Outros Serviços, T=Doméstico, U=Organismos Int'l

Retorna detalhes completos de um código CNAE em qualquer nível hierárquico. Aceita código de seção, divisão, grupo, classe ou subclasse.

Args:

• codigo: código CNAE em qualquer nível: Seção: 1 letra ex: "G" Divisão: 2 dígitos ex: "47" Grupo: 4 chars ex: "47.1" Classe: 6 chars ex: "4711-3" Subclasse: 9 chars ex: "4711-3/02"

Retorna: nome, hierarquia completa e, para classes/subclasses, as atividades incluídas.

Lista as 21 seções da CNAE com contagem de divisões. Use para ter uma visão geral da estrutura ou descobrir a letra de seção para filtrar ibge_cnae_buscar.

Seções: A(Agro) B(Mineração) C(Indústria) D(Energia) E(Saneamento) F(Construção) G(Comércio) H(Transporte) I(Alimentação) J(Informação/TI) K(Financeiro) L(Imóveis) M(Profissional) N(Administrativo) O(Adm.Pública) P(Educação) Q(Saúde) R(Arte/Esporte) S(Outros Serviços) T(Doméstico) U(Organismos Internacionais)

Compara um indicador específico entre vários países, mostrando os valores mais recentes. Útil para análises comparativas e rankings internacionais.

Parâmetros: • codigos_iso: Códigos ISO-3166-1-ALPHA-2 separados por | (ex: 'BR|AR|CL|UY') • indicador_id: ID do indicador a comparar (ex: 77823 para PIB per capita)

Retorna: Ranking dos países com o valor mais recente do indicador.

Exemplo: comparar PIB per capita entre países da América do Sul: • codigos_iso: 'BR|AR|CL|UY|PY|BO|PE|EC|CO|VE' • indicador_id: '77823'

Calcula densidade demográfica (hab/km²) combinando Censo 2022 + área territorial IBGE.

Args:

• uf_id (number, opcional): ID do estado. Omita para ranking completo.

Retorna população, área em km² e densidade por estado, ordenados por densidade.

Consulta estimativas de população para anos entre censos (2001-2024+). As estimativas são usadas pelo TCU para repasse de verbas e são atualizadas anualmente.

Args:

• ano (obrigatório): Ano da estimativa (ex: 2024, 2023, 2022...)

• localidade (opcional): "BR" (Brasil), "estados" (todos estados), ou código IBGE específico

• municipio_id (opcional): Código IBGE de 7 dígitos para consulta de município específico

Use para dados mais recentes que o Censo 2022 ou para anos intermediários. Exemplo: População estimada de 2024, população de município não finalizado no censo.

Busca indicadores econômicos e sociais com série histórica.

Args:

• indicador: "IPCA" | "IPCA_ACUMULADO" | "DESEMPREGO" | "RENDIMENTO" | "INPC"

• periodos: "ultimo" ou "last" (mais recente), "ultimos6" (últimos 6), "ultimos12", "202401-202412" (intervalo)

Exemplos:

• Inflação 2024 → indicador:"IPCA", periodos:"202401-202412"

• Desemprego atual → indicador:"DESEMPREGO", periodos:"ultimo"

Retorna séries históricas de um ou mais indicadores para um país específico. Indicadores disponíveis: PIB per capita, população, IDH, expectativa de vida, alfabetização, etc.

Parâmetros: • codigo_iso: Código ISO-3166-1-ALPHA-2 do país (ex: 'BR', 'US', 'AR') • indicadores: ID(s) do(s) indicador(es) separados por | (ex: '77823' ou '77823|77831')

Retorna: Séries temporais com valores anuais de cada indicador.

Exemplos de indicadores: • 77823: PIB per capita (US$) • 77831: Índice de desenvolvimento humano (IDH) • 77849: População total • 77830: Esperança de vida ao nascer (anos) • 77836: Taxa de alfabetização (%)

Use ibge_listar_indicadores_paises para ver todos os 34 indicadores disponíveis.

Consulta o IPCA — principal indicador de inflação do Brasil. Args:

• ultimos_meses: número de meses a retornar (1-60, padrão: 12) IMPORTANTE: para tipos "acumulada_ano" ou "acumulada_12_meses", retorna apenas os N períodos mais recentes

• tipo: "variacao_mensal" (padrão), "variacao_acumulada_ano", "variacao_acumulada_12_meses" Retorna: série histórica com variação percentual por mês.

Lista todos os 27 estados do Brasil com códigos IBGE, siglas e regiões. Args:

• regiao_id (opcional): 1=Norte, 2=Nordeste, 3=Sudeste, 4=Sul, 5=Centro-Oeste Retorna: id (código IBGE), sigla, nome, região. O id é usado nas consultas do SIDRA.

Lista os indicadores econômicos disponíveis neste servidor MCP com seus IDs para uso em ibge_indicador_economico.

Retorna lista completa dos 34 indicadores disponíveis para países, organizados por categoria. Categorias: Economia, Indicadores Sociais, Meio Ambiente, População, Redes, Saúde.

Retorna: ID do indicador, nome completo, unidade de medida (%, US$, pessoas, etc.).

Uso: Para descobrir quais indicadores estão disponíveis antes de consultar dados.

Lista todos os municípios de um estado com seus códigos IBGE de 7 dígitos. Args:

• uf (string): sigla do estado (ex: "SP", "RJ", "MG", "BA")

• nome_filtro (opcional): filtra por nome (case-insensitive) Retorna: id (7 dígitos), nome, microrregião. Use o id em consultas SIDRA de municípios.

Retorna lista de todos os países do mundo com informações básicas (nome, código ISO, região). Dados incluem: nome em português/inglês/espanhol, códigos ISO-3166 e M49, região e sub-região.

Uso: Para obter lista completa de países ou filtrar por região. Retorna: Array com nome, códigos ISO-3166-1-ALPHA-2/3, região e sub-região de cada país.

Lista as 5 grandes regiões do Brasil com seus códigos e siglas. Retorna: id (1=Norte, 2=Nordeste, 3=Sudeste, 4=Sul, 5=Centro-Oeste), sigla, nome.

Retorna a URL para download da malha geográfica (shapefile/GeoJSON) de estados ou municípios.

A malha geográfica é usada para: criar mapas, calcular áreas, análise espacial, visualizações.

Args:

• tipo (string): "estado", "municipios_de_estado" ou "municipio"

• uf (string, opcional): sigla do estado (2 letras) — para tipo "estado" ou "municipios_de_estado"

• municipio_id (string, opcional): código IBGE do município (7 dígitos) — para tipo "municipio"

• formato (string): "svg" (padrão), "json" (GeoJSON), "topojson"

• resolucao (number): nível de detalhe: 1=baixo (mais rápido), 2=médio, 3=alto, 4=máximo

Retorna: URL para acesso direto à malha + instruções de uso.

Exemplos:

• "Malha de SP" → tipo="estado", uf="SP"

• "GeoJSON dos municípios do RJ" → tipo="municipios_de_estado", uf="RJ", formato="json"

• "Contorno de Manaus" → tipo="municipio", municipio_id="1302603"

Retorna a frequência de um nome próprio no Brasil por década desde 1930. Args:

• nome (obrigatório): Nome próprio a pesquisar (ex: "João", "Maria")

• localidade (opcional): Código IBGE ou "BR" para Brasil (padrão: BR)

• sexo (opcional): "M" para masculino, "F" para feminino, null para ambos

Retorna dados do Censo com frequência por período (década). Exemplo: "Quantas pessoas se chamam João no Brasil?"

Retorna os nomes mais populares do Brasil ou de uma localidade específica. Args:

• localidade (opcional): Código IBGE de estado/município ou "BR" para Brasil (padrão: BR)

• sexo (opcional): "M" para masculino, "F" para feminino, null para ambos

• decada (opcional): Década específica (ex: 1990, 2000, 2010)

Retorna ranking com nome, frequência e posição. Exemplo: "Quais os nomes mais comuns no Brasil?"

Busca notícias, releases e publicações recentes do IBGE.

Args:

• quantidade (number): número de notícias a retornar (1-20, padrão: 10)

• assunto (string, opcional): filtra por assunto/tema (ex: "censo", "pib", "desemprego")

• produto (string, opcional): filtra por produto/pesquisa IBGE (ex: "PNAD", "IPCA", "Censo")

Retorna: Lista de notícias com título, introdução, data de publicação e link.

Exemplos:

• "Últimas notícias do IBGE" → quantidade=10

• "Notícias sobre o Censo 2022" → assunto="censo"

• "Releases do IPCA" → produto="IPCA"

Retorna informações completas sobre um país específico usando código ISO-3166-1-ALPHA-2 (ex: BR, US, PT). Dados incluem: área territorial, localização geográfica, línguas oficiais, capital, moeda, histórico.

Parâmetros: • codigo_iso: Código ISO-3166-1-ALPHA-2 (2 letras maiúsculas, ex: 'BR', 'US', 'AR', 'PT')

Retorna: Nome completo, área (km²), região/sub-região, línguas, capital, moeda, histórico do país.

Retorna todos os períodos disponíveis para uma tabela SIDRA. Use ANTES de ibge_sidra_consultar_tabela quando precisar saber quais anos/meses existem. Evita erros de "período não encontrado" e HTTP 500 por período inválido. Args:

• tabela_id: código da tabela (ex: "1419" para IPCA, "9514" para Censo) Retorna: lista de períodos no formato AAAA, AAAAMM ou trimestre.

Consulta o Produto Interno Bruto (PIB) dos estados brasileiros. Dados oficiais do IBGE para análise econômica regional.

Args:

• ano (obrigatório): Ano do PIB (ex: 2021, 2020, 2019...)

• uf_id (opcional): ID do estado específico (ex: 35=SP). Omita para todos os estados.

• per_capita (opcional): true para PIB per capita, false para PIB total (padrão: false)

Retorna ranking de PIB com participação percentual no total nacional. Exemplo: "Qual o PIB de São Paulo em 2021?" ou "Ranking de PIB dos estados"

Consulta o PIB dos municípios brasileiros (tabela 5938 do SIDRA). Args:

• municipio_id (opcional): código IBGE de 7 dígitos do município

• estado_id (opcional): código IBGE de 2 dígitos do estado (retorna todos municípios do estado)

• ano (opcional): ano de referência (padrão: mais recente) Retorna: PIB em mil reais e PIB per capita.

Consulta dados de população do Censo Demográfico 2022. Args:

• nivel: "BR"=Brasil, "REGIOES"=por região, "ESTADOS"=por estado, "municipio"=município específico (requer municipio_id), "estado_municipios"=municípios de um estado (requer estado_id)

• municipio_id (opcional): código IBGE de 7 dígitos

• estado_id (opcional): código IBGE de 2 dígitos Retorna: população residente total pelo Censo 2022.

Consulta e compara a população de todos os estados ou de um estado específico.

Args:

• uf_id (number, opcional): ID do estado. Omita para todos. SP=35 | RJ=33 | MG=31 | BA=29 | RS=43 | PR=41 | PE=26 | CE=23 PA=15 | MA=21 | GO=52 | AM=13 | ES=32 | SC=42 | PB=25 | RN=24 AL=27 | PI=22 | MS=50 | MT=51 | DF=53 | SE=28 | RO=11 | TO=17

Retorna ranking de população com % do total nacional.

Consulta a população de um município pelo Censo Demográfico 2022.

Args:

• municipio_id (number): Código IBGE de 7 dígitos do município

IDs de capitais: SP=3550308 | RJ=3304557 | BH=3106200 | SSA=2927408 FOR=2304400 | REC=2611606 | MAN=1302603 | BEL=1501402 | POA=4314902 CWB=4106902 | FLN=4205407 | GYN=5208707 | NAT=2408102 | MCZ=2704302

Use ibge_listar_municipios para obter o ID de qualquer município.

Consulta dados de uma tabela específica do SIDRA com séries históricas por localidade.

FLUXO RECOMENDADO para tabelas desconhecidas:

1. ibge_sidra_metadados_tabela → descobre variáveis, classificações e períodos válidos

2. ibge_periodos_tabela → confirma quais períodos existem (evita HTTP 500)

3. ibge_sidra_consultar_tabela → consulta com parâmetros corretos

Args:

• tabela_id: código da tabela

• variaveis (opcional): ID(s) da(s) variável(is) separados por pipe "|" (ex: "93|94|95"). Sem valor = todas.

• localidade: "BR", "ESTADOS", "REGIOES", 2 dígitos=estado (ex:"35"), 7 dígitos=município

• periodo: "last"=mais recente, "-6"=últimos 6, "-12"=últimos 12, "AAAA"=ano específico Use ibge_periodos_tabela para ver períodos válidos e evitar HTTP 500.

• classificacao (opcional): cópie o valor pronto de ibge_sidra_metadados_tabela. Formato: "ID[cats]|ID[cats]" — use "ID[all]" para todas as categorias de uma classificação. NUNCA invente IDs de categoria — sempre consulte metadados primeiro.

Tabelas populares: 9514=Censo2022 pop, 9543=Censo2022 alfabetização, 5938=PIB Municipal, 1419=IPCA, 6381=PNAD Desocupação

Retorna metadados completos de uma tabela SIDRA: variáveis, classificações com IDs de categorias, níveis territoriais e períodos disponíveis. Use SEMPRE antes de ibge_sidra_consultar_tabela quando não souber os IDs de variável ou classificação. Retorna também os valores exatos para o parâmetro "classificacao" prontos para uso. Args:

• tabela_id (string): código da tabela (ex: "9514", "1419", "5938", "9543")

Pesquisa tabelas (agregados) disponíveis no SIDRA por palavra-chave ou pesquisa. Args:

• pesquisa_id (opcional): CN=Censo, CA=Censo Agro, EC=PIB Municipal, IN=Indicadores, PD=PNAD, PA=Prod.Agrícola

• nome_filtro (opcional): texto para filtrar tabelas pelo nome (ex: "população", "PIB", "IPCA") Retorna: id, nome, período e variáveis das tabelas encontradas (máx. 50).