mcpField
P
parcel-tracking

parcel-tracking

github.com/jezweb生产力1.1k984 次安装3 周前更新
代码仓库

关于 parcel-tracking

parcel-tracking 是一项从 Gmail 发货邮件中查找运单号、查询澳大利亚及国际承运商配送进度的技能。它可识别承运商并生成追踪链接，也能在有网页工具时尝试获取实时状态。

主要功能

  1. 01搜索发货邮件中的运单号
  2. 02根据号码或邮件信息识别承运商
  3. 03生成承运商专属追踪链接
  4. 04使用可用网页工具查询实时状态
  5. 05一次处理多个包裹

适用场景

  1. 01查找近期订单的运单号
  2. 02查询不同承运商的配送进度
  3. 03仅有运单号时追踪包裹

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jezweb/claude-skills --skill parcel-tracking

安装后在 Claude Code 中输入/parcel-tracking确认已加载。

详细介绍

包裹追踪

从 Gmail 发货邮件中查找追踪号码，并查询澳大利亚及国际承运商的配送状态。

适用场景

  • “我的包裹 / 订单到哪儿了？” -“我的 [产品] 到货了吗 / 发货了吗？”
  • “追踪我在 [商店] 下的订单”
  • “我的配送状态如何？”
  • “[商品] 有追踪号码吗？”
  • 用户粘贴或提及追踪号码
  • “查询 StarTrack / AusPost / Aramex / Toll 的追踪信息”

工作流

第 1 步：查找追踪号码

如果用户已提供追踪号码，请跳至第 2 步。

否则，搜索 Gmail 中的发货邮件。查找近期符合以下条件的邮件：

dispatched OR shipped OR "tracking number" OR "consignment number" newer_than:30d

如需查找特定商店或订单，可缩小搜索范围：

from:mwave.com.au dispatched
from:amazon.com.au shipped

阅读邮件正文并提取：

  • 追踪 / 托运号码
  • 承运商名称
  • 订单号
  • 发货日期
  • 配送备注（是否需要签收等）

Gmail 访问权限：使用可用的任何 Gmail 工具（Gmail MCP、gws CLI gws gmail），或请用户手动查看并粘贴追踪号码。

第 2 步：识别承运商并构建追踪链接

使用下表，根据追踪号码格式或发货邮件识别承运商，然后尽可能构建直接追踪链接。

承运商号码格式 / 示例直接追踪链接
AusPost / StarTrack字母数字组合，例如 36VJ65064757、JD123456789AUhttps://auspost.com.au/mypost/track/details/{NUMBER}
Sendle6-8 位字母数字组合，例如 SNFJJ3https://track.sendle.com/tracking?ref={NUMBER}
DHL10-12 位数字，例如 1234567890https://www.dhl.com/au-en/home/tracking.html?tracking-id={NUMBER}
FedEx12-15 位数字，或 AU+10 位数字https://www.fedex.com/apps/fedextrack/?tracknumbers={NUMBER}
TNT（现为 FedEx）9 位数字，例如 907384999https://www.tnt.com/express/en_au/site/shipping-tools/tracking.html（粘贴号码）
UPS以 1Z 开头，共 18 个字符https://www.ups.com/track?tracknum={NUMBER}
Aramex（前身为 Fastway）数字标签号码，格式不一https://www.aramex.com.au/tools/track（粘贴号码）
CouriersPlease数字或以 CP 开头https://www.couriersplease.com.au/tools-track（粘贴号码）
Toll / MyToll数字托运号码，格式不一https://mytoll.com/（粘贴号码）
Team Global Express数字，格式不一https://myteamge.com/（粘贴号码）
Hunter Express字母数字组合，例如 AIM478695https://www.hunterexpress.com.au/tracking/（粘贴号码）
Border Express数字，格式不一https://www.borderexpress.com.au/tracking/（粘贴号码）
Direct Freight Express数字托运号码https://www.directfreight.com.au/ConsignmentStatus.aspx（粘贴号码）

深层链接（追踪号码包含在 URL 中）：AusPost/StarTrack、Sendle、DHL、FedEx、UPS。

表单查询（分别提供链接和号码）：Aramex、CouriersPlease、Toll、Team Global Express、Hunter Express、Border Express、Direct Freight Express、TNT。

**如果无法确定承运商：**默认使用 AusPost（澳大利亚最常见），或请用户查看发货邮件。

第 3 步：尝试获取实时状态

如果有网页抓取工具可用，尝试抓取追踪页面：

url: {direct tracking URL}
wait_for: 3000 (many tracking pages are JS-rendered)

许多追踪页面在被抓取时返回的数据有限。AusPost 的页面尤其依赖 JS。如果抓取到有用的状态信息，请将其纳入回复；如果没有，只需提供直接链接。不要向用户提及抓取失败。

如果有浏览器自动化工具可用（Chrome MCP、Playwright），请打开追踪页面并直接读取状态。

如果没有网页抓取或浏览器工具可用，请跳过此步骤并提供链接。

第 4 步：呈现结果

始终包含：

  1. 当前状态（如果有抓取结果，则使用抓取结果；否则使用发货邮件中的信息）
  2. 直接追踪链接（始终提供）
  3. 预计配送时间范围（如果已知）
  4. 配送备注（需要签收、凭卡领取等）
示例：使用深层链接的承运商
Order IN03069870 — Mac mini x 2
Dispatched by Mwave via AusPost/StarTrack on 17 Mar

Tracking: 36VJ65064757
Status: In transit — processed at Sydney sorting facility
Expected: Thu 19 – Fri 20 Mar
Note: Signature required. If no one home, parcel goes to local post office.

Track live: https://auspost.com.au/mypost/track/details/36VJ65064757
示例：表单式承运商
Order 12345 — [item]
Dispatched via Toll on 15 Mar

Consignment: TXY9876543
Expected: 3-5 business days

Track at: https://mytoll.com/
Paste consignment number: TXY9876543
处理多个包裹

广泛搜索：

(dispatched OR shipped OR "on its way" OR "tracking number") newer_than:30d

将每个包裹作为单独的区块呈现。

承运商联系电话（澳大利亚）

承运商电话服务时间（AEST/AEDT）
AusPost / StarTrack eParcel13 13 18周一至周五 8am-6pm
StarTrack（账户客户）13 23 45工作时间
CouriersPlease13 00 36 16工作时间
Toll Priority13 15 31周一至周五 7am-10pm，周六至周日 7am-5pm
Toll IPEC1300 865 547工作时间
Hunter Express02 9780 4099工作时间
DHL13 14 06工作时间
FedEx / TNT13 26 10工作时间
UPS13 26 77工作时间
Aramex请参阅 aramex.com.au/contact-us工作时间
Sendle仅在线（支持表单）—
Team Global Expressmyteamge.com 联系表单—

承运商专属说明

AusPost / StarTrack

  • URL 格式：https://auspost.com.au/mypost/track/details/{TRACKING_NUMBER} — 跟踪号码直接放在路径中
  • 对于区域配送，在悉尼（Lidcombe/Chullora）处理后跟踪事件较少属于正常情况
  • 发货后最多等待 24 小时，跟踪信息才会显示
  • 需要签名的包裹若无法投递，将送至当地邮局

Sendle

  • Sendle 于 2025 年初停止所有包裹揽收，并引导客户改用 Aramex。现有 Sendle 货件仍可查询。
  • 深层链接：https://track.sendle.com/tracking?ref={SENDLE_REFERENCE}

Toll 与 Team Global Express

  • Toll Global Express 已被出售并更名为 Team Global Express — 两者使用不同的跟踪系统
  • 国内 Toll 包裹（IPEC、Priority、Express）仍使用 MyToll

工具灵活性

此技能可与任何可用工具配合使用：

工具功能
Gmail 访问权限（任何 MCP 或 CLI）搜索发货邮件中的跟踪号码
网页抓取工具（任何 MCP）尝试从跟踪页面获取实时状态
浏览器自动化（Chrome MCP、Playwright）浏览跟踪页面以获取由 JS 渲染的状态
以上工具均不可用用户提供跟踪号码，技能提供正确链接

评论

支持 Markdown