API Noticias Agrícolas¶

O módulo Noticias Agrícolas republica indicadores CEPEA/ESALQ e serve como fallback automático quando o acesso direto ao CEPEA falha (Cloudflare).

zona_cinza

Notícias Agrícolas é classificado como zona_cinza porque não foi localizada licença própria de reutilização das cotações. A reserva genérica de direitos não comprova uma proibição específica de reutilizar todo fato numérico, nem concede permissão sobre relatórios ou bases protegidas. Dados de origem CEPEA conservam a CC BY-NC 4.0: exigem atribuição, e o uso comercial requer autorização do titular. O fallback automático permanece e emite o aviso do publicador, além do aviso da origem. Quando CEPEA e Notícias Agrícolas constam em MetaInfo.data_sources, prevalece nc em MetaInfo.license.

Uso interno

Este módulo não e chamado diretamente pelo usuário. E invocado automaticamente pelo módulo CEPEA como fallback. Documentado aqui para referencia tecnica.

Funções¶

`fetch_indicador_page`¶

Busca página HTML com indicadores de um produto.

async def fetch_indicador_page(produto: str) -> str

Parâmetro	Tipo	Descrição
`produto`	`str`	Produto (soja, milho, boi, cafe, algodao, trigo, etc.)

Retorno: HTML da página como string.

`parse_indicador`¶

Extrai indicadores do HTML.

def parse_indicador(html: str, produto: str) -> list[Indicador]

Parâmetro	Tipo	Descrição
`html`	`str`	Conteúdo HTML da página
`produto`	`str`	Nome do produto

Retorno: Lista de objetos Indicador.

Notas¶

Fonte: Notícias Agrícolas — zona_cinza; origem CEPEA nc.
Fallback automático do CEPEA — usuário não precisa chamar diretamente
Warning emitido no primeiro uso
Fallback ativo enquanto CEPEA estiver protegido por Cloudflare

Produto desconhecido ou de tipo inválido levanta InvalidParameterError com a lista de produtos aceitos, antes de qualquer requisição. Caixa e espaços externos são normalizados.

parse_indicador() aplica essa validação antes de interpretar o HTML e aceita aliases com acento, como " CAFÉ ". Produto desconhecido não recebe uma unidade genérica: ele é recusado com a lista de opções, preservando as unidades e praças dos produtos publicados.