← Back to Skills Marketplace
charles-lpf

Cn Express Tracker

by charles-lpf · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
105
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install cn-express-tracker
Description
Query package tracking information from Chinese and international carriers using Kuaidi100 API. Supports auto-detection of carrier from tracking number. Use...
README (SKILL.md)

Express Tracker（快递物流查询）

Track packages from 200+ carriers (Chinese domestic + international) via Kuaidi100 API.

Setup (Required)

Users must obtain their own Kuaidi100 API credentials:

  1. Register at Kuaidi100 Open Platform

    • 注册企业版账号（个人也可注册）
    • Free tier: 100 queries/day after verification

  2. Get credentials from the Kuaidi100 Dashboard:

    • 授权 Key（API Key）: Found in 授权信息 → 授权key
    • Customer ID: Found in 授权信息 → customer

  3. Set environment variables:

    export EXPRESS_TRACKER_KEY="your_api_key_here"
export EXPRESS_TRACKER_CUSTOMER="your_customer_id_here"

    For persistent config, add to ~/.bashrc or ~/.zshrc:

    echo 'export EXPRESS_TRACKER_KEY="your_key"' >> ~/.zshrc
echo 'export EXPRESS_TRACKER_CUSTOMER="your_customer"' >> ~/.zshrc

Usage

# Auto-detect carrier and query
scripts/track.sh \x3Ctracking_number>

# Specify carrier manually
scripts/track.sh \x3Ctracking_number> \x3Ccarrier_code>

Examples

# Auto-detect (recommended)
scripts/track.sh 770308811947591

# Specify carrier explicitly
scripts/track.sh SF1234567890 shunfeng

How It Works

  1. Carrier auto-detection: Local rule-based matching by tracking number prefix/length/format
  2. API query: Sends signed request to Kuaidi100 poll API with resultv2=4 for advanced status
  3. Output: Formatted timeline with full tracking history (newest first)

Supported Carriers (Auto-Detection)

Prefix/Pattern Carrier Code
SF 顺丰速运 shunfeng
YT 圆通速递 yuantong
JT / J0 极兔速递 jitu
JD 京东快递 jd
CN 菜鸟速递 cainiao
DPK 德邦快递 debangkuaidi
KYE 跨越速运 kuayue
AN 安能物流 annengwuliu
1Z UPS ups
78/73/72/21/68 + digits 中通快递 zhongtong
10/11/12/13/19/46 + 13 digits 韵达快递 yunda
77/88/66/55/44 + 13-15 digits 申通快递 shentong
E + letter + 9 digits + 2 letters EMS ems

If auto-detection fails, specify the carrier code manually as the second argument.

Full carrier code list: Kuaidi100 Carrier Codes

Dependencies

  • curl — HTTP requests
  • jq — JSON parsing (install: brew install jq / apt install jq)
  • openssl or md5sum or md5 — MD5 signature (at least one required)

Error Codes

Code Meaning Action
400 Incomplete data / wrong carrier Check carrier code
408 Phone verification failed SF/ZTO require phone number
500 No tracking info found Verify tracking number and carrier
503 Signature verification failed Check API Key and Customer ID
601 API Key expired / no balance Recharge account

Agent Integration

When a user provides a tracking number, run:

EXPRESS_TRACKER_KEY="$KEY" EXPRESS_TRACKER_CUSTOMER="$CUSTOMER" scripts/track.sh \x3Cnumber>

Parse the output and present the tracking timeline to the user. If carrier detection fails, ask the user which carrier it is.

Usage Guidance
This skill’s code matches its stated purpose: it auto-detects a carrier and sends a signed HTTPS request to poll.kuaidi100.com. However, the package metadata omitted the fact that two API credentials are required — SKILL.md and scripts/track.sh do require EXPRESS_TRACKER_KEY and EXPRESS_TRACKER_CUSTOMER. Before installing or using: (1) verify the skill source and prefer running the included script locally rather than giving the agent persistent access to your secrets; (2) avoid pasting API keys into ~/.bashrc or ~/.zshrc — use ephemeral environment variables or a secrets manager if available; (3) confirm the API key/account on Kuaidi100 and limit its scope/balance; (4) if you plan to let the agent invoke the skill autonomously, be aware it will have network access to poll.kuaidi100.com and will use the provided API credentials for those calls. If the missing metadata (required env vars / primary credential) is fixed and you control the API keys, the skill appears coherent for tracking use — otherwise treat the metadata mismatch as a red flag and request the publisher correct it.
Capability Analysis
Type: OpenClaw Skill Name: cn-express-tracker Version: 1.0.0 The skill is a legitimate tool for tracking packages using the Kuaidi100 API. The bash script (scripts/track.sh) correctly implements the API's signing requirements, handles carrier auto-detection via regex, and communicates only with the official Kuaidi100 endpoint. No evidence of data exfiltration, malicious execution, or prompt injection was found; the use of environment variables for API keys is a standard and documented practice for this skill.
Capability Assessment
⚠ Purpose & Capability
The skill's name/description (Kuaidi100-based tracking) matches what the included script does: local carrier detection + signed POST to poll.kuaidi100.com. However, the registry metadata lists no required environment variables or primary credential while the SKILL.md and scripts/track.sh both require EXPRESS_TRACKER_KEY and EXPRESS_TRACKER_CUSTOMER. That metadata/instruction mismatch is an incoherence a user should notice.
⚠ Instruction Scope
SKILL.md and scripts/track.sh limit actions to local carrier-detection logic and a single HTTPS POST to poll.kuaidi100.com and JSON parsing; they do not access other system credentials or network endpoints. But the SKILL.md explicitly instructs users to persist API keys by appending exports to ~/.bashrc or ~/.zshrc, which encourages storing secrets in plaintext in shell startup files. The Agent Integration snippet references placeholders ($KEY / $CUSTOMER) not declared in registry metadata, another mismatch.
✓ Install Mechanism
This is an instruction-only skill with a bundled shell script; there is no install spec, no downloads, and no packages installed by the skill. It relies on standard local binaries (curl, jq, md5/openssl) which is proportionate to its purpose.
⚠ Credentials
The only secrets the skill needs (EXPRESS_TRACKER_KEY and EXPRESS_TRACKER_CUSTOMER) are appropriate for Kuaidi100 API access. However, the registry metadata claimed 'no required env vars' while the runtime instructions and script require two API credentials — this inconsistency reduces trust and should be corrected/clarified before use.
✓ Persistence & Privilege
The skill does not request permanent platform-level privileges (always:false) and does not modify other skills or system-wide agent settings. The only persistence recommended is optional user action to add exports to shell rc files (which is a user-facing suggestion, not an automated change).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cn-express-tracker
  3. After installation, invoke the skill by name or use /cn-express-tracker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of cn-express-tracker for querying package tracking information via the Kuaidi100 API. - Supports auto-detection of carrier from tracking number or manual carrier specification. - Tracks packages from over 200 Chinese and international carriers. - Requires user-provided Kuaidi100 API credentials (API Key and Customer ID) set via environment variables. - Outputs detailed tracking timeline; provides error code explanations and manual carrier override options. - Includes Bash script usage instructions and carrier code reference.
Metadata
Slug cn-express-tracker
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Cn Express Tracker?

Query package tracking information from Chinese and international carriers using Kuaidi100 API. Supports auto-detection of carrier from tracking number. Use... It is an AI Agent Skill for Claude Code / OpenClaw, with 105 downloads so far.

How do I install Cn Express Tracker?

Run "/install cn-express-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Cn Express Tracker free?

Yes, Cn Express Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Cn Express Tracker support?

Cn Express Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Cn Express Tracker?

It is built and maintained by charles-lpf (@charles-lpf); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments