📦 Ship24 Order Tracking — Ship24 Order 追踪ing

将 Claude 接入 Ship24——覆盖全球 2,500+ 快递与电商平台的通用物流追踪 API。

配置

• 注册并在 Ship24 控制台获取 API key
• 在 .mcp.json 添加 Ship24 MCP server：

{ "mcpServers": { "ship24-api": { "type": "http", "url": "https://api.ship24.com/mcp", "headers": { "Authorization": "Bearer ${SHIP24_API_KEY}" } } } }

• 设置环境变量：SHOP24_API_KEY=your_api_key_here

可用工具 track 创建持久追踪器并立即返回完整追踪结果（事件、状态、里程碑）。幂等，可多次调用同一单号。

create_tracker 注册追踪器以接收 webhook 通知，仅返回追踪器元数据；用 get_tracking_results 获取事件与状态。

bulk_create_trackers 一次最多注册 100 个追踪器，返回创建、重复、失败计数。非完全幂等，重试可能部分创建。

get_tracker 用 trackerId 或 clientTrackerId 获取追踪器元数据，不含事件与派送状态。

update_tracker 部分更新追踪器（PATCH）。常见用途：开关 webhook 订阅、修正目的地、设置 clientTrackerId。

list_trackers 分页列出账户下所有追踪器。

get_tracking_results 获取追踪器的完整事件与派送状态，返回状态里程碑如 in_transit、delivered、out_for_delivery、exception 等。

search_tracking 单次查询，不创建持久追踪器，按次计费。

search_tracking_by_number 无需 trackerId，直接按原始单号跨所有快递查询。

get_couriers 获取全部 2,500+ 支持的快递列表及其代码、必填字段，限流 1 次/秒。

resend_webhooks 重放某追踪器的全部 webhook 事件（用于漏收通知），每追踪器限流 1 次/秒。

关键概念 trackerId vs clientTrackerId：trackerId 为 Ship24 内部 ID；clientTrackerId 为你的自定义参考（订单号等），可在创建或 update_tracker 时设置，后续在 get_tracker、update_tracker、resend_webhooks 中通过 searchBy: "clientTrackerId" 使用。

track vs create_tracker：立即要结果用 track；需要 webhook 监控用 create_tracker。

search_tracking vs track：search_tracking 按次计费且无持久追踪器；track 会在账户内创建追踪器。

示例提示 “追踪包裹 1Z999AA10123456784” “为 JD014600006600006810 创建到法国的追踪器” “不建追踪器，查 RA123456785CN 在哪” “批量为这 5 个单号创建追踪器：…” “列出我所有活跃追踪器” “将追踪器 abc123 改为订阅 webhook” “获取追踪器 abc123 的完整历史” “从中国发货支持哪些快递？” “重发追踪器 abc123 的全部 webhook 事件”