A high-performance logistics tracking skill that connects to the Kuaidi100 API to monitor domestic Chinese and international shipments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install cn-express-tracker
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install cn-express-tracker 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 CN Express Tracker?
CN Express Tracker is a robust utility designed for the Openclaw Skills ecosystem, enabling AI agents to query real-time package tracking information. By leveraging the Kuaidi100 API, it provides access to over 200 carriers, including major Chinese players like SF Express, JD Logistics, and Cainiao, as well as international giants like UPS.
This skill is engineered for seamless agent interaction, allowing for automatic carrier detection based on tracking number patterns. Whether you are building a personal shopping assistant or a customer service bot, adding this to your Openclaw Skills library ensures users receive precise, up-to-date delivery timelines and logistics data without leaving the chat interface.
CN Express Tracker Use Cases
- Automatically monitoring the delivery status of online purchases from Chinese marketplaces.
- Integrating real-time logistics tracking into AI-driven customer support workflows.
- Consolidating tracking information for multiple international and domestic carriers into a single unified view.
- Verifying shipping progress for cross-border e-commerce shipments via EMS or UPS.
How CN Express Tracker Works
- The AI agent identifies a tracking number and optional carrier code from the user's request.
- The skill performs local rule-based matching to auto-detect the carrier based on length, prefix, and digit patterns.
- A signed HTTP request is sent to the Kuaidi100 Poll API using the provided API Key and Customer ID.
- The API returns the logistics lifecycle with advanced status flags enabled.
- The skill parses the JSON response using jq and outputs a formatted, chronological timeline for the user.
CN Express Tracker Setup
To use this within your Openclaw Skills environment, you must configure your API credentials:
- Register at the Kuaidi100 Open Platform to get your Key and Customer ID.
- Install system dependencies:
# For macOS
brew install jq
# For Ubuntu/Debian
sudo apt install jq curl
- Configure your environment variables:
export EXPRESS_TRACKER_KEY="your_api_key_here"
export EXPRESS_TRACKER_CUSTOMER="your_customer_id_here"
- Add these to your shell profile (
.zshrcor.bashrc) for persistent access.
CN Express Tracker Data Schema & Taxonomy
The skill processes tracking numbers and returns structured logistics data. The taxonomy includes:
| Attribute | Description |
|---|---|
tracking_number |
The primary identifier for the shipment. |
carrier_code |
Unique identifier for the logistics provider (e.g., shunfeng, jd). |
status |
Current state of the package (e.g., in transit, delivered). |
context |
The specific location and description for each timeline event. |
time |
ISO-formatted timestamps for each status update. |
CN Express Tracker Advanced Features
- Advanced status detection using
resultv2=4for more granular delivery insights. - Automated carrier identification for 13+ major patterns including SF, JD, and ZTO.
- Multi-platform support for both enterprise and individual Kuaidi100 accounts.
- Detailed error handling for common logistics issues like phone number verification (required by SF/ZTO).
SKILL.md
Loading
Related Openclaw Skills
Mysteel Bid & Supply Query
A specialized tool for steel industry professionals to query real-time supply-demand data and historical bidding information.
Memory-Driven Execution Loop
A deterministic execution framework that forces AI agents to operate exclusively through external memory state files for maximum reliability.
Model Pricing Calculator
A specialized tool for fetching, unifying, and calculating standardized pricing ratios across multiple AI model providers and API platforms.
360 Power Saver
An intelligent power management skill that provides one-click energy optimization, deep battery health analysis, and real-time consumption diagnostics.
JP Funda
A powerful financial data integration for researching and evaluating Japanese companies and securities reports.
Dajiala WeChat Article Fetcher
A specialized automation tool for fetching WeChat Official Account article links and metadata via the Dajiala API and exporting them to Excel.
Featured*
