Shipment Tracker

📦 智能识别承运商,混合模式查物流

物流追踪聚合工具,自动识别 USPS/FedEx/UPS 等 7 大承运商,支持 HTTP 直连与浏览器回退双模式,隐私敏感包裹建议手动查询。

收藏
6.2k
安装
1.3k
版本
1.1.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Shipment Tracker 是一款本地优先的物流追踪聚合工具,支持 USPS、UPS、FedEx、DHL、Amazon、OnTrac、LaserShip 七大主流承运商。其核心能力在于自动识别承运商——通过正则表达式匹配追踪号码特征(如 USPS 的 92/93/94/95 前缀、UPS 的 1Z 开头等),无需用户手动指定。

使用方式

工具采用「文件驱动」架构,用户维护 memory/shipments.md 表格记录待追踪包裹,执行脚本即可批量查询。支持 JSON 输出便于系统集成,也支持单号 --detect 快速识别。

技术实现亮点

混合查询策略是最大特色:
1. 直接 HTTP 模式:对 USPS 等结构简单的追踪页使用 urllib 抓取,零依赖、零延迟

2. 浏览器回退模式:对 UPS/FedEx/Amazon 等重度 JS 渲染页面,自动生成 browser-use 命令,通过云端浏览器获取动态内容

显著优点

  • 零配置上手:追踪号码自动关联承运商,无需 API Key
  • 隐私分级处理:明确区分「普通包裹可用云端浏览器」与「敏感包裹建议本地手动查询」
  • 可审计的工作流:markdown 表格作为单一数据源,易于版本控制与人工复核

潜在局限与风险

隐私隐患是首要关注点:browser-use 回退模式会将追踪号码、订单信息、收货相关元数据发送至第三方云服务(cloud browser + external LLM),尽管工具明确标注了隐私警告,但用户可能因便捷性而忽略此风险。

功能性局限:直接 HTTP 模式覆盖率有限,大量现代承运商站点依赖浏览器回退;后者又引入外部依赖与延迟。此外,CAPTCHA 对抗能力未明确说明,极端情况下可能失效。

运维成本:需维护正则表达式库以适应承运商格式变更,用户需手动清理已送达条目以保持文件整洁。

适合人群

  • 个人用户管理少量跨平台包裹(<20 个/月)
  • 对隐私有分级认知、能自主判断是否使用云端回退的技术用户
  • 需要将物流状态集成到本地工作流(如每日晨会简报)的自动化爱好者

安全等级评估

  • 数据泄露风险:browser-use 模式下中等(追踪号码+订单信息外传)
  • 权限控制:仅读取指定 markdown 文件与发起 HTTPS GET,无写权限、无命令执行
  • 供应链安全:依赖 browser-use 第三方库,需额外信任其云服务商

综合评级 A,建议敏感场景禁用浏览器回退。

Shipment Tracker 内容

scripts文件夹
手动下载zip · 8.4 kB
shipment_tracker.pytext/plain
请选择文件