🎯

track17

🎯Skill

from tristanmanchester/agent-skills

What it does

Tracks and manages parcel shipments using the 17TRACK API, storing tracking details in a local SQLite database with optional webhook support.

📦

Part of

tristanmanchester/agent-skills(9 items)

track17

Installation

Quick InstallInstall with npx

npx skills add tristanmanchester/agent-skills

📖 Extracted from docs: tristanmanchester/agent-skills

Need more details? View full documentation on GitHub →

2Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Track parcels via the 17TRACK API (local SQLite DB, polling + optional webhook ingestion)

Overview

# 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: /packages/track17/track17.sqlite3).

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

1) Initialise storage (safe to run multiple times):

```bash

python3 {baseDir}/scripts/track17.py init

```

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

```bash

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

```

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

```bash

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

```

3) List tracked packages:

```bash

python3 {baseDir}/scripts/track17.py list

```

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

```bash

python3 {baseDir}/scripts/track17.py sync

```

5) Show details for one package:

```bash

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

```bash

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

```bash

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:

```bash

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

```

Common actions

Stop tracking:

```bash

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

```

Retrack a stopped parcel:

```bash

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

```

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

```bash

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

```

Show API quota:

```bash

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.

More from this repository8

🎯

reddit-readonly🎯Skill

Browses and searches Reddit content using public JSON endpoints in a read-only manner, without requiring authentication.

🎯

notion-api-automation🎯Skill

Automates Notion operations like searching, reading, creating, and managing pages and data sources using a JSON-first CLI with robust error handling.

🎯

designing-beautiful-websites🎯Skill

Designs user-friendly websites by creating strategic UX/UI with clear navigation, intuitive interactions, and cohesive visual systems that prioritize user goals.

🎯

parallel-ai-search🎯Skill

Performs web research and URL content extraction using Parallel Search/Extract APIs, generating LLM-ready ranked excerpts and clean markdown.

🎯

ios-simulator🎯Skill

Automates iOS Simulator interactions like installing apps, launching simulators, capturing screenshots, and performing UI taps using simctl/idb tools.

🎯

auditing-appstore-readiness🎯Skill

Evaluates iOS app metadata, screenshots, and submission requirements to ensure an app meets Apple App Store guidelines and is ready for successful submission.

🎯

fabric-api🎯Skill

Creates and searches Fabric resources like notepads, folders, bookmarks, and files through an HTTP API interface.

🎯

assemblyai-transcribe🎯Skill

Transcribes audio files to text using AssemblyAI's speech recognition API, enabling accurate and efficient audio-to-text conversion.