用途:帮助用户查询国际包裹物流状态,例如回答“我的包裹在哪里”、查看运输进度或清关情况,支持一次追踪多个包裹。
主要能力:track_package 查询单个包裹,输入 trackingNumber(必填)、carrier(可选)、language(en/zh),返回状态、当前位置和事件时间线;detect_carrier 根据单号格式识别承运商并给出置信度;batch_track 一次最多查询40个包裹;explain_status 将状态码(如 InTransit、CustomsClearance)转换为中英文说明与建议。支持中国邮政、中国EMS、燕文、菜鸟、顺丰、UPS、USPS、DHL、FedEx 等20多家承运商。
使用方式:技能需配合配套 MCP 服务器使用,在 MCP 配置中加入 logistics-tracking 服务器,命令为 npx,参数为 -y @shopme/logistics-tracking-mcp,并通过环境变量 TRACK17_API_KEY 提供密钥;密钥可在 https://api.17track.net 免费获取。资料提供单号格式示例:XX123456789CN 为中国邮政、EX123456789CN 为中国EMS、YT加16位数字为燕文、LP加14位以上为菜鸟、SF加12位以上为顺丰、1Z加16字符为UPS、94/93/92加20位为USPS、10-11位为DHL、12-15位为FedEx。
适用场景:跨境购物物流查询、清关异常判断、多包裹批量跟踪、向用户解释物流状态含义。资料还列出参考时效(如中国到美国标准15-30天、快递5-10天)和状态码含义(InfoReceived、InTransit、CustomsClearance、OutForDelivery、Delivered、Exception、Returned)。
限制:未设置 TRACK17_API_KEY 时会回退到 RTB56,准确性有限;建议发货后24-48小时再首次查询;同一单号查询间隔不超过每2小时一次以避免限流;批量查询多包裹更高效。时效为典型参考,实际以承运商为准。