CONAB - Companhia Nacional de Abastecimento¶

Visao Geral¶

Campo	Valor
Instituicao	Ministerio da Agricultura
Website	conab.gov.br
Acesso agrobr	Direto (XLSX publicos)

Origem dos Dados¶

Fonte¶

URL: https://www.conab.gov.br/info-agro/safras/graos
Formato: XLSX (planilhas Excel)
Acesso: Publico, sem restricoes

Levantamentos¶

A CONAB publica levantamentos mensais de safra:

Mes	Levantamento
Outubro	1o Levantamento
Novembro	2o Levantamento
Dezembro	3o Levantamento
Janeiro	4o Levantamento
Fevereiro	5o Levantamento
Marco	6o Levantamento
Abril	7o Levantamento
Maio	8o Levantamento
Junho	9o Levantamento
Julho	10o Levantamento
Agosto	11o Levantamento
Setembro	12o Levantamento

Dados Disponiveis¶

Safras¶

Area plantada (mil hectares)
Area colhida (mil hectares)
Produtividade (kg/ha)
Producao (mil toneladas)

Balanco de Oferta e Demanda¶

Estoque inicial
Producao
Importacao
Consumo
Exportacao
Estoque final

Uso¶

Safras por Produto¶

import asyncio
from agrobr import conab

async def main():
    # Dados de safra da soja
    df = await conab.safras('soja')

    # Safra especifica
    df = await conab.safras('milho', safra='2025/26')

    # Filtrar por UF
    df = await conab.safras('soja', uf='MT')

    # Com metadados
    df, meta = await conab.safras('soja', return_meta=True)

asyncio.run(main())

Balanco de Oferta/Demanda¶

# Balanco de todos os produtos
df = await conab.balanco()

# Balanco de produto especifico
df = await conab.balanco(produto='soja')

Totais Brasil¶

# Totais nacionais por produto
df = await conab.brasil_total()

Schema - Safras¶

Coluna	Tipo	Descricao
`fonte`	str	"conab"
`produto`	str	Nome do produto
`safra`	str	Safra (ex: "2024/25")
`uf`	str	Sigla da UF
`area_plantada`	Decimal	Mil hectares
`area_colhida`	Decimal	Mil hectares
`produtividade`	Decimal	kg/ha
`producao`	Decimal	Mil toneladas
`levantamento`	int	Numero do levantamento (1-12)
`data_publicacao`	date	Data de publicacao

Produtos Disponiveis¶

produtos = await conab.produtos()
# ['soja', 'milho', 'arroz', 'feijao', 'algodao', 'trigo', ...]

UFs Disponiveis¶

ufs = await conab.ufs()
# ['AC', 'AL', 'AM', 'AP', 'BA', 'CE', 'DF', 'ES', 'GO', ...]

Levantamentos Disponiveis¶

levs = await conab.levantamentos()
for lev in levs[:5]:
    print(f"{lev['safra']} - {lev['levantamento']}o levantamento")

Custo de Producao¶

Planilhas de custo de producao por hectare, disponibilizadas em gov.br/conab.

# Custo detalhado de soja em MT
df = await conab.custo_producao("soja", uf="MT")

# Totais (COE, COT, CT)
totais = await conab.custo_producao_total("soja", uf="MT", safra="2024/25")

Schema - custo_producao¶

Coluna	Tipo	Descricao
`cultura`	str	Nome da cultura
`uf`	str	Sigla da UF
`safra`	str	Safra (ex: "2024/25")
`item`	str	Item de custo
`categoria`	str	Categoria (insumos, operacoes, mao_de_obra, etc)
`valor_ha`	float	Valor por hectare (R$/ha)
`unidade`	str	Unidade do item

Status (fev/2026)¶

As planilhas de graos (soja, milho, cafe, algodao) no gov.br sao carregadas via JavaScript dinamico e nao possuem links .xlsx acessiveis via scraping. Culturas menores (abacaxi, acai, etc.) funcionam normalmente.

Serie Historica (v0.8.0)¶

Dados historicos de safras desde ~1976, disponibilizados em planilhas Excel (.xls legacy). O parser detecta automaticamente o formato (OLE2/BIFF → xlrd, OOXML → openpyxl).

# Serie historica de soja
df = await conab.serie_historica("soja", inicio=2020, fim=2025)

# Filtrar por UF
df = await conab.serie_historica("soja", inicio=2020, uf="MT")

Schema - serie_historica¶

Coluna	Tipo	Descricao
`safra`	str	Safra (ex: "2024/25")
`produto`	str	Nome do produto
`uf`	str	Sigla da UF
`area_plantada`	float	Mil hectares
`producao`	float	Mil toneladas
`produtividade`	float	kg/ha

Cache¶

Aspecto	Valor
TTL	24 horas
Stale maximo	30 dias
Politica	TTL fixo

Atualizacao¶

Aspecto	Valor
Frequencia	Mensal
Publicacao	Geralmente entre dias 10-15