← Back to Skills Marketplace
zhongkedy-del

Parcel Tracking Assistant

by zhongkedy-del · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
49
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install logistics-tracker-en
Description
Track parcel status from major US/EU carriers (UPS, FedEx, USPS, DHL, Royal Mail, PostNL, etc.) by tracking number. Triggered when the user sends a tracking...
README (SKILL.md)

Parcel Tracking Assistant

This skill, created by coopeai.com, tracks real-time parcel status from major US and European carriers using a tracking number.

Trigger Conditions

Invoke this skill when:

  • The user sends a tracking number (standalone or with a carrier name)
  • The user says "track my parcel", "where is my package", "check my delivery"
  • The user asks about shipping status, delivery location, or estimated arrival
  • The user sends a number string and asks "has it arrived?" or "where is it?"

Step 1 — Identify the Carrier

Match the tracking number format using the rules below (most specific first):

Carrier Format Rule Example
UPS 1Z[A-Z0-9]{16} 1Z999AA10123456784
FedEx Express 12-digit number only 123456789012
FedEx Ground/Economy 15 / 20 / 22-digit number only 012345678901234
USPS Domestic Starts with 94/92/93, 20–22 digits 9400111899223397467490
USPS International [A-Z]{2}[0-9]{9}[A-Z]{2} EA123456789US
DHL Express 10–11-digit number (no letter prefix) 1234567890
DHL eCommerce Starts with GM, 16–18 chars, or starts with 420 GM6019267030000285
Royal Mail (UK) [A-Z]{2}[0-9]{9}GB RA123456789GB
PostNL (Netherlands) 3S[A-Z0-9]{14} or JJD[0-9]{18} 3SDEVC123456789A
DPD (Europe) Starts with 05, 14 digits 05012345678901
GLS (Europe) 8–11 digits 12345678
Evri / Hermes (UK) 16 alphanumeric chars (often starts with H) H1234567890ABCD
Amazon Logistics TBA[0-9]{9,12} TBA123456789000
Purolator (Canada) [A-Z]{3}[0-9]{9} PUR123456789
Canada Post 16 digits, or [A-Z]{2}[0-9]{9}CA 1234567890123456

If the format is ambiguous (e.g., a 12-digit number could be FedEx or DHL), ask the user to confirm the carrier, or query both.


Step 2 — Retrieve Tracking Information

Primary: WebSearch

Use the following search queries per carrier:

Carrier Search Query
UPS UPS tracking {number}
FedEx FedEx track {number}
USPS USPS tracking {number}
DHL DHL Express tracking {number}
Royal Mail Royal Mail track {number}
PostNL PostNL track {number}
DPD DPD tracking {number}
Amazon Amazon order tracking {number}

Fallback: Direct Carrier Website (WebFetch)

Fetch the tracking page directly (note: some pages require JavaScript — fall back to WebSearch if the response is empty):

Carrier Tracking URL
UPS https://www.ups.com/track?tracknum={number}
FedEx https://www.fedex.com/fedextrack/?trknbr={number}
USPS https://tools.usps.com/go/TrackConfirmAction?tLabels={number}
DHL Express https://www.dhl.com/en/express/tracking.html?AWB={number}&brand=DHL
DHL eCommerce https://www.dhl.com/en/ecommerce/tracking.html?tracking-id={number}
Royal Mail https://www.royalmail.com/track-your-item#/tracking-results/{number}
PostNL https://jouw.postnl.nl/track-and-trace/{number}
Evri / Hermes https://www.evri.com/track/{number}
DPD UK https://www.dpd.co.uk/service/parcelstatus?parcel={number}
Amazon https://track.amazon.com/tracking/{number}
Purolator https://www.purolator.com/en/ship-track/tracking-results.page?pin={number}

Last Resort: 17track Aggregator

If both methods above fail, use 17track (supports 2000+ carriers):

https://t.17track.net/en#nums={number}

Step 3 — Display Results

Output in the following format:

📦 Tracking Number: {number}
🚚 Carrier: {carrier name}
📍 Current Status: {status}  ← e.g. "In Transit", "Out for Delivery", "Delivered"
🕐 Last Update: {date time timezone}
📍 Current Location: {city, state/country}

--- Tracking History ---
(Most recent first)
• {date time} — {location} — {event description}
• {date time} — {location} — {event description}
• {date time} — {location} — {event description}
  … (truncate after 10 events)

📅 Estimated Delivery: {date or "Not available"}
🔗 Track on carrier site: {direct tracking link}

Status Icons:

  • ✅ Delivered
  • 🚚 Out for Delivery
  • 📦 In Transit
  • 🛃 Customs Clearance
  • ⏳ Pending Pickup / Label Created
  • ⚠️ Exception / Delay / Failed Delivery Attempt
  • ❓ No Data

Step 4 — Bulk Tracking

When the user sends multiple tracking numbers at once:

  1. Query each number concurrently (separate WebSearch per number)
  2. First show a summary table:
| # | Tracking Number        | Carrier | Status      | Est. Delivery  |
|---|------------------------|---------|-------------|----------------|
| 1 | 1Z999AA10123456784     | UPS     | In Transit  | Jun 5, 2026    |
| 2 | 123456789012           | FedEx   | Delivered   | Jun 1, 2026    |
  1. Follow the summary with full tracking history for each number.

Step 5 — Edge Cases

No results found:

I searched for tracking number {number} ({carrier}) but found no shipment records. Possible reasons:

  • The seller just created the label and the parcel hasn't been scanned yet (try again in 24–48 hours)
  • The tracking number may contain a typo — please double-check for extra or missing characters
  • The parcel is over 120 days old and tracking has expired

You can also check directly: {direct link}

Ambiguous carrier:

This tracking number ({number}) matches the format for multiple carriers. Which one sent your parcel?

  • FedEx (12-digit number)
  • DHL Express (10-digit number)

Or I can check both for you.

Unrecognized format: If the number doesn't match any known rule, search directly:

track package "{number}"

Identify the carrier from the search results, then display the tracking info.


Quick Reference: Major Carriers by Region

Region Major Carriers
USA UPS, FedEx, USPS, Amazon Logistics, OnTrac, LaserShip
UK Royal Mail, Evri/Hermes, DPD UK, Parcelforce, Yodel
Germany DHL Paket, Hermes DE, DPD DE, GLS, UPS DE
France La Poste/Colissimo, Chronopost, DHL FR, DPD FR, Mondial Relay
Netherlands PostNL, DHL NL, DPD NL, GLS NL
Spain Correos, SEUR, MRW, GLS ES, DHL ES
Italy Poste Italiane, BRT, GLS IT, DHL IT, SDA
Canada Canada Post, Purolator, FedEx CA, UPS CA

When the user mentions a specific European country, prioritize recognizing that country's local carrier formats first.

Usage Guidance
Before installing, be comfortable with tracking numbers being used in web searches, carrier tracking pages, and possibly 17track. For sensitive shipments, prefer asking the agent to use the official carrier site only and avoid aggregator lookups.
Capability Assessment
Purpose & Capability
The skill's stated purpose is parcel tracking, and its capabilities are limited to identifying carriers, querying tracking information, and formatting shipment status results.
Instruction Scope
The trigger phrases are somewhat broad, but they remain tied to package or delivery-status intent; ambiguous tracking numbers prompt carrier confirmation or limited multi-carrier lookup.
Install Mechanism
The artifact is a single non-executable SKILL.md with no dependencies, install scripts, package hooks, or hidden runtime components.
Credentials
External WebSearch, direct carrier pages, and 17track are disclosed and expected for parcel tracking, though they can expose tracking identifiers to third-party services.
Persistence & Privilege
No persistence, background workers, local file indexing, credential access, privilege escalation, or destructive actions are present.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install logistics-tracker-en
  3. After installation, invoke the skill by name or use /logistics-tracker-en
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: real-time parcel tracking for major US/EU carriers, by coopeai.com
Metadata
Slug logistics-tracker-en
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Parcel Tracking Assistant?

Track parcel status from major US/EU carriers (UPS, FedEx, USPS, DHL, Royal Mail, PostNL, etc.) by tracking number. Triggered when the user sends a tracking... It is an AI Agent Skill for Claude Code / OpenClaw, with 49 downloads so far.

How do I install Parcel Tracking Assistant?

Run "/install logistics-tracker-en" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Parcel Tracking Assistant free?

Yes, Parcel Tracking Assistant is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Parcel Tracking Assistant support?

Parcel Tracking Assistant is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Parcel Tracking Assistant?

It is built and maintained by zhongkedy-del (@zhongkedy-del); the current version is v1.0.0.

💬 Comments