← 返回 Skills 市场
156
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install dhl-tracking
功能描述
Track DHL parcels in Germany via the dhl.de API. Use when a user asks to track a DHL package, check delivery status, monitor a shipment, or wants notificatio...
使用说明 (SKILL.md)
DHL Tracking
Track DHL parcels via the dhl.de internal API endpoint using simple HTTP requests.
Important: Why this skill exists
DHL's tracking website (dhl.de/sendungsverfolgung) is a JavaScript SPA protected by Akamai Bot Manager. The SPA renders tracking data client-side after passing bot checks — headless browsers (even with stealth patches) fail due to TLS fingerprinting.
The solution: A simple curl to www.dhl.de/int-verfolgen/data/search with minimal headers returns full tracking JSON. No auth, no cookies, no JS needed.
Quick Usage
Bash (one-liner)
bash scripts/dhl_track.sh TRACKING_NUMBER
Python (formatted output)
python3 scripts/dhl_track.py TRACKING_NUMBER
Direct curl
curl -s 'https://www.dhl.de/int-verfolgen/data/search?piececode=TRACKING_NUMBER&language=de' \
-H 'Accept: application/json' -H 'User-Agent: Mozilla/5.0'
Response Structure
sendungen[0].sendungsdetails.sendungsverlauf:
.status → Current status text (German)
.fortschritt → Progress (0-5)
.maximalFortschritt → Always 5
.events[] → Array of {datum, status, ruecksendung}
sendungen[0].sendungsdetails.zustellung:
.zustellzeitfensterVon/Bis → Delivery window
sendungen[0].sendungsdetails.istZugestellt → boolean
Progress values
- 0-1: Label created / picked up
- 2: In transit
- 3: In recipient's region
- 4: Out for delivery (loaded onto delivery vehicle)
- 5: Delivered
Monitoring Pattern
To monitor a package and notify when close to delivery:
- Run
python3 scripts/dhl_track.py TRACKING_NUMBERperiodically (cron, every 30 min) - Parse
fortschrittfrom stderr JSON output - Notify user when
fortschritt >= 4(out for delivery)
What does NOT work (and why this skill exists)
web_fetchon dhl.de → only gets static HTML shell, no tracking data (JS SPA)- Headless Chrome on dhl.de → Akamai blocks internal API via TLS fingerprinting (returns 404)
- Stealth patches (fake UA, hide webdriver, fake plugins) → still detected by TLS/JA3 fingerprint
nolp.dhl.delegacy endpoint → now also protected by Akamai (returns 500)- DHL public API (
api-eu.dhl.com) → requires API key registration - Third-party trackers (17track, parcelsapp) → often delayed or incomplete for DE parcels
Notes
- Works for German DHL Paket numbers (typically
0034...) - Language:
language=de(German) orlanguage=en(English) - Be reasonable with polling (max once per minute)
- If the API starts returning 404/HTML, the Akamai protection may have expanded — try varying the User-Agent or adding a
Referer: https://www.dhl.de/header
安全使用建议
This skill appears coherent and low-risk: it simply queries a DHL JSON endpoint and formats results. Things to consider before installing: (1) The skill scrapes an internal/undocumented DHL endpoint and the SKILL.md even suggests changing User-Agent/Referer if Akamai starts blocking — that may violate DHL's terms of service and could stop working if protections change. (2) Be conservative with polling (the author recommends no faster than once per minute). (3) If you need guaranteed, long-term/large-scale tracking or legal compliance, use DHL's official API (requires registration/API key). (4) The included scripts are short and readable; review them yourself if you want to confirm behavior. If you accept potential fragility and the TOS implications, this skill is internally consistent and does not request sensitive credentials.
功能分析
Type: OpenClaw Skill
Name: dhl-tracking
Version: 1.0.0
The skill provides a legitimate utility for tracking DHL parcels in Germany by querying a public DHL API endpoint. The implementation in `scripts/dhl_track.sh` and `scripts/dhl_track.py` is transparent, uses standard libraries, and contains no evidence of data exfiltration, unauthorized execution, or malicious prompt injection.
能力评估
Purpose & Capability
Name/description match the included scripts and SKILL.md. The Python and shell scripts perform simple HTTP GETs against the DHL endpoint and format the returned JSON; nothing in the package requests unrelated services, credentials, or system resources.
Instruction Scope
SKILL.md stays on-topic (how to call the endpoint, expected JSON structure, and how to poll). It does provide guidance about varying User-Agent or adding a Referer if the endpoint becomes protected, which is guidance for working around bot protection — functionally relevant but worth noting from a policy/terms-of-service perspective. The scripts only read stdin/argv and network responses; they do not access other system files or environment variables.
Install Mechanism
No install spec; the skill is instruction-only plus two small scripts. Nothing is downloaded from external installers or written to disk by an installer step beyond the included files.
Credentials
No environment variables, credentials, or config paths are requested. The skill does not attempt to access secrets or unrelated services.
Persistence & Privilege
always is false and the skill does not request elevated persistence or modify other skills/config. Autonomous invocation is allowed (platform default) but not combined with other concerning privileges.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install dhl-tracking - 安装完成后，直接呼叫该 Skill 的名称或使用
/dhl-tracking触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release: Track DHL parcels via simple API, no browser/auth needed
元数据
常见问题
DHL Tracking 是什么？
Track DHL parcels in Germany via the dhl.de API. Use when a user asks to track a DHL package, check delivery status, monitor a shipment, or wants notificatio... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 156 次。
如何安装 DHL Tracking？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install dhl-tracking」即可一键安装，无需额外配置。
DHL Tracking 是免费的吗？
是的，DHL Tracking 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
DHL Tracking 支持哪些平台？
DHL Tracking 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 DHL Tracking？
由 idrs（@idrs）开发并维护，当前版本 v1.0.0。
推荐 Skills