AGRO PRECIOS

Paquete Node.js/TypeScript para procesar datos agrícolas del MAPA.

Características Principales

• 📂 Parseo de archivos XLSX con estructura oficial
• 📅 Filtrado por fechas específicas
• 🔄 Conversión automática a €/kg
• 🌐 Descarga directa de fuentes oficiales

Instalación

Ejecuta en tu terminal:

npm install agro-precios

Uso Basico

import { parsePrecios, descargarPrecios } from 'agro-precios';

// 1. Parsear archivo local
const datos = parsePrecios('ruta/archivo.xlsx');

// 2. Descargar y procesar
async function obtenerDatos() {
  const ruta = await descargarPrecios(2025);
  const datosConvertidos = parsePrecios(ruta);
  console.log(datosConvertidos);
}

Conversión a Euros/KG

import { convertirAEurosPorKg } from 'agro-precios';

const datosEnKg = convertirAEurosPorKg(datos);
console.log(datosEnKg[0].precios[0].valor); // Ej: 0.2358 €/kg

Ejemplo de estructura de datos

{
  "sector": "CEREALES",
  "producto": "Trigo blando panificable (€/t)",
  "especificacion": "(1)",
  "precios": [
    {
      "semana": "Semana 01",
      "fecha": "2025-01-05T00:00:00.000Z",
      "valor": 235.84
    }
  ]
}

Opciones avanzadas

// Filtrado por fecha
const filtro = { dia: 15, mes: 3, año: 2025 };
const datosFiltrados = parsePrecios('archivo.xlsx', filtro);

// Configurar carpeta de descargas
descargarPrecios(2024, './mis-descargas');

Ejemplo

En el directorio src se encuentra el script ejemplo.ts

npx ts-node src/ejemplo.ts

Configuracion recomendada

-Node.js v18+ -TypeScript v5+ -Archivos fuente en UTF-8

Licencia

Este proyecto se distribuye bajo la Licencia MIT.
Esto significa que puedes usar, modificar y distribuir el software libremente, siempre y cuando se incluya la atribución correspondiente y una copia de la licencia en cualquier redistribución.
© 2024

Contacto

💼

Cambios recientes

Mejoras en el parsing de fechas (2024)

Se han realizado mejoras significativas en el parseo de fechas para manejar correctamente los diferentes formatos que pueden aparecer en los archivos Excel de precios agrarios:

• Soporte para formatos de rango de fechas como "DD-DD/MM" (ej: "02-08/01")
• Soporte para formatos de rango con fechas completas como "DD/MM-DD/MM" (ej: "30/01-05/02")
• Extracción automática del año desde los metadatos del archivo
• Manejo de fechas en formato numérico de Excel

Corrección en la identificación de sectores

Se ha mejorado la forma en que se identifican y asignan los sectores a los productos:

• Detección correcta de límites entre sectores
• Preservación de la jerarquía original del archivo
• Asignación consistente de productos a sus sectores correspondientes

Estos cambios permiten que la biblioteca procese correctamente todos los archivos de precios, independientemente del año o formato específico del documento.