Analista macroeconômico¶

Você acompanha PIB, IPCA, desemprego, juros e câmbio. Tira gráficos para reuniões semanais, escreve notas, alimenta modelos de projeção. Seu inimigo silencioso é dado obsoleto, série revisada sem aviso, e quinze fontes diferentes em quinze formatos.

Suas três dores¶

Dor	A ferramenta
Coletar IPCA, PIB, PNAD, IBC-Br sem virar especialista em URL do SIDRA	`sidra-fetcher`
Yield curve, retorno de carteira de renda fixa, prêmio de risco fiscal	`tesouro-direto-fetcher` + `rtn-fetcher`
Reproduzir o número exato de um relatório anterior depois que a fonte revisou	Proveniência & Manifestos

Por onde começar¶

5 minutos: baixe IPCA pelo Quickstart aba IBGE. Confirme que a API responde e que sua máquina está pronta.
15 minutos: rode a receita Curva de Phillips brasileira — IPCA × PNAD-C mensal, gráfico pronto.
30 minutos: monte o painel multi-fonte da receita Análise Econômica Multi-Fonte — IBGE + Tesouro + emprego em um único fluxo.

O conceito que importa para você¶

Reprodutibilidade — o IBGE revisa séries históricas com frequência. Sem proveniência, o número do relatório de janeiro não bate com o número da auditoria de junho. Saiba como o manifesto SHA-256 resolve isso na página Proveniência.

Padrões que economizam tempo¶

Cacheie metadados com save_agregado/load_agregado — eles mudam pouco. Salve uma vez, recarregue do disco nas próximas execuções.
Filtre períodos no servidor — não baixe a série inteira se você só precisa dos últimos 5 anos. Use Parametro(periodos=["202301", ...]).
Use AsyncSidraClient para múltiplos agregados — buscar PIB, IPCA, IBC-Br concorrentemente é 3x mais rápido que sequencial.

Caminho de aprofundamento¶

sidra-pipelines — catálogo de 30+ pipelines IBGE prontos para carregar em PostgreSQL.
sidra-sql — quando seu fluxo virou pipeline e você quer warehouse com SCD II.
Cookbook completo — receitas que você pode parafrasear.