beerygaz/parcel-tracker

OpenClaw skill for tracking South African courier parcels — Shiplogic, ParcelPerfect, UPS, RAM # parcel-tracker An OpenClaw skill for tracking South African courier parcels. ## Overview Track parcels across multiple South African courier services from a single interface. The skill auto-detects which courier a tracking number belongs to and retrieves the latest status. ## Supported Couriers ### Shiplogic Ecosystem (no authentication required) - **Internet Express** — Provider ID 9 - **The Courier Guy** — Provider ID 7 - **RAM Hand-to-Hand** — Provider ID 44 ### ParcelPerfect - **Aspiring Couriers** — Waybill prefix `ASP` - Extensible to any ParcelPerfect-powered courier ### Other - **UPS** — Via official REST API (OAuth2) - **RAM Legacy** — Web scraper fallback for parcels not yet on Shiplogic ## Quick Start ### Installation ```bash # Clone to your OpenClaw skills directory git clone github.com ~/.openclaw/workspace/skills/parcel-tracker # Install Python dependencies pip install requests beautifulsoup4 # Run first-time setup (creates your private config files from examples) cd ~/.openclaw/workspace/skills/parcel-tracker ./setup.sh ``` The setup script copies `references/*.example.*` to their working names (which are gitignored — your tracking data stays private). ### Basic Usage ```bash # Auto-detect courier and track python3 scripts/track.py auto # Track via specific provider python3 scripts/track.py track --provider 9 # Track UPS parcel python3 scripts/track.py ups # Track ParcelPerfect parcel python3 scripts/track.py pperfect ``` ### Shell Wrapper ```bash # Quick auto-track ./scripts/auto-track.sh ``` ## Environment Variables | Variable | Required For | How to Get | |---|---|---| | `UPS_CLIENT_ID` | UPS tracking | Register at developer.ups.com | | `UPS_CLIENT_SECRET` | UPS tracking | Same as above | | `PPERFECT_ASPIRING_TOKEN` | Aspiring Couriers | Visit `aspiringcouriers.pperfect.c…` → extract `cryptcust` | > **Note:** Shiplogic and RAM legacy tracking require no crede …