gek0v/open-parcels

> Motor universal de rastreo de envíos y paquetería multitransportista de alto rendimiento, autoalojable y modular en Go, con compatibilidad de API con ParcelsApp (v4), CLI interactivo en terminal y Servidor MCP (Model Context Protocol).
## 🚀 Características Principales
1. Detección Automática de Transportistas (Carrier Auto-Detection Engine):
Identificación inteligente basada en expresiones regulares, longitudes fijas, prefijos y validadores de suma de comprobación (Luhn, Modulo 7, Modulo 10, UPU S10, ISO 6346).
Soporte para más de 20 operadores globales y locales: Cainiao / AliExpress, Correos España, Correos Express, GLS, CTT Express, SEUR, Paack, MRW, InPost / Mondial Relay, DHL (Express & Parcel), UPS, FedEx, USPS, YunExpress, 4PX, Royal Mail, Colissimo, IATA Air Cargo (AWB) y Contenedores Marítimos (ISO 6346).
Puntuación de confianza (0.0 a 1.0) y refuerzo heurístico mediante pista de país de destino.
2. Encadenamiento y Fusión Multitransportista (Multi-Carrier Journey & Event Merging):
Rastreabilidad del ciclo de vida completo: tramo internacional (origen Asia / Europa / América) + transferencia aduanera + última milla local (ej. Cainiao ➔ Correos Express, YunExpress ➔ Correos España).
Fusión cronológica descendente de hitos de ambos operadores en una única línea de tiempo continua.
Deduplicación automática de hitos equivalentes dentro de ventanas temporales concurrentes.
3. Máquina de Estados y Normalización Universal:
Estados canónicos: pending, inforeceived, intransit, outfordelivery, delivered, failedattempt, exception, expired.
Estimación y cálculo de progreso porcentual del envío (0% a 100%).
Soporte bilingüe en descripciones de estado (es y en).
4. Múltiples Interfaces de Consumo:
CLI en Go: Salida formateada en terminal con tarjetas ANSI, barras de progreso y línea de tiempo enriquecida, además de modo --json.
REST API Daemon: Servidor HTTP de alto rendimiento con endpoints nativos /api/v1/track y compatibilidad 100% con la API v4 de ParcelsApp (POST /trackings, GET /trackings/:requestid).
Servidor MCP (Model Context Protocol): Compatible con Claude Desktop, Cursor y agentes autónomos mediante transporte stdio y endpoint HTTP streamable /mcp.
## 🛠️ Instalación y Compilación
Requisitos: Go 1.22+
bash
# Clonar el repositorio
git clone https://github.com/open-parcels/open-parcels.git
cd open-parcels
# Compilar el binario
go build -o open-parcels .
# Verificar instalación
./open-parcels version
## 💻 Uso de la CLI
### 1. Rastrear un envío con detección automática y fusión multitransportista
bash
# Rastreo automático con salida visual
open-parcels track LP00561234567890 --lang es
# Rastrear con transportista explícito y salida JSON
open-parcels track 9400111206213785678901 --carrier usps --json
# Rastrear envío internacional con pista de país de destino
open-parcels track YT2401234567890123 --country ES
### 2. Detección automática de transportistas
bash
# Identificar operadores candidatos con porcentaje de coincidencia
open-parcels detect 6900123456789012
# Con pista de país de destino para refinar el ranking
open-parcels detect 123456789012 --country ES
### 3. Listar el catálogo de transportistas disponibles