agrobr — Dados agrícolas brasileiros em uma linha de código
Description: Infraestrutura Python para dados agrícolas brasileiros. 25 fontes públicas — CEPEA, CONAB, IBGE, NASA POWER, BCB/SICOR, ComexStat, ANDA, ABIOVE, USDA, IMEA, DERAL, INMET, Queimadas/INPE, Desmatamento, MapBiomas, CONAB Progresso, CONAB CEASA/PROHORT, B3 Futuros Agro, UN Comtrade, ANTAQ, ANP Diesel, MAPA PSR, ANTT Pedagio, SICAR — uma API, fallback automático, cache DuckDB.

Python · Open Source · PyPI

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

CEPEA, CONAB, IBGE, NASA POWER, USDA, B3 e mais 19 fontes — 25 origens, 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
credito_rural
Crédito rural por cultura, programa, seguro e modalidade
BCB/SICOR → BigQuery
exportacao
Exportações agrícolas por NCM
ComexStat → ABIOVE
fertilizante
Entregas de fertilizantes por UF
ANDA
custo_producao
Custos de produção por hectare
CONAB
pecuaria_municipal
Rebanhos e produção de origem animal por UF/município
IBGE PPM
abate_trimestral
Abate de bovinos, suínos e frangos por UF
IBGE Abate
cadastro_rural
Cadastro Ambiental Rural: imóveis rurais por UF
SICAR/GeoServer WFS
censo_agropecuario
Censo Agropecuário 1995/2006/2017: rebanho, uso da terra, lavouras, manejo de solo, irrigação
IBGE Censo Agro
censo_agropecuario_legado
Censo 1995/96 legado: tecnologia, pessoal, máquinas, produção animal, valor, financeiro
IBGE FTP
censo_agropecuario_historico
Série histórica 1920-2006: 9 temas censitários por UF
IBGE SIDRA
censo_agropecuario_municipal_1985
Censo 1985 municipal: 53 temas, 22 UFs (OCR de PDFs)
IBGE PDFs
silvicultura
Producao silvicultural: eucalipto, pinus, carvao vegetal, madeira
IBGE PEVS
extrativismo_vegetal
Producao extrativista vegetal: acai, castanha, erva-mate, palmito
IBGE PEVS
leite_industrial
Aquisicao e industrializacao trimestral de leite por UF
IBGE Leite
`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") df = await datasets.credito_rural("soja", safra="2024/25") df = await datasets.exportacao("soja", ano=2024)`

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

## Vinte e cinco 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
CC BY-NC
CONAB
Safras + Balanço + Custos + Série
Estimativas mensais, oferta e demanda, custos, série histórica 2010+
IBGE/SIDRA
PAM + LSPA + PPM + Abate + PEVS + Leite + PIB + Censo
Produção agrícola, estimativas, pecuária, abate, silvicultura, extrativismo vegetal, leite, PIB agro e censo
NASA POWER
7 parâmetros diários
Climatologia via satélite: temperatura, precipitação, radiação, umidade, vento
BCB/SICOR
Crédito rural + dimensões
Financiamentos por cultura/UF com programa, seguro, modalidade e atividade
ComexStat
Exportações
Comércio exterior agrícola por NCM, UF e período
ANDA
Fertilizantes
Entregas de fertilizantes por UF e produto
ABIOVE
Complexo soja
Exportação mensal de grão, farelo, óleo e milho
USDA PSD
Estimativas globais
Produção, oferta e demanda internacional por commodity
IMEA
Mato Grosso
Cotações diárias e indicadores de 6 cadeias produtivas
Restrito
DERAL
Lavouras PR
Condição semanal, progresso de plantio e colheita
INMET
600+ estações
Meteorologia por estação (API instável — usar NASA POWER)
Not. Agrícolas
Fallback CEPEA
Cotações agrícolas como fonte secundária de preços
Deprecated · Restrito
Queimadas/INPE
Focos de calor
6 biomas, 13 satélites, dados diários por município
Desmatamento
PRODES + DETER + Geometria
Desmatamento consolidado anual, alertas em tempo real e poligonos GeoDataFrame
MapBiomas
Cobertura da terra
Uso e cobertura anual por município (1985-presente)
CONAB Progresso
Plantio/Colheita
Progresso semanal por cultura e UF (6 culturas, 27 UFs)
CONAB CEASA
43 CEASAs · 48 produtos
Preços diários de atacado hortifruti via PROHORT
Zona cinza
B3 Futuros Agro
7 contratos
Ajustes diarios de boi, milho, cafe, etanol, soja
Zona cinza
UN Comtrade
Trade mirror
Comercio bilateral por HS code, ~200 paises
ANTAQ
Portos · 2010+
Movimentacao portuaria de granel, geral e conteiner
ANP Diesel
Precos + Volumes
Diesel por UF/municipio — proxy de atividade mecanizada
MAPA PSR
Seguro rural · 2006+
Apolices e sinistros — leading indicator de revisao CONAB
ANTT Pedagio
200+ pracas · 2010+
Fluxo de veiculos pesados — proxy de escoamento de safra
SICAR
27 UFs · 7.4M+ imoveis + geometria
Cadastro Ambiental Rural — compliance EUDR, perfil fundiario, poligonos GeoDataFrame

Começar

## pip install agrobr

MIT License (código). 4366+ testes. 25 fontes. 18 datasets. Licenças dos dados →

Documentação → Abrir no Colab ↗ GitHub ↗ PyPI ↗