Parcel Tracking

# Parcel Tracking

Find tracking numbers from Gmail dispatch emails and check delivery status for Australian and international couriers.

## When to Use

- "Where's my parcel / package / order?"
- "Has my [product] arrived / shipped yet?"
- "Track my order from [store]"
- "What's the status of my delivery?"
- "Do I have a tracking number for [item]?"
- User pastes or mentions a tracking number
- "Check the StarTrack / AusPost / Aramex / Toll tracking"

## Workflow

### Step 1: Find the Tracking Number

If the user already provided a tracking number, skip to Step 2.

Otherwise, search Gmail for dispatch emails. Look for recent messages matching:

```
dispatched OR shipped OR "tracking number" OR "consignment number" newer_than:30d
```

For a specific store or order, narrow the search:
```
from:mwave.com.au dispatched
from:amazon.com.au shipped
```

Read the email body and extract:
- Tracking / consignment number
- Carrier name
- Order number
- Dispatch date
- Delivery notes (signature required, etc.)

**Gmail access**: Use whatever Gmail tool is available (Gmail MCP, gws CLI `gws gmail`, or ask the user to check manually and paste the tracking number).

### Step 2: Identify the Carrier and Build the Tracking Link

Use the table below to identify the carrier from the tracking number format or dispatch email, then build the direct tracking link where possible.

| Carrier | Number format / example | Direct tracking link |
|---------|------------------------|----------------------|
| **AusPost / StarTrack** | Alphanumeric, e.g. `36VJ65064757`, `JD123456789AU` | `https://auspost.com.au/mypost/track/details/{NUMBER}` |
| **Sendle** | 6-8 alphanumeric chars, e.g. `SNFJJ3` | `https://track.sendle.com/tracking?ref={NUMBER}` |
| **DHL** | 10-12 digits, e.g. `1234567890` | `https://www.dhl.com/au-en/home/tracking.html?tracking-id={NUMBER}` |
| **FedEx** | 12-15 digits, or AU+10 digits | `https://www.fedex.com/apps/fedextrack/?tracknumbers={NUMBER}` |
| **TNT** (now FedEx) | 9 digits, e.g. `907384999` | `https://www.tnt.com/express/en_au/site/shipping-tools/tracking.html` (paste) |
| **UPS** | Starts with 1Z, 18 chars | `https://www.ups.com/track?tracknum={NUMBER}` |
| **Aramex** (formerly Fastway) | Numeric label number, varies | `https://www.aramex.com.au/tools/track` (paste) |
| **CouriersPlease** | Numeric or CP prefix | `https://www.couriersplease.com.au/tools-track` (paste) |
| **Toll / MyToll** | Numeric consignment, varies | `https://mytoll.com/` (paste) |
| **Team Global Express** | Numeric, varies | `https://myteamge.com/` (paste) |
| **Hunter Express** | Alphanumeric, e.g. `AIM478695` | `https://www.hunterexpress.com.au/tracking/` (paste) |
| **Border Express** | Numeric, varies | `https://www.borderexpress.com.au/tracking/` (paste) |
| **Direct Freight Express** | Numeric consignment | `https://www.directfreight.com.au/ConsignmentStatus.aspx` (paste) |

**Deep-links** (tracking number in URL): AusPost/StarTrack, Sendle, DHL, FedEx, UPS.

**Form-based** (provide link + number separately): Aramex, CouriersPlease, Toll, Team Global Express, Hunter Express, Border Express, Direct Freight Express, TNT.

**If carrier is unknown:** Default to AusPost (most common in Australia), or ask the user to check their dispatch email.

### Step 3: Try to Get Live Status

If web scraping tools are available, try scraping the tracking page:

```
url: {direct tracking URL}
wait_for: 3000 (many tracking pages are JS-