parcel-kau-alisted

Track Taiwan parcel deliveries by tracking number. Use when the user asks about a package's delivery status, shipping progress, or where a parcel is — including phrases like 查包裹, 包裹進度, 貨態, 到了沒, tracking, or when they paste a Taiwanese courier tracking number. Also use when the user asks which of their parcels are still on the way rather than about one specific number — 還有哪些包裹在路上, 哪些包裹還沒到, 未結案包裹, 我的包裹清單 — which is answered from the local query history without contacting any courier. When they instead want the live, right-now status of everything still pending — 幫我更新一下未結案包裹, 未結案的都查一下最新進度, 全部包裹現在到哪了 — that live-queries each one instead of reading the snapshot. Supports 黑貓宅急便 (T-cat), 嘉里大榮 (Kerry TJ), 台灣宅配通 (e-can), 網家速配 (PChome Express), 富昇物流／momo 自營 (Fusheng), and 蝦皮店到店 (Shopee SPX). 中華郵政, 全家, 7-11 交貨便, and 新竹物流 cannot be read directly (CAPTCHA) but are reachable via 17TRACK if the user supplies their own API key.
AugustusW/parcel-kau-a · ★ 2 · AI & Automation · score 73

Install: claude install-skill AugustusW/parcel-kau-a

# parcel-kau-a 輸入台灣包裹單號，回配送時間軸。無需 API key。 ## 用法 macOS / Linux 用 `python3`；**Windows 要用 `python`**（`python3` 在 Windows 是 Microsoft Store 的捷徑，直接執行會回 9009「Python was not found」）。 ```bash python3 scripts/track.py <單號> # 自動判別貨運公司 python3 scripts/track.py <單號> --carrier tcat # 指定（建議：省下無謂請求） python3 scripts/track.py <單號> --json # 機器可讀輸出 python3 scripts/track.py --pending # 只列尚未結案的包裹（不連線） python3 scripts/track.py --refresh-pending # 對每筆未結案包裹即時查詢，回報彙整摘要 python3 scripts/track.py --history # 列出查詢紀錄（含已完成） python3 scripts/track.py --forget <單號> # 刪除某筆紀錄 python3 scripts/track.py --endpoints # 列出目前生效的查詢網址 ``` Windows（PowerShell）： ```powershell python scripts\track.py <單號> --carrier tcat python scripts\track.py --pending ``` `--carrier` 可用值：`tcat`（黑貓）、`kerrytj`（嘉里大榮）、`ecan`（宅配通）、`pchome`（網家速配）、`fusheng`（富昇/momo）、`spx`（蝦皮店到店）。 ## 判別規則黑貓、嘉里大榮、宅配通、網家速配、富昇的單號同為 12 碼數字，**格式無法區分**——不指定 `--carrier` 時會依序查詢、命中即停（最壞 5 次請求）。蝦皮 SPX 為 `TW` 開頭，可由格式判定。 **使用者若提到貨運公司名稱，請務必帶上 `--carrier`。** ## 支援範圍 | 貨運 | code | 方式 | |------|------|------| | 黑貓宅急便 | `tcat` | HTTP（資料保留 3 個月） | | 嘉里大榮 | `kerrytj` | HTTP JSON API | | 台灣宅配通 | `ecan` | HTTP（資料保留 2 個月） | | 網家速配 | `pchome` | HTTP（PChome 自營車隊） | | 富昇物流（momo） | `fusheng` | HTTP（momo 自營配送） | | 蝦皮店到店 | `spx` | 需 Playwright（見下） | **直連不支援**：中華郵政、全家店到店、7-ELEVEN 交貨便、新竹物流 —— 這四家的查詢頁都有圖形驗證碼，本 skill 不做驗證碼破解。 ## 17TRACK（選配，補上述四家）使用者自備 API key，設在環境