A professional MCP-based logistics tracker supporting 3100+ global carriers with both API and headless browser fallback modes.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install logistics-tracking
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 logistics-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 Logistics Tracking?
Logistics Tracking is a high-performance skill designed for AI agents to monitor international shipments in real-time. By connecting to the 17track ecosystem, this tool provides comprehensive data across a vast network of over 3100 carriers, including specialized providers like Yanwen and Cainiao as well as global giants like UPS and DHL. As a core component of the Openclaw Skills library, it allows developers to build agents capable of answering complex delivery queries, explaining customs statuses, and managing high-volume package monitoring.
The skill is built as an Model Context Protocol (MCP) server, offering flexibility in deployment. Developers can choose between a highly reliable API-driven approach using a 17track key or a zero-config fallback using Playwright for headless browser scraping. This versatility makes it an essential tool for e-commerce automation and personal productivity workflows.
Logistics Tracking Use Cases
- Automating responses to "where is my package" queries in customer support bots.
- Monitoring high-volume international shipments for e-commerce businesses.
- Tracking personal deliveries across multiple carriers through a single AI interface.
- Providing real-time alerts for customs clearance issues or delivery exceptions.
How Logistics Tracking Works
- The AI agent identifies a tracking number within a user's prompt.
- The skill utilizes the
detect_carriertool to determine the logistics provider based on number patterns. - The MCP server initiates a query to the 17track platform using either a provided API key or a headless Chromium instance via Playwright.
- Real-time logistics data, including current location and status history, is fetched and parsed.
- The agent uses the
explain_statustool to translate technical logistics codes into human-readable updates for the end user.
Logistics Tracking Setup
To integrate this capability into your environment using Openclaw Skills, run the following command:
npx skills add shopmeskills/mcp
For local configuration with an API key, update your MCP settings file:
{
"mcpServers": {
"logistics-tracking": {
"command": "npx",
"args": ["-y", "@shopmeagent/logistics-tracking-mcp"],
"env": {
"TRACK17_API_KEY": "your-17track-api-key"
}
}
}
}
Logistics Tracking Data Schema & Taxonomy
The skill organizes logistics data into structured objects for easy agent consumption. Key data points include:
| Data Point | Description |
|---|---|
| trackingNumber | The unique identifier for the shipment. |
| carrier | The detected logistics provider (e.g., FedEx, China Post). |
| statusCode | Standardized status (InTransit, Delivered, Exception). |
| timeline | A chronological list of events with timestamps and locations. |
| confidence | The reliability score of the carrier detection algorithm. |
Logistics Tracking Advanced Features
- Multi-mode operation allowing for both authenticated API access and keyless Playwright fallback.
- Batch processing capabilities to track up to 40 tracking numbers in a single request.
- Intelligent carrier auto-detection supporting over 3100 global logistics providers.
- Human-readable status mapping to clarify complex international shipping terminology.
- Seamless integration with Openclaw Skills for rapid agent deployment.
SKILL.md
Loading
Related Openclaw Skills
Chinese E-commerce Product Search
A zero-config AI agent skill for searching, comparing, and retrieving product details across 8 major Chinese e-commerce platforms.
QuorumAI
A multi-model AI synthesis tool that aggregates responses from four major LLMs to provide a single, arbitrated best answer.
vydra
A unified API for AI-powered image generation, video creation, and voice synthesis across multiple leading models.
Moltboard Art
A collaborative pixel canvas where AI agents create art together, inspired by Reddit's r/place but built specifically for machines.
Map Search Skill
A unified map aggregation tool that enables AI agents to search for locations and nearby points of interest using Amap, Baidu, and Tencent Maps.
1Password CLI Skill
Securely manage, inject, and run secrets using the 1Password CLI within managed terminal environments.
Featured*
