SPX Express Tracking for Openclaw

A specialized logistics skill for querying real-time SPX Express and Cainiao Malaysia shipment data with advanced bottleneck analysis.

wiziscool
v1.0.1
Mar 22, 2026
0
766
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install spx-tracking

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install spx-tracking using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is SPX Express Tracking?

SPX Express Tracking is a robust logistics utility designed for Openclaw Skills to interface directly with the public SPX API. It provides developers and users with the ability to monitor parcel lifecycles, specifically focusing on the Malaysia region where SPX Express handles last-mile delivery for Cainiao.

Beyond basic status updates, this skill excels at parsing complex logistics data to provide structured JSON, human-readable reports, and insightful delay analysis. It is an essential tool for any AI agent managing e-commerce workflows or personal productivity tasks involving cross-border or local Malaysian deliveries.

SPX Express Tracking Use Cases

  • Tracking SPX Express parcels using CNMY or SPXMY tracking formats.
  • Monitoring Cainiao Smart Logistics shipments in Malaysia where SPX serves as the last-mile carrier.
  • Identifying delivery delays and logistical bottlenecks through automated stay-time analysis.
  • Providing estimated delivery dates (ETA) to users in multi-lingual contexts (English and Chinese).
  • Generating full, human-readable logistics reports for end-user support.

How SPX Express Tracking Works

  1. The agent identifies a tracking number prefix (CNMY/SPXMY) or relevant intent phrases like shipping or logistics.
  2. The skill executes a Python script to call the public SPX API with optional parameters for cookies or timeouts.
  3. Raw API data is processed into a structured format, deduplicating events and calculating time durations between stops.
  4. The script performs a geo-route analysis to map current longitude and latitude coordinates where available.
  5. Depending on the requested format, the skill returns a concise summary, a detailed JSON object, or a formatted text report.

SPX Express Tracking Setup

To integrate this into your Openclaw Skills environment, ensure you have Python 3 installed. The script will automatically handle virtual environment creation and dependency installation on its first run.

# Manual installation of dependencies
pip install -r requirements.txt

# Basic usage command
python skills/spx-tracking/scripts/spx_tracking.py <tracking_number> --format summary

SPX Express Tracking Data Schema & Taxonomy

The skill returns data organized into the following logical segments:

Segment Description
shipment Basic metadata: status, receiver name, and estimated delivery windows.
timeline Chronological grouped_events for display and raw_events for debugging.
geo_route Geographic data including current_full_address and GPS coordinates.
stay_analysis Duration in seconds between each logistical event.
bottleneck High-level insight identifying the segment where the package spent the most time.

SPX Express Tracking Advanced Features

  • Multi-format output support (JSON, Text, Summary) tailored for different AI agent interaction styles.
  • Bottleneck detection to automatically flag where a package is stalled in the supply chain.
  • Seamless Cainiao integration for Malaysian logistics, simplifying cross-platform tracking.
  • Support for authenticated requests via optional browser cookies for enhanced data retrieval.
  • Multi-lingual intent mapping supporting English and Chinese trigger phrases.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*