📦 Paczkomatowo – Node.js CLI & API

Oficjalne narzędzie wiersza poleceń dla Paczkomatowo.pl – Zaawansowane śledzenie przesyłek InPost, wykrywanie Paczkomatu nadawczego, wyszukiwarka maszyn i czujniki jakości powietrza (Green City).

⚡ Szybki start (bez instalacji)

Możesz uruchomić narzędzie bezpośrednio za pomocą npx:

npx paczkomatowo track <NUMER_PRZESYŁKI>

🚀 Instalacja globalna

npm install -g paczkomatowo

📋 Dostępne polecenia

1. 🔍 Śledzenie przesyłki + Paczkomat nadawczy i docelowy

Pobiera aktualny status, historię zdarzeń oraz ujawnia kod i adres Paczkomatu, z którego nadano paczkę:

paczkomatowo track 661872657666620125594523

(lub skrótowo: paczkomatowo 661872657666620125594523)

2. 🏢 Sprawdzanie szczegółów Paczkomatu

Pobiera status techniczny, adres, współrzędne GPS, dostępność 24/7, stację Green City i zdjęcie maszyny:

paczkomatowo point WAW01M
paczkomatowo point GUB01BAPP

3. 📍 Wyszukiwarka maszyn w mieście

paczkomatowo search Gubin
paczkomatowo search Warszawa Marszałkowska

4. 🌫️ Stacje jakości powietrza Green City

Wyszukuje Paczkomaty wyposażone w czujniki smogu i pyłów zawieszonych:

paczkomatowo air Gubin
paczkomatowo air Wrocław

5. ⏰ Godziny graniczne nadań (Cut-off time)

Sprawdza, do której godziny musisz włożyć paczkę do skrytki w swoim kodzie pocztowym, aby wyjechała w trasę jeszcze dzisiaj:

paczkomatowo cutoff 50-430

6. 🔑 Własny klucz API (Neon DB)

Możesz zapisać swój klucz API pobrany z Paczkomatowo.pl:

paczkomatowo auth paczka_free_twój_klucz

🌐 Publiczne REST API

Wszystkie te same funkcje są dostępne przez REST API z włączonym CORS:

# Śledzenie:
curl "https://inpost-web.vercel.app/track/{NUMER_PACZKI}" -H "x-api-key: TWÓJ_KLUCZ"

# Szczegóły maszyny:
curl "https://inpost-web.vercel.app/points/{KOD_MASZYNY}" -H "x-api-key: TWÓJ_KLUCZ"

# Wyszukiwanie:
curl "https://inpost-web.vercel.app/points?city={MIASTO}" -H "x-api-key: TWÓJ_KLUCZ"

📄 Licencja

MIT © Paczkomatowo.pl