Fontes de Dados¶

O agrobr integra dados de 25 fontes de dados agricolas. Todas as fontes suportam return_meta=True para rastreabilidade completa.

Visao Geral¶

Fonte	Tipo	Atualizacao	Cobertura
CEPEA/ESALQ	Precos	Diaria	Commodities agricolas
CONAB	Safras, custos, serie historica	Mensal	Producao nacional
IBGE/SIDRA	Estatisticas	Anual/Mensal	Dados oficiais
NASA POWER	Climatologia	Diaria	Global, grid 0.5 grau
BCB/SICOR	Credito rural	Mensal	Cultura/UF (+ BigQuery)
ComexStat	Exportacoes	Semanal	NCM/UF
ANDA	Fertilizantes	Mensal	UF/mes
ABIOVE	Exportacao complexo soja	Mensal	Volume/receita
USDA PSD	Oferta/demanda internacional	Mensal	Commodities globais
IMEA	Cotacoes e indicadores MT	Diaria	Mato Grosso
DERAL	Condicao lavouras PR	Semanal	Parana
INMET	Meteorologia	Diaria	600+ estacoes (API fora do ar)
Notícias Agrícolas	Cotações (fallback CEPEA)	Diária	Commodities
Queimadas/INPE	Focos de calor	Diária	6 biomas, 13 satélites
Desmatamento PRODES/DETER	Desmatamento + alertas	Anual/Diária	Amazônia, Cerrado, Pantanal
MapBiomas	Cobertura e uso da terra	Anual	Municípios (1985-presente)
CONAB Progresso	Plantio/colheita semanal	Semanal	6 culturas, 27 UFs
B3 Futuros Agro	Ajustes diarios + posicoes em aberto	Diaria	7 contratos agricolas
CONAB CEASA	Precos atacado hortifruti	Diaria	48 produtos, 43 CEASAs
UN Comtrade	Comercio bilateral + trade mirror	Mensal/Anual	~200 paises, HS codes
ANTAQ	Movimentacao portuaria de carga	Anual	Portos brasileiros, 2010+
ANP Diesel	Precos revenda + volumes diesel	Semanal/Mensal	UFs, municipios, 2013+
ANTT Pedagio	Fluxo de veiculos em pracas de pedagio	Mensal	200+ pracas, 2010+
MAPA PSR	Apolices e sinistros seguro rural	Anual	27 UFs, 2006+
SICAR	Cadastro Ambiental Rural	Continua	27 UFs, 7.4M+ imoveis

Proveniencia e Rastreabilidade¶

Toda informacao retornada pelo agrobr pode ser rastreada ate sua origem. Use o parametro return_meta=True para obter metadados completos de proveniencia.

import asyncio
from agrobr import cepea

async def main():
    # Uso basico (sem mudanca)
    df = await cepea.indicador('soja')

    # Com metadados de proveniencia
    df, meta = await cepea.indicador('soja', return_meta=True)

    print(f"Fonte: {meta.source}")
    print(f"URL: {meta.source_url}")
    print(f"Coletado em: {meta.fetched_at}")
    print(f"Do cache: {meta.from_cache}")
    print(f"Registros: {meta.records_count}")

asyncio.run(main())

Estrutura do MetaInfo¶

O objeto MetaInfo contem as seguintes informacoes:

Campo	Tipo	Descricao
`source`	str	Nome da fonte (cepea, conab, ibge)
`source_url`	str	URL exata acessada
`source_method`	str	Metodo de acesso (httpx, cache)
`fetched_at`	datetime	Momento da coleta
`from_cache`	bool	Se veio do cache local
`cache_key`	str	Chave no cache
`cache_expires_at`	datetime	Quando o cache expira
`records_count`	int	Quantidade de registros
`columns`	list	Colunas retornadas
`fetch_duration_ms`	int	Tempo de fetch em ms
`parse_duration_ms`	int	Tempo de parsing em ms
`agrobr_version`	str	Versao do agrobr
`parser_version`	int	Versao do parser usado

Verificacao de Integridade¶

O MetaInfo permite verificar integridade dos dados:

# Verifica se DataFrame nao foi alterado
is_valid = meta.verify_hash(df)

# Exporta metadados para auditoria
meta_json = meta.to_json()
meta_dict = meta.to_dict()

Diagnostico¶

Use o comando doctor para verificar saude do sistema:

agrobr doctor

Retorna: - Status de conectividade das fontes - Estatisticas do cache - Ultimas coletas - Configuracao atual