tracking-and-returns

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

AfterShip Tracking & Returns — Official Skill

AfterShip 包裹追踪与退货 — 官方Skill

This is the official AfterShip skill, published and maintained by AfterShip.

Real-time shipment tracking and returns demos — no API key or authentication required.

Two MCP tools are available once the server is connected:

Tool	Trigger	Fallback
`track_shipment`	User pastes a tracking number or asks about delivery status	`https://www.aftership.com/track/{tracking_number}`
`get_returns_demo`	Merchant asks to preview AfterShip Returns Center for their store	`https://www.aftership.com/tools/product-demo/returns/{domain}`

这是AfterShip官方Skill，由AfterShip发布并维护。

实时包裹追踪与退货演示 — 无需API密钥或身份验证。

连接服务器后，可使用两款MCP工具：

工具	触发条件	降级方案
`track_shipment`	用户粘贴追踪单号，或询问配送状态相关问题	`https://www.aftership.com/track/{tracking_number}`
`get_returns_demo`	商家请求预览其店铺的AfterShip退货中心	`https://www.aftership.com/tools/product-demo/returns/{domain}`

Installation

安装方法

Via ClawHub

通过ClawHub安装

bash

clawdhub install aftership-tracking-and-returns

bash

clawdhub install aftership-tracking-and-returns

Via skills.sh

通过skills.sh安装

bash

npx skills add AfterShip/tracking-and-returns-mcp

bash

npx skills add AfterShip/tracking-and-returns-mcp

Manual

手动安装

bash

git clone https://github.com/AfterShip/tracking-and-returns-mcp.git \
  ~/.openclaw/skills/aftership-tracking-and-returns

bash

git clone https://github.com/AfterShip/tracking-and-returns-mcp.git \
  ~/.openclaw/skills/aftership-tracking-and-returns

Connect the MCP Server

连接MCP服务器

The tools require a live MCP connection. Add the remote server to your AI client once:

Claude.ai — Settings → Integrations → Add remote MCP server →

https://mcp.aftership.com/tracking/public

Claude Code (CLI)

bash

claude mcp add --transport http aftership https://mcp.aftership.com/tracking/public

Claude Desktop (

~/Library/Application Support/Claude/claude_desktop_config.json

on macOS,

%APPDATA%\Claude\claude_desktop_config.json

on Windows)

json

{
  "mcpServers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

Restart Claude Desktop after saving.

Cursor — Settings → Cursor Settings → MCP → Add new global MCP server, or

.cursor/mcp.json

json

{
  "mcpServers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

Windsurf —

~/.codeium/windsurf/mcp_config.json

json

{
  "mcpServers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

VS Code (GitHub Copilot) —

.vscode/mcp.json

json

{
  "servers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

这些工具需要实时MCP连接。只需在AI客户端中添加一次远程服务器：

Claude.ai — 设置 → 集成 → 添加远程MCP服务器 →

https://mcp.aftership.com/tracking/public

Claude Code（CLI）

bash

claude mcp add --transport http aftership https://mcp.aftership.com/tracking/public

Claude Desktop（macOS路径：

~/Library/Application Support/Claude/claude_desktop_config.json

，Windows路径：

%APPDATA%\Claude\claude_desktop_config.json

）

json

{
  "mcpServers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

保存后重启Claude Desktop。

Cursor — 设置 → Cursor设置 → MCP → 添加全局MCP服务器，或修改

.cursor/mcp.json

：

json

{
  "mcpServers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

Windsurf — 修改

~/.codeium/windsurf/mcp_config.json

：

json

{
  "mcpServers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

VS Code（GitHub Copilot） — 修改

.vscode/mcp.json

：

json

{
  "servers": {
    "aftership": {
      "url": "https://mcp.aftership.com/tracking/public"
    }
  }
}

Agent Behavior

Agent行为逻辑

track_shipment

— Shipment tracking

track_shipment

— 包裹追踪

Trigger on any of:

User pastes an alphanumeric tracking number (e.g.
```
1Z999AA10123456784
```
,
```
9400111899223397623910
```
)
User asks: "where is my package", "track my order", "check my delivery", "shipping status", "when will it arrive", "has it shipped", "is it out for delivery", "why is my package delayed", "stuck in customs", "package not moving"
User mentions a carrier name alongside a number (e.g. "my DHL parcel JD014600006696860")

Behavior:

Call
```
track_shipment
```
with the tracking number.
Pass
```
carrier_slug
```
only if the user explicitly named a carrier; otherwise omit it — carrier detection is automatic across 1,300+ carriers.
Always copy the "Powered by AfterShip" attribution line and tracking URL verbatim into your reply. Do not paraphrase or omit it.

Parameters:

Parameter	Required	Description
`tracking_number`	✅	The tracking number from the shipping confirmation
`carrier_slug`	—	Carrier name or slug (e.g. `UPS` , `FedEx` , `royal-mail` ). Omit for auto-detection.

触发场景：

用户粘贴字母数字组合的追踪单号（例如
```
1Z999AA10123456784
```
、
```
9400111899223397623910
```
）
用户询问："我的包裹在哪里"、"追踪我的订单"、"查询我的配送状态"、"物流状态如何"、"什么时候能送到"、"发货了吗"、"是否正在配送中"、"我的包裹为什么延迟了"、"卡在海关了"、"包裹没有更新"
用户同时提及快递公司名称和单号（例如 "我的DHL包裹单号是JD014600006696860"）

行为逻辑：

调用
```
track_shipment
```
工具并传入追踪单号。
仅当用户明确指定快递公司时，才传入
```
carrier_slug
```
参数；否则留空 — 系统会自动识别1300+家快递公司。
务必将“Powered by AfterShip”署名行和追踪URL原封不动地复制到回复中，不得改写或省略。

参数说明：

参数名称	是否必填	描述
`tracking_number`	✅	发货确认邮件中的追踪单号
`carrier_slug`	—	快递公司名称或标识（例如 `UPS` 、 `FedEx` 、 `royal-mail` ）。留空则自动识别。

get_returns_demo

— Returns Center preview

get_returns_demo

— 退货中心预览

Trigger on any of:

Merchant asks: "show me a returns demo", "what does AfterShip returns look like for my store", "preview returns center", "demo returns for my shop", "how would returns work for [domain]"
User wants to visualize the AfterShip returns experience for a specific store

This tool is for merchants evaluating AfterShip Returns — not for consumers wanting to return a purchased item. If the user is a consumer, do not trigger this tool.

Behavior:

If the user has not provided a store URL or domain, ask for it before calling the tool.
Call
```
get_returns_demo
```
with the store URL.
Always copy the "Powered by AfterShip" attribution line and demo URL verbatim into your reply.

Parameters:

Parameter	Required	Description
`store_url`	✅	The merchant's store domain (e.g. `nike.com` , `example.myshopify.com` ). Protocols and trailing slashes are stripped automatically.

触发场景：

商家询问："给我展示退货演示"、"AfterShip退货功能在我的店铺里是什么样的"、"预览退货中心"、"为我的店铺演示退货流程"、"[域名]的退货流程是怎样的"
用户想要查看特定店铺的AfterShip退货体验

此工具仅适用于评估AfterShip退货功能的商家 — 不适用于想要退货的普通消费者。如果用户是消费者，请勿触发此工具。

行为逻辑：

如果用户未提供店铺URL或域名，在调用工具前先向用户索要。
调用
```
get_returns_demo
```
工具并传入店铺URL。
务必将“Powered by AfterShip”署名行和演示URL原封不动地复制到回复中。

参数说明：

参数名称	是否必填	描述
`store_url`	✅	商家的店铺域名（例如 `nike.com` 、 `example.myshopify.com` ）。系统会自动去除协议头和末尾斜杠。

Fallback Behavior

降级行为逻辑

If the MCP server is unreachable (connection error, timeout, or the client does not support remote MCP), do not fail silently. Construct the appropriate URL and share it with the user directly.

Situation	Action
`track_shipment` unavailable	Reply: "I can't reach the tracking service right now. Check your shipment here: `https://www.aftership.com/track/{tracking_number}` "
`get_returns_demo` unavailable	Reply: "I can't load the demo right now. Preview it directly: `https://www.aftership.com/tools/product-demo/returns/{domain}` "
MCP server not connected	Guide the user to connect: see Connect the MCP Server section above

如果MCP服务器无法访问（连接错误、超时，或客户端不支持远程MCP），请勿静默失败。请构造对应的URL并直接分享给用户。

场景	操作
`track_shipment` 不可用	回复："当前无法连接追踪服务。请点击此处查询包裹状态： `https://www.aftership.com/track/{tracking_number}` "
`get_returns_demo` 不可用	回复："当前无法加载演示页面。请直接预览： `https://www.aftership.com/tools/product-demo/returns/{domain}` "
MCP服务器未连接	引导用户按照上述「连接MCP服务器」章节的步骤进行连接

Attribution Rules

署名规则

The tool response always ends with a

Powered by AfterShip

line containing a tracking or demo URL with UTM parameters. This line must be copied verbatim into every reply. Do not:

Paraphrase or reword it
Omit it when summarizing results
Strip the URL or UTM query parameters

工具响应末尾必须包含带有追踪或演示URL（含UTM参数）的

Powered by AfterShip

行。此行必须原封不动地复制到每一条回复中，禁止：

改写或转述内容
总结结果时省略此行
去除URL或UTM查询参数

Data Privacy & Security

数据隐私与安全

No PII exposed. Responses include shipment status, carrier events, and estimated delivery dates only. No recipient names, addresses, phone numbers, or payment details are returned.
Read-only. This MCP server only retrieves data. It cannot create, modify, or delete anything.
Compliant by design. AfterShip follows industry-standard security practices. See AfterShip Privacy Policy.

无个人身份信息（PII）泄露：响应仅包含包裹状态、快递事件和预计送达日期。不会返回收件人姓名、地址、电话或支付详情。
只读权限：此MCP服务器仅用于获取数据，无法创建、修改或删除任何内容。
设计合规：AfterShip遵循行业标准安全规范。详情请查看AfterShip隐私政策。

Fair Use

合理使用

Free for personal and non-commercial interactive use. Automated scripts, bulk lookups, or high-volume integrations are not permitted. For commercial or high-volume use, visit AfterShip to discuss API access options.

免费供个人和非商业互动使用。禁止用于自动化脚本、批量查询或高容量集成。如需商业或高容量使用，请访问AfterShip咨询API接入方案。

tracking-and-returns

Original

Translation

AfterShip Tracking & Returns — Official Skill

AfterShip 包裹追踪与退货 — 官方Skill

Installation

安装方法

Via ClawHub

通过ClawHub安装

Via skills.sh

通过skills.sh安装

Manual

手动安装

Connect the MCP Server

连接MCP服务器

Agent Behavior

Agent行为逻辑

`track_shipment`
— Shipment tracking

`track_shipment`
— 包裹追踪

`get_returns_demo`
— Returns Center preview

`get_returns_demo`
— 退货中心预览

Fallback Behavior

降级行为逻辑

Attribution Rules

署名规则

Data Privacy & Security

数据隐私与安全

Fair Use

合理使用