核心功能与用法
Logistics Tracking 是一款基于 17track 平台的国际物流查询 MCP 技能，提供三种核心能力：
- `track_package`: 单号实时追踪，自动识别承运商
- `detect_carrier`: 通过单号格式智能匹配物流商
- `batch_track`: 批量查询（最多40单），适合商家批量管理
- `explain_status`: 物流状态码解读，帮助用户理解清关、异常等场景
支持 3100+ 全球物流商，覆盖 China Post、DHL、FedEx、UPS、Yanwen、Cainiao 等主流渠道，并提供中英双语状态说明。
部署方式
| 模式 | 配置要求 | 适用场景 |
|------|----------|----------|
| HTTP 服务 | 服务端配置 `TRACK17_API_KEY` | 企业/多用户共享，终端零配置 |
| 本地 stdio + API Key | 用户自配 Key | 个人高频使用，稳定性最佳 |
| 本地 stdio 零配置 | 依赖 Playwright 浏览器模拟 | 临时使用，无需申请 Key |
推荐方案：申请免费 17track API Key（https://api.17track.net）以获得最佳可靠性；无 Key 时通过 Playwright 模拟浏览器访问，存在性能与稳定性折损。
显著优点
1. 覆盖极广：3100+ 承运商，远超多数单一平台 API
2. 智能识别：自动解析单号格式匹配物流商，降低用户认知成本
3. 批量高效：单次最多40单，适合电商卖家、代购等场景
4. 状态解读：内置 explain_status 工具，将 "CustomsClearance" 等代码转化为可操作建议
5. 双模式降级：API 故障时可通过 Playwright 兜底，增强鲁棒性
潜在局限与风险
- 数据延迟：物流商回传存在 24-48 小时滞后，发货当日常无数据
- 速率限制：同一单号需间隔 2 小时查询，高频轮询可能触发限制
- Playwright 依赖：零配置模式需安装 Chromium（~150MB），首次运行耗时较长
- 清关不确定性：海关状态依赖各国邮政系统，更新粒度不一
- 隐私暴露：单号可能隐含订单信息，批量查询需注意数据合规
适合人群
- 跨境电商平台运营（批量追踪发货）
- 海淘/代购用户（多平台订单聚合查询）
- 独立站卖家（客户服务与物流异常监控）
- 物流异常排查（结合
explain_status诊断问题）
常规风险提示
- 清关延误属不可抗力，工具仅提供状态展示无干预能力
- 建议发货 48 小时后发起首次查询，避免空数据
- 敏感商业单号避免在共享 HTTP 服务端明文传输