Parcel Tracking

What Is Parcel Tracking?

Parcel Tracking is a Claude Code skill designed to streamline the process of tracking parcels and checking delivery statuses across both Australian and international couriers. It automates the search for tracking numbers by scanning Gmail for dispatch or shipping emails, extracting relevant tracking information, and providing tracking links for major courier services. This skill supports a wide array of carriers, including AusPost, StarTrack, Aramex, CouriersPlease, Sendle, Toll, Team Global Express, DHL, FedEx, TNT, Hunter Express, Border Express, Direct Freight Express, and UPS. By leveraging this tool, users can efficiently monitor the status of their deliveries without having to manually sift through countless emails or visit multiple courier websites.

Why Use Parcel Tracking?

Managing multiple online orders can quickly become overwhelming, especially when tracking shipments from various stores and couriers. Each courier typically provides its own tracking interface, and shipping notification emails are often buried in a cluttered inbox. Parcel Tracking addresses these challenges by automating and consolidating the tracking process. Key benefits include:

• Time savings: No more digging through emails or copying tracking numbers between websites.
• Accuracy: Automated extraction reduces the risk of human error, such as missing or mistyping tracking numbers.
• Comprehensive coverage: Supports all major Australian couriers as well as several international providers.
• Proactive updates: Enables quick checks on delivery statuses without leaving your workflow.
• User-friendly triggers: Responds to natural language queries like "Where is my parcel?" or "Track my order from [store]."

For businesses and individuals alike, this means less time managing logistics and more time focusing on what matters.

How to Get Started

Setting up and using the Parcel Tracking skill involves a few straightforward steps. While this article focuses on usage within Claude Code, the underlying concepts can be adapted to other environments.

1. Installation

Clone the skill repository from GitHub:

git clone https://github.com/jezweb/claude-skills.git
cd claude-skills/plugins/integrations/skills/parcel-tracking

Install any necessary dependencies, as specified in the repository documentation.

2. Setting Up Gmail

Access

Parcel Tracking requires read access to your Gmail account to search for dispatch emails. Ensure you have configured OAuth credentials or a secure API key as appropriate for your environment. This will enable the skill to programmatically scan your inbox for tracking information.

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file('credentials.json')
service = build('gmail', 'v1', credentials=creds)

3. Triggering the

Skill

The skill responds to various natural language prompts, such as:

• "Track my order from Amazon"
• "Has my package from mwave.com.au arrived?"
• "Check the Toll tracking for my last delivery"
• "Where is my parcel?"

Alternatively, users can paste a tracking number directly to receive its current status.

Key Features

• Automated Email Search: Scans Gmail inbox for recent dispatch or shipping emails using relevant keywords (e.g., "dispatched", "shipped", "tracking number", "consignment number") within the last 30 days.

• Flexible Query Narrowing: Supports refined searches such as from:amazon.com.au shipped to target specific vendors or orders.

• Intelligent Extraction: Parses email bodies to extract tracking numbers, carrier names, and order information using pattern matching or regular expressions.

  Example extraction logic:

  python

  import re
  
  def extract_tracking_number(email_body):
      match = re.search(r'(Tracking|Consignment) Number:\s*(\w+)', email_body)
      return match.group(2) if match else None

• Multi-Courier Support: Generates tracking links for all major Australian and several international couriers.

• Direct Status Retrieval: Where possible, fetches live tracking status directly from courier APIs or tracking websites.

Best Practices

• Limit Search Scope: For efficiency and accuracy, narrow Gmail searches to recent emails and, if possible, filter by sender (e.g., from:mwave.com.au dispatched).
• Validate Extraction: Always check that the extracted tracking number matches the expected format for the carrier in question.
• Data Privacy: Ensure Gmail access is securely managed and that sensitive data is handled in compliance with privacy requirements.
• Handle Edge Cases: Be prepared for emails without clear tracking information or for tracking numbers that do not resolve due to courier delays or API downtime.
• User Feedback: If the skill cannot find a tracking number, prompt the user to provide one or confirm the order details.

Important Notes

• Authentication Required: The skill requires secure, authorized access to Gmail. Ensure credentials are kept confidential.
• Supported Couriers: While the skill covers major Australian and some international couriers, less common carriers may not be supported.
• Email Structure Variations: Some dispatch emails may use non-standard formats or images for tracking numbers, which can affect extraction reliability.
• API Rate Limits: Frequent status checks may be subject to rate limits imposed by some courier APIs.
• Maintenance: Regular updates to extraction logic may be needed to accommodate changes in email templates or courier tracking URLs.

By integrating Parcel Tracking into your workflow, you can greatly enhance your ability to manage deliveries efficiently and accurately.