parcel-tracker-bot
Bot Telegram autoalojado para seguimiento de paquetes con 24+ transportistas globales. Arquitectura plugin, mapeo de rutas offline sin APIs externas, observabilidad Prometheus y hardening de contenedor.
Ficha actualizada 24 sept 2026, 9:10 · upstream 24 sept 2026, 8:33 · release v0.3.0
Qué es parcel-tracker-bot
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
parcel-tracker-bot es un bot Telegram autoalojado diseñado para usuarios avanzados que gestionan su propia infraestructura. Permite el seguimiento de paquetes a través de más de 24 transportistas mundiales con arquitectura plugin que facilita añadir transportistas nacionales sin forking el proyecto.
El sistema incluye detección automática del carrier mediante regex priority, mapa de rutas offline usando GeoNames bundled y tiles OSM/CARTO sin claves API externas. Implementa auto-quarantine para transportistas rotos (3/6/12 fallos → 1h/6h/24h) y notificaciones granulares por estado.
La observabilidad incluye exportador Prometheus en :9090/metrics, logs estructurados con structlog y hardening de contenedor (rootfs read-only, no-new-privileges, capabilities dropped). Soporta Python 3.11+, Docker/Compose y licencias MIT.
- Seguimiento de envíos internacionales sin depender de SaaS externos
- Extensión con transportistas nacionales mediante plugins personalizados
- Visualización de rutas offline para auditoría de entregas
- Monitorización de salud de trackers con auto-quarantine automático
- Arquitectura plugin: añadir trackers en plugins/ sin fork del proyecto
- Mapeo de rutas offline con GeoNames bundled y tiles OSM/CARTO
- Auto-detect carrier por regex priority con fallback universal 17track
- Auto-quarantine de transportistas rotos (3/6/12 fallos → 1h/6h/24h)
- Observabilidad completa: Prometheus + logs estructurados structlog
- Hardening de contenedor: read-only rootfs, no-new-privileges, capabilities dropped
- Requiere TELEGRAM_BOT_TOKEN y OWNER_ID obligatorios en .env
- Algunos transportistas (Amazon Logistics, China Post, EMS) requieren TRACK17_API_KEY
- GeoNames index bundled limitado a ciudades de hasta ~3000 habitantes
- Tiles por defecto CARTO voyager; requiere configuración OSM_TILE_URL para otros servidores XYZ
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendaciones: usar docker compose up -d con .env configurado. Mínimo 2 CPU cores, 2GB RAM, 10GB disk. Habilitar Prometheus en :9090/metrics para monitorización. Hardening por defecto (read-only rootfs). Para tiles alternativos configurar OSM_TILE_URL y MAP_TILE_SIZE. Ver docs/architecture.md para data flow y docs/plugins.md para crear trackers personalizados.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.