jisu-express

What This Skill Does

The Jisu Express (jisu-express) skill is a powerful utility integrated into the OpenClaw AI framework, designed to provide real-time logistics tracking for packages. By leveraging the Jisu API, this skill allows users to retrieve detailed shipment histories, current transit status, and delivery confirmation status. It features advanced capabilities like automatic courier identification and specific support for sensitive carriers such as SF Express, ZTO, and Kuaiyue, which require the last four digits of the recipient's or sender's phone number for authentication.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/jisuapi/express

Ensure that you have an active Jisu API key. Configure it in your environment variables using export JISU_API_KEY="your_appkey_here" on Linux/macOS or via PowerShell on Windows. Without a valid API key, the skill will return an authentication error.

Use Cases

This skill is ideal for personal assistant workflows or logistics management automation. Whether you are tracking a single e-commerce purchase or monitoring multiple shipments for your business, jisu-express simplifies the process by converting raw API data into human-readable status summaries. It is particularly useful for handling complex tracking scenarios where a carrier code isn't known, or when dealing with premium carriers that mandate phone number verification.

Example Prompts

1. "Check the status of my package with tracking number 70303808964270, please identify the courier automatically."
2. "Track my Yunda Express package 4303200322000 and tell me if it has been signed for yet."
3. "Look up my SF Express shipment 931658943036, the last four digits of my phone number are 1234."

Tips & Limitations

• Automatic Identification: While the 'auto' feature is convenient, specifying the courier (e.g., 'sfexpress', 'yunda') often leads to faster and more accurate results.
• Phone Verification: Always remember to include the 'mobile' parameter for carriers that require identity verification, otherwise the API will return a 220 error.
• Rate Limits: Be mindful that your API key may have request limits based on your Jisu account plan. Excessive querying may lead to temporary blocks.
• Data Structure: The output is a raw JSON object; ensure your downstream agent logic is prepared to handle fields like 'deliverystatus' and 'issign' to provide the best user experience.