logistics-tracking
by shopmeskills
Browser & AutomationBrief
Track international packages by tracking number.
Description
What This Skill Does
Tracks international packages by tracking number across 3100+ carriers. Uses the 17track API when a key is provided, or falls back to Playwright for headless browser queries. Supports batch tracking, carrier auto-detection, and status code explanations.
Instead of visiting each carrier's website separately, a single tracking number query auto-detects the carrier and returns a full event timeline across 3100+ carriers.
When to Use It
- Checking where an AliExpress order is after two weeks
- Tracking multiple packages from different carriers at once
- Finding out if a shipment is held at customs
- Identifying which carrier a tracking number belongs to
- Getting a delivery estimate for a China-to-US shipment
Example Workflow
User asks: Where is my package LX123456789CN?
- 1
Calls detect_carrier with the tracking number to identify China Post
- 2
Calls track_package with the tracking number and detected carrier
- 3
Parses the returned status and event timeline
- 4
Calls explain_status if the status code needs clarification
- 5
Returns current location, status, and last update to the user
Package LX123456789CN is in transit at Los Angeles ISC, last updated 2 days ago, estimated delivery in 3-5 days.
Requirements
- TRACK17_API_KEY environment variable (free API key from api.17track.net, recommended for best reliability)
- playwright npm package (only required when running without TRACK17_API_KEY)
Installation
clawhub install shopmeskills/logistics-trackingRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.