CFEM em R: royalties da mineração por município

ocê já tentou puxar dados de royalties de mineração (CFEM) e caiu numa armadilha comum: pediu "Royalties" no Tesouro Nacional e recebeu um valor agregado que mistura CFEM com ANP, FEP, PEA, ITAIPU e CFH — sem jeito de separar o que é receita mineral do resto. Com 853 municípios só em Minas Gerais, montar isso na mão (ou tentar filtrar errado) é receita para dado furado.

O que o script faz

Este script em R usa o pacote tesouror para acessar as Transferências Constitucionais do Tesouro Nacional e isolar corretamente a CFEM dentro do bloco de "Royalties", usando o endpoint de detalhe (não o agregado). A partir daí, ele:

Monta o ranking de CFEM por município, com a divisão Top 15 vs. demais

Gera um treemap de concentração (Top 20 + "Outros")

Constrói uma série histórica multi-município (2016–2026) para comparar polos mineradores de perfis diferentes

Tudo com o layout gráfico do canal (tema rocha(), tipografia Merriweather) já aplicado, e nenhum valor hardcoded: é só trocar o estado, os municípios ou o intervalo de anos no topo do script e a análise inteira roda para qualquer UF do Brasil.

Para quem é

Para quem trabalha com finanças municipais, royalties minerários ou monitoramento de políticas públicas e quer economizar o tempo de descobrir na marra como as APIs do Tesouro tratam esse tipo de dado — pesquisadores, analistas e estudantes de economia/ciências sociais que já têm uma base de R e querem um pipeline pronto para adaptar aos seus próprios recortes.