agrobr — Dados agrícolas brasileiros em uma linha de código
Description: Infraestrutura Python para dados agrícolas brasileiros. CEPEA, CONAB, IBGE — uma API, fallback automático, cache DuckDB.

Python · Open Source · PyPI

# Dados agrícolas brasileiros em uma linha de código

CEPEA, CONAB, IBGE — uma API unificada com fallback automático, cache inteligente e contratos versionados.

$ pip install agrobr ⎘

Camada Semântica

## Peça o que quer.
A fonte é detalhe interno.

Datasets abstraem múltiplas fontes com fallback automático. Quando CEPEA retorna 403, o agrobr busca Notícias Agrícolas. Quando o servidor cai, serve do cache.

preco_diario
Preços spot de 20 commodities agrícolas
CEPEA → NA → cache
producao_anual
Produção consolidada por UF e município
IBGE PAM → CONAB
estimativa_safra
Estimativas da safra corrente
CONAB → IBGE LSPA
balanco
Oferta e demanda por cultura
CONAB
`from agrobr import datasets # Uma linha. Fallback automático. Cache DuckDB. df = await datasets.preco_diario("soja") df = await datasets.producao_anual("soja", ano=2023) df = await datasets.estimativa_safra("soja", safra="2024/25")`

Infraestrutura

## Construído para produção,
não para demo.

⟳

### Fallback em Cascata

Fonte primária falha → tenta secundária → serve do cache. Transparente.

⛁

### Cache DuckDB

Histórico permanente local. Sem re-download. Séries temporais acumuladas.

◈

### Contratos Versionados

Schema garantido por dataset. Breaking changes só em major. Semver.

⚡

### Async-first

httpx nativo com sync wrapper. Funciona em Jupyter, FastAPI e Airflow.

✓

### Validação Pydantic v2

Modelos tipados. Sanity checks estatísticos. Fingerprinting de layout.

◎

### Modo Determinístico

Reprodutibilidade total via contextvars. Para papers e auditorias.

Fontes de dados

## Três origens. Uma API.

Cada fonte tem seu próprio parser com versionamento, fingerprinting e tratamento de encoding. Você só vê o DataFrame.

CEPEA/ESALQ
20 indicadores
Soja, milho, boi, café, algodão, trigo, arroz, açúcar, etanol, frango, suíno, leite, laranja
CONAB
Safras + Balanço O&D
Estimativas mensais, oferta e demanda, séries históricas por cultura
IBGE/SIDRA
PAM + LSPA
Produção anual municipal e estimativas mensais por UF

Começar

## pip install agrobr

MIT License. 328 testes. Documentação completa.

Documentação → GitHub ↗ PyPI ↗