agrobr¶
Dados agrícolas brasileiros em uma linha de código
O que é o agrobr?¶
Infraestrutura Python para dados agrícolas brasileiros com camada semântica sobre 38 fontes públicas.
v1.0.5 — 6000+ testes | 92% cobertura | 38/38 golden tests | retry centralizado 38/38 clients
- CEPEA/ESALQ: 20 indicadores de preços (soja, milho, boi, café, algodão, trigo, arroz, açúcar, etanol, frango, suíno, leite, laranja)
- CONAB: Safras, balanço oferta/demanda, custos de produção e série histórica
- IBGE/SIDRA: PAM (anual), LSPA (mensal), PPM, Abate, PEVS (silvicultura + extracao vegetal), Leite Trimestral, PIB Agro, Censo Agro
- NASA POWER: Climatologia gridded diária (temperatura, precipitação, radiação, umidade, vento)
- BCB/SICOR: Crédito rural por cultura e UF + séries temporais SGS (Selic, IPCA, PIB agro) + cotação PTAX + expectativas Focus
- ComexStat: Exportações agrícolas por NCM
- ANDA: Entregas de fertilizantes por UF
- ABIOVE: Exportação do complexo soja (volume e receita mensal)
- USDA PSD: Estimativas internacionais de produção/oferta/demanda
- IMEA: Cotações e indicadores para Mato Grosso (6 cadeias produtivas)
- DERAL: Condição das lavouras do Paraná (semanal)
- INMET: Dados meteorológicos por estação (requer token
AGROBR_INMET_TOKEN) - Notícias Agrícolas: Cotações agrícolas (fallback CEPEA)
- Queimadas/INPE: Focos de calor por satélite (6 biomas, 13 satélites)
- Desmatamento PRODES/DETER: Desmatamento consolidado + alertas em tempo real + geometria (GeoDataFrame)
- MapBiomas: Cobertura e uso da terra por município (1985-presente)
- CONAB Progresso: Progresso semanal de plantio/colheita por cultura e UF
- CONAB CEASA/PROHORT: Precos diarios de atacado hortifruti em 43 CEASAs (48 produtos)
- B3 Futuros Agro: Ajustes diarios (settlement) + posicoes em aberto (open interest) de futuros e opcoes agro
- UN Comtrade: Comercio bilateral + trade mirror (exportacoes vs importacoes por HS code, ~200 paises)
- ANTAQ: Movimentacao portuaria de carga (granel solido/liquido, carga geral, conteiner, 2010+)
- ANP Diesel: Precos de revenda e volumes de venda de diesel por UF/municipio (proxy atividade mecanizada)
- ANTT Pedagio: Fluxo de veiculos em pracas de pedagio rodoviario (ANTT Dados Abertos, CC-BY, 2010+)
- MAPA PSR: Apolices e sinistros do seguro rural com subvencao federal (SISSER/MAPA, 2006+)
- SICAR: Cadastro Ambiental Rural — registros de imoveis rurais por UF via WFS (7.4M+ imoveis, 27 UFs)
- ZARC: Zoneamento Agricola de Risco Climatico — janelas de plantio por municipio/cultura/solo/ciclo (MAPA/Embrapa, CC-BY)
- Agrofit/MAPA (Defensivos): Agrotoxicos registrados no Brasil — produtos formulados, autorizacoes de uso e produtos tecnicos (CC-BY)
- FUNAI: Terras indigenas via WFS (~740 TIs, CC BY-ND 3.0)
- ICMBio: Unidades de conservacao federais via WFS (344 UCs)
- INCRA: Territorios quilombolas via WFS (~426 territorios)
- IBAMA: Embargos ambientais via WFS (~89K embargos, ODbL)
- MapBiomas Alerta: Alertas de desmatamento via GraphQL (citacao obrigatoria)
- Lista Suja: Cadastro de empregadores (trabalho escravo) via PDF (Lei de Acesso a Informacao)
- ANA/SNIRH: Hidrografia, pivos de irrigacao, demanda e disponibilidade hidrica via ArcGIS REST
- SFB: Florestas publicas, concessoes florestais e IFN via ArcGIS REST
- RNC/CultivarWeb: Registro Nacional de Cultivares — ~37K registradas + ~5K protegidas (MAPA, dados publicos)
- EMBRAPA Solos: Perfis de solo PronaSolos (34K+ pontos) + mapa pedologico SiBCS (2.8K poligonos) via WFS (CC BY-NC 3.0 BR)
- Fundacao Rio Verde: Ensaios de cultivares de soja — ~97 cultivares x 4 epocas de semeio (PDF, pdfplumber)
Datasets — Camada Semântica¶
Peça o que quer, a fonte é detalhe interno:
| Dataset | Descrição | Fontes (fallback automático) |
|---|---|---|
abate_trimestral |
Abate de bovinos, suínos e frangos por UF | IBGE Abate |
balanco |
Oferta/demanda | CONAB |
cadastro_rural |
Cadastro Ambiental Rural (imóveis rurais) | SICAR/GeoServer WFS |
censo_agropecuario |
Censo Agropecuário 1995/2006/2017 (10 temas) | IBGE Censo Agro |
censo_agropecuario_historico |
Série histórica Censo Agropecuário 1920-2006 (9 temas) | IBGE SIDRA |
censo_agropecuario_legado |
Censo Agropecuário 1995/96 — 6 temas legados | IBGE FTP |
censo_agropecuario_municipal_1985 |
Censo 1985 municipal — 53 temas via OCR (22 UFs) | IBGE PDFs |
clima |
Dados climáticos mensais/diários por UF ou estação | INMET → NASA POWER |
comercio_internacional |
Comércio internacional bilateral por HS code | UN Comtrade |
condicao_lavouras |
Condição semanal das lavouras do Paraná | DERAL |
credito_rural |
Crédito rural por cultura (programa, seguro, modalidade) | BCB/SICOR → BigQuery |
custo_producao |
Custos de produção | CONAB |
desmatamento |
Desmatamento PRODES/DETER — consolidado + alertas | INPE TerraBrasilis |
estimativa_safra |
Estimativas safra corrente | CONAB → IBGE LSPA |
exportacao |
Exportações agrícolas | ComexStat → ABIOVE |
extrativismo_vegetal |
Produção extrativista vegetal (açaí, castanha, erva-mate) | IBGE PEVS |
fertilizante |
Entregas de fertilizantes | ANDA |
futuros_agricolas |
Futuros agrícolas B3 (ajustes, histórico, posições) | B3 |
importacao |
Importações agrícolas | ComexStat |
leite_industrial |
Aquisição e industrialização trimestral de leite por UF | IBGE Leite |
movimentacao_portuaria |
Movimentação portuária de carga (granel, geral, contêiner) | ANTAQ |
oferta_demanda_global |
Oferta/demanda global de commodities (USDA PSD) | USDA |
pecuaria_municipal |
Rebanhos e produção animal | IBGE PPM |
pib_agro |
PIB agropecuário por setor e trimestre | IBGE SIDRA |
preco_atacado |
Preços de atacado hortifrúti em CEASAs | CONAB CEASA/PROHORT |
preco_diario |
Preços diários spot | CEPEA → Notícias Agrícolas → cache |
producao_anual |
Produção anual consolidada | IBGE PAM → CONAB |
progresso_safra |
Progresso semanal semeadura/colheita | CONAB |
queimadas |
Focos de calor por satélite (6 biomas) | INPE |
seguro_rural |
Apólices e sinistros do seguro rural | MAPA PSR |
serie_historica_safra |
Série histórica de safras — 32 culturas desde 1976 | CONAB |
silvicultura |
Produção silvicultural (eucalipto, pinus, carvão vegetal) | IBGE PEVS |
uso_do_solo |
Cobertura e uso da terra anual por UF/município | MapBiomas |
zoneamento_agricola |
Zoneamento agrícola de risco climático (ZARC) | MAPA/Embrapa |
from agrobr import datasets
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.balanco("soja")
Instalação¶
pip install agrobr
# Com Playwright (para fontes que requerem JavaScript)
pip install agrobr[browser]
playwright install chromium
Uso Rápido¶
from agrobr import cepea, conab, ibge, nasa_power
# CEPEA - Indicadores de preços
df = await cepea.indicador('soja', inicio='2024-01-01')
# CONAB - Safras
df = await conab.safras('soja', safra='2024/25')
# IBGE - PAM
df = await ibge.pam('soja', ano=2023, nivel='uf')
# NASA POWER - Clima
df = await nasa_power.clima_uf('MT', ano=2025)
Versão Síncrona¶
from agrobr.sync import cepea, nasa_power
df = cepea.indicador('soja')
df = nasa_power.clima_uf('MT', ano=2025)
Diferenciais¶
| 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 |
| Escolher fonte | Datasets abstraem a fonte |
Quality & Reliability¶
| Métrica | Valor |
|---|---|
| Testes | 5500+ passando |
| Cobertura | 88% |
| Golden tests | 38/38 fontes |
| Resiliência HTTP | Retry centralizado + 429/Retry-After |
| Benchmarks | Memory, volume, cache, async, rate limiting |
| Bugs corrigidos (v1.0.1) | Parser NA 3 layouts, B3 ISO date, SICAR WFS field, BCB timeout |
Features¶
- 38 fontes públicas — CEPEA, CONAB, IBGE, NASA POWER, BCB/SICOR, ComexStat, ANDA, ABIOVE, USDA, IMEA, DERAL, INMET, Notícias Agrícolas, Queimadas/INPE, Desmatamento, MapBiomas, CONAB Progresso, CONAB CEASA/PROHORT, B3 Futuros Agro, UN Comtrade, ANTAQ, ANP Diesel, MAPA PSR, ANTT Pedagio, SICAR, ZARC, Agrofit/MAPA (Defensivos), FUNAI, ICMBio, INCRA, IBAMA, MapBiomas Alerta, Lista Suja, ANA/SNIRH, SFB, RNC/CultivarWeb, EMBRAPA Solos, Fundação Rio Verde
- 38/38 golden tests — validação automatizada contra dados de referência
- Resiliência HTTP —
retry_on_status()/retry_async()centralizado, Retry-After, 429 handling - Camada semântica — datasets com fallback automático entre fontes
- Contratos públicos — schema versionado com garantias de estabilidade
- Modo determinístico + snapshots — reprodutibilidade total para papers/auditorias (guia)
- Async-first com sync wrapper para uso simples
- Cache DuckDB com histórico permanente
- Suporte pandas + polars (
as_polars=True) - CLI completa (
agrobr cepea indicador soja --formato csv) - Validação — Pydantic v2 + sanity checks estatísticos + fingerprinting
- Monitoramento — health checks diários + alertas Discord/Slack
Próximos Passos¶
- Guia Rápido — Tutorial completo
- Datasets — Contratos e garantias
- API Reference — Documentação detalhada
- Fontes — Proveniência e rastreabilidade
- Exemplos — Scripts de exemplo
— Notebook interativo com todas as fontes
Licença¶
MIT License — veja LICENSE