track17 | sundial-org-awesome-openclaw-skills-4 | ClaudePluginHub

Skill

track17

From sundial-org-awesome-openclaw-skills-4

Tracks parcels via 17TRACK API with local SQLite DB storage. Supports CLI commands for adding, listing, polling updates, status checks, and optional webhook ingestion.

Install

$

npx claudepluginhub joshuarweaver/cascade-ai-ml-agents-misc-2 --plugin sundial-org-awesome-openclaw-skills-4

Tool Access

This skill uses the workspace's default tool permissions.

Preview

This skill lets Clawdbot keep a local list of your parcels, track their state via the **17TRACK Tracking API v2.2**, and summarise changes.

Supporting Assets

README.mdscripts/track17.py

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Stars586

Forks75

Last CommitFeb 1, 2026

Actions

View Source View Plugin View on GitHub View README

Tags

parcel-tracking

track17 (17TRACK parcel tracking)

This skill lets Clawdbot keep a local list of your parcels, track their state via the 17TRACK Tracking API v2.2, and summarise changes.

It stores everything in a small SQLite DB under your workspace (by default: <workspace>/packages/track17/track17.sqlite3).

<workspace> is auto-detected as the parent directory of the nearest skills/ directory that contains this skill. For example, if you install it at /clawd/skills/track17/, data will be stored at /clawd/packages/track17/.

Requirements

TRACK17_TOKEN must be set (17TRACK API token; used as the 17token header).
Python (python3 preferred).

Optional:

TRACK17_WEBHOOK_SECRET if you want to verify webhook signatures.
TRACK17_DATA_DIR to override where the DB/inbox live.
TRACK17_WORKSPACE_DIR to override what this tool considers the workspace directory.

Quick start

Initialise storage (safe to run multiple times):

python3 {baseDir}/scripts/track17.py init

Add a package (registers it with 17TRACK and stores it locally):

python3 {baseDir}/scripts/track17.py add "RR123456789CN" --label "AliExpress headphones"

If carrier auto-detection fails, specify a carrier code:

python3 {baseDir}/scripts/track17.py add "RR123456789CN" --carrier 3011 --label "..."

List tracked packages:

python3 {baseDir}/scripts/track17.py list

Poll for updates (recommended if you don't want webhooks):

python3 {baseDir}/scripts/track17.py sync

Show details for one package:

python3 {baseDir}/scripts/track17.py status 1
# or
python3 {baseDir}/scripts/track17.py status "RR123456789CN"

Webhooks (optional)

17TRACK can push updates to a webhook URL. This skill supports webhook ingestion in two ways:

A) Run the included webhook server

python3 {baseDir}/scripts/track17.py webhook-server --bind 127.0.0.1 --port 8789

Then point 17TRACK's webhook URL at that server (ideally via a reverse proxy or Tailscale Funnel).

B) Ingest webhook payloads from stdin/file

cat payload.json | python3 {baseDir}/scripts/track17.py ingest-webhook
# or
python3 {baseDir}/scripts/track17.py ingest-webhook --file payload.json

If you saved webhook deliveries to the inbox directory, process them:

python3 {baseDir}/scripts/track17.py process-inbox

Common actions

Stop tracking:

python3 {baseDir}/scripts/track17.py stop 1

Retrack a stopped parcel:

python3 {baseDir}/scripts/track17.py retrack 1

Delete a parcel from local DB (does not delete at 17TRACK unless you also call delete-remote):

python3 {baseDir}/scripts/track17.py remove 1

Show API quota:

python3 {baseDir}/scripts/track17.py quota

Operating guidance for the agent

Prefer sync (polling) for simplicity unless the user explicitly wants webhooks.
After adding a package, run status once to confirm a valid carrier/status was returned.
When summarising, prioritise:
- delivered/out for delivery
- exception/failed delivery
- customs holds
- carrier handoffs
Never echo TRACK17_TOKEN or TRACK17_WEBHOOK_SECRET.