查顺丰物流、比服务类型、估算运费时效，并对停滞或异常件做买家卖家分诊。
26 次安装
编程
SPX Express Tracking
试用Query SPX Express shipment tracking by tracking number. Call this skill when the user mentions a tracking number matching the SPX format (CNMY..., SPXMY...),...
它能做什么
Query SPX Express shipment tracking by tracking number. Call this skill when the user mentions a tracking number matching the SPX format (CNMY..., SPXMY...),...
技能文档
SPX Express Tracking
Query SPX Express (spx.com.my) shipment tracking and return structured results.
Invocation
python skills/spx-tracking/scripts/spx_tracking.py [--format json|text|summary] [--cookie "..."] [--timeout 15]
Arguments
| Argument | Description |
|---|---|
tracking_number | SPX tracking number (format: CNMY..., SPXMY...) |
--format | json (default) — structured data; text — human-readable; summary — one-line status |
--cookie | Browser cookie for authenticated requests (optional, sensitive — contains session data, never log or echo to user) |
--timeout | Request timeout in seconds (default: 15) |
Dependencies
The run script auto-creates a venv and installs requests on first use. Manual install:
pip install -r requirements.txt
Output Format Detail
--format json(default) — Full JSON.retcodeis at the top level. Agent checksretcode == 0for success; non-zero means API error.--format text— Human-readable sections: status block, timeline, delay analysis, geo route.--format summary— Single-line:[] status: | last update: | est. delivery: ~.
Response Schema
| Field | Contents |
|---|---|
retcode | 0 = success; non-zero = API error (check response.message) |
response | API-level status message and detail |
shipment | Core info: tracking_number, status, receiver_name, edd_min, edd_max, first_event_time, last_event_time |
timeline.grouped_events | Chronological events, deduplicated (use for display) |
timeline.raw_events | All raw events (use for debugging) |
geo_route | Events with GPS: current_lng, current_lat, current_full_address |
stay_analysis | Time between consecutive events (duration_seconds) |
bottleneck | The longest stay segment — where the package stalled |
Intent → Action Mapping
| Observed user intent | Recommended format |
|---|---|
| User provides a SPX tracking number (CNMY..., SPXMY...) | --format summary → one-liner reply |
| "快递到哪了" / "where is my package" / "parcel status" | --format json → status + last_event_time + last location |
| "预计什么时候到" / "when will it arrive" / "ETA" | --format json → edd_min ~ edd_max |
| "快递卡住了" / "is it stuck" / "delay" | --format json → bottleneck section |
| "完整物流" / "full details" / "tracking history" | --format text → full human-readable report |
Usage Constraints
- SPX Express (spx.com.my) and CAINIAO (菜鸟 / 菜鸟集运): This skill covers both SPX Direct and CAINIAO Smart Logistics tracking numbers used in the Malaysia region. CAINIAO's last-mile carrier in Malaysia is SPX Express, so CAINIAO numbers are queryable via this same API.
- Tracking number format: SPX numbers start with
CNMYorSPXMY. CAINIAO numbers may have different prefixes but can be searched directly if the user identifies them as CAINIAO/菜鸟/菜鸟集运. - Do NOT use for: J&T, Pos Laju, DHL, FedEx, UPS, Ninja Van, or any other courier.
- Privacy: Never output the raw API response body. Only use the structured fields described above.
相关技能
Use Cainiao Network (菜鸟物流) for shipment tracking, shipping guidance, service-type comparison, outlet lookup, and delivery-time or fee estimation.
17 次安装
Use J&T Express (极兔速递) for shipment tracking, shipping guidance, service-type comparison, outlet lookup, and delivery-time or fee estimation.
17 次安装
Monitor package logistics status and identify delivery anomalies such as delays, stalls, returns, failed delivery, customs/security holds, or abnormal signin...
21 次安装
Use JD Logistics (京东快递) for shipment tracking, shipping guidance, service-type comparison, outlet lookup, and delivery-time or fee estimation.
18 次安装
通过单一 MCP 连接获取多承运商实时运费、校验地址,并购买国内或国际运单。
26 次安装2 星标