Fontes de Dados¶

O agrobr integra dados de 41 fontes de dados agrícolas. As funções de dados das fontes que devolvem tabela aceitam return_meta=True (cepea.ultimo, que devolve um Indicador, não aceita); a Notícias Agrícolas, fallback do CEPEA, tem a proveniência no cepea.indicador(..., return_meta=True). O que tem garantia de SemVer em cada fonte está na API pública.

Visao Geral¶

Fonte	Tipo	Atualização	Cobertura
CEPEA/ESALQ	Precos	Diaria	Commodities agrícolas
CONAB	Safras, custos, serie histórica (agrícola e industrial da cana), progresso semanal, CEASA/PROHORT	Mensal/Semanal/Diaria	Produção nacional
IBGE/SIDRA	Estatísticas	Anual/Mensal/Trimestral	Dados oficiais (PAM, LSPA, PPM, Abate, PEVS, Leite, PIB, Censo), malha municipal e áreas urbanizadas (WFS geo)
NASA POWER	Clima diário e mensal	Diaria	Global, grid 0.5 grau
BCB	Crédito rural, séries temporais, câmbio/boletins e expectativas	Varia por serviço	Cultura/UF, série, moeda/boletim ou indicador
ComexStat	Exportações	Semanal	NCM/UF
ANDA	Fertilizantes	Mensal	UF/mes
ABIOVE	Exportacao complexo soja	Mensal	Volume/receita
ANEC	Embarques semanais por porto	Semanal	19 portos, 6 produtos
USDA PSD	Oferta/demanda internacional	Mensal	Commodities globais
IMEA	Cotações e indicadores MT	Diaria	Mato Grosso
DERAL	Condição lavouras PR	Semanal	Parana
INMET	Meteorologia	Diaria	600+ estações (API observacional exige token; ZIPs históricos são públicos)
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)
B3 Futuros Agro	Ajustes diários + posicoes em aberto	Diaria	7 contratos agrícolas
UN Comtrade	Bilateral 2.1 e espelho 2.0, contagem e partições	Mensal/Anual	HS, World ou parceiros publicados
ANTAQ	Movimentacao portuária de carga	Anual	⚠️ Fonte fora do ar desde 23/06/2026
ANP Diesel	Precos revenda + volumes diesel	Semanal/Mensal	UFs, municípios, 2013+
ANTT Pedagio	Fluxo de veículos 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
ZARC	Zoneamento Agrícola de Risco Climático	Semanal	108 culturas no catálogo; municípios de cada publicação
Agrofit/MAPA	Agrotoxicos registrados	Continua	~8K formulados, ~267K autorizacoes
FUNAI Terras Indigenas	Terras indigenas (WFS geo)	Continua	665 TIs, todas as UFs
ICMBio UCs Federais	Unidades de conservacao federais (WFS geo)	Continua	347 UCs federais, sem RPPN
CNUC Unidades de Conservação	UCs federais, estaduais e municipais, com RPPNs (WFS geo)	Contínua	3.450 UCs
INCRA Quilombolas	Perímetros quilombolas (WFS geo), andamento dos processos (PDF) e vínculos por NUP	Continua	445 perímetros e 649 processos (22/09/2026)
Acervo Fundiario/INCRA	Parcelas certificadas + assentamentos (shapefile ZIP)	Continua	SIGEF (27 UFs, público e privado) + SNCI (24 UFs em 01/10/2026) + assentamentos Brasil
IBAMA Embargos	Embargos ambientais (CSV de dados abertos + WKT)	Diária	~116 mil termos
MapBiomas Alerta	Alertas de desmatamento (GraphQL)	Semanal	Nacional
Lista Suja	Cadastro MTE (CSV/TXT; alternativa PDF)	Publicação periódica com atualizações intermediárias	Nacional
ANA/SNIRH	Hidrografia, irrigação, disponibilidade hidrica, massas d'água (ArcGIS REST)	Variável	Nacional
SFB	Florestas publicas, concessoes, IFN (ArcGIS REST)	Anual	Nacional
RNC/CultivarWeb	Cultivares registradas/protegidas	Contínua	~37K registradas, ~5K protegidas
EMBRAPA Solos	Perfis de solo e mapa pedológico	Contínua	34K perfis, 2.8K polígonos
Fundação Rio Verde	Ensaios cultivares soja MT	Anual	3 safras (2023/24 a 2025/26), até 4 épocas
CFTC COT	Posicionamento de fundos em futuros agro	Semanal	12 contratos Chicago/NY, 2006+
UNICA	Moagem e produção acucar/etanol Centro-Sul	Quinzenal	Safra corrente + historico 1980-2021

Proveniencia e Rastreabilidade¶

Toda informação retornada pelo agrobr pode ser rastreada até sua origem. Use o parâmetro 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 traz, entre outros, os campos abaixo; a lista completa, com validation_warnings, source_details, schema_version, attempted_sources, selected_source e fetch_timestamp, está em Contratos. cache_key e cache_expires_at podem ser nulos; preenchidos, não indicam que o dado veio do cache: para isso, use from_cache.

Campo	Tipo	Descrição
`source`	str	Nome da fonte (cepea, conab, ibge)
`source_url`	str	URL exata acessada
`source_method`	str	Método de acesso (httpx, cache)
`fetched_at`	datetime	Momento da coleta
`from_cache`	bool	Se veio do cache local
`cache_key`	str \| None	Chave no cache
`cache_expires_at`	datetime \| None	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	Versão do agrobr
`parser_version`	int	Versão do parser usado

Exportar para auditoria¶

O MetaInfo exporta os metadados; raw_content_hash é o SHA-256 do corpo recebido da fonte (ver Contratos):

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 - Estatísticas do cache - Últimas coletas - Configuração atual