agrobr

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

O que é o agrobr?

O agrobr é um pacote Python que fornece acesso simplificado aos principais dados agrícolas brasileiros:

• CEPEA/ESALQ: Indicadores de preços (soja, milho, boi, café, etc.)
• CONAB: Dados de safras e balanço oferta/demanda
• IBGE/SIDRA: PAM (Produção Agrícola Municipal) e LSPA (Levantamento Sistemático)

Por que usar o agrobr?

Problema	Solução agrobr
Download manual de planilhas	Uma linha de código
Layouts inconsistentes	Parsing robusto com fallback
Scripts que quebram	Fingerprinting detecta mudanças
Sem histórico	Cache DuckDB com acumulação
Encoding caótico	Fallback chain automático

Instalação

pip install agrobr

# Com suporte a Polars (opcional)
pip install agrobr[polars]

# Instalar Playwright para scraping avançado
playwright install chromium

Uso Rápido

from agrobr import cepea, conab, ibge

# CEPEA - Indicadores de preços
df = await cepea.indicador('soja')
print(df.head())

# CONAB - Safras
df = await conab.safras('soja', safra='2024/25')

# IBGE - PAM
df = await ibge.pam('soja', ano=2023, nivel='uf')

Versão Síncrona

from agrobr.sync import cepea

# Mesma API, sem async/await
df = cepea.indicador('soja')

Features

• Async-first: Performance para pipelines de dados
• Sync wrapper: Uso simples quando async não é necessário
• Cache inteligente: DuckDB com histórico permanente
• Suporte Pandas + Polars: as_polars=True em todas as APIs
• CLI completa: agrobr cepea soja --formato csv
• Resiliência: Retry, rate limiting, fallback automático
• Validação: Pydantic v2 + sanity checks estatísticos
• Monitoramento: Health checks e alertas

Próximos Passos

• Guia Rápido - Tutorial completo
• API Reference - Documentação detalhada
• Exemplos - Scripts de exemplo

Licença

MIT License - veja LICENSE