track17 — Claude Code skill: parcel tracking with 17TRACK API
track17 is a Claude Code skill that registers and tracks parcels through the 17TRACK API, stores delivery events, and handles webhooks. It integrates parcel tracking into an agent workflow.
no license 104 installs ★ 4 updated 2026-09-14
npx skills add tristanmanchester/agent-skills --skill track17 -a claude-codeWhat track17 does
The skill gives your agent CLI commands to manage parcels: register by tracking number and carrier code, sync current status, view delivery history, remove records. It runs on Python 3.10+ and stores data locally in a directory you specify. No external Python packages required.
You need two things to start: TRACK17_TOKEN (API key, stored as a platform secret) and TRACK17_DATA_DIR (absolute path outside your repo). If upgrading from an older version, the old database is not migrated automatically—choose a new directory and re-register the parcels you want to keep, to avoid wasting your API quota.
Supports authenticated 17TRACK webhooks: verifies SHA-256 signatures, can run a local server for event push delivery, or process incoming webhooks manually. Both modes require a TLS reverse proxy in front of the development server. Tracks both the event timestamp and your last successful sync time.
What it helps with
- register a parcel by tracking number and carrier code
- fetch current delivery status and the full event timeline
- sync all active parcels with 17TRACK and check for new events
- ingest a delivery webhook and update the local database
- remove a parcel from your tracker or from the provider's server
Example prompts for the agent
- Add tracking number RR123456789CN labeled 'Headphones' to the tracker
- Check status for parcel RR123456789CN and refresh from the server
- Sync all parcels and show me the latest delivery events
How to install track17
1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill track17 -a claude-code2Manually: put the files in place
~/.claude/skills/track17/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/track17/
1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill track17 -a codex2Manually: put the files in place
.agents/skills/track17/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill track17 -a cursor2Manually: put the files in place
.cursor/skills/track17/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tristanmanchester/agent-skills track172Manually: put the files in place
.github/skills/track17/SKILL.md1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill track17 -a gemini-cli2Platform CLI
gemini skills install https://github.com/tristanmanchester/agent-skills --path track17Manually: put the files in place
.devin/skills/track17/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill track17 -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about track17
How do I install track17 in Claude Code?
Run npx skills add tristanmanchester/agent-skills --skill track17 -a claude-code, then check the installation at ~/.claude/skills/track17/SKILL.md.
What do I need to get track17 working?
Python 3.10 or later, your 17TRACK API key in the TRACK17_TOKEN environment variable, and an absolute path to a data directory in TRACK17_DATA_DIR. Run python3 "$SKILL_DIR/scripts/track17.py" init once to set up.
How do webhooks work in track17?
The skill verifies the SHA-256 signature from the sign header using your API key. You can run a webhook server with python3 "$SKILL_DIR/scripts/track17.py" webhook-server --port 8789 (binds to localhost), but a TLS reverse proxy in front is required.