track17 — скилл для Claude Code: отслеживание посылок через 17TRACK API
Скилл track17 для Claude Code регистрирует и отслеживает посылки через 17TRACK API, сохраняет события доставки и принимает вебхуки. Интегрирует трекинг посылок через 17TRACK в агента.
лицензия не указана 104 установок ★ 4 обновлён 2026-09-14
npx skills add tristanmanchester/agent-skills --skill track17 -a claude-codeЧто делает track17
Скилл даёт агенту команды для управления посылками: регистрация по номеру трека и коду перевозчика, синхронизация текущего статуса, просмотр истории событий доставки, удаление записей. Работает через CLI-скрипт на Python 3.10+, данные хранятся локально в директории, которую вы указываете. Третьих библиотек не требует.
Для работы нужны два параметра: TRACK17_TOKEN (ключ API, храним в хранилище переменных платформы) и TRACK17_DATA_DIR (абсолютный путь вне репозитория). При обновлении с более старой версии старая база данных не переносится автоматически — нужно выбрать новую директорию и заново зарегистрировать нужные посылки, чтобы не переиспользовать квоту поставщика.
Поддерживает аутентифицированные вебхуки 17TRACK: проверяет подпись SHA-256, может запускать локальный сервер для push-доставки событий или обрабатывать входящие вебхуки вручную. В обоих случаях требует реверс-прокси с TLS перед сервером разработки. Отслеживает как момент события доставки, так и время последней успешной синхронизации.
Какие задачи решает
- добавить посылку в трекер по номеру и коду перевозчика
- получить текущий статус доставки и список всех событий
- синхронизировать данные со всеми активными посылками через 17TRACK
- получить вебхук о новом событии доставки и обновить базу
- удалить посылку из локального трекера или с сервера провайдера
Примеры запросов агенту
- Добавь посылку с номером RR123456789CN с меткой «Наушники» в трекер
- Получи текущий статус посылки RR123456789CN и обнови его с сервера
- Синхронизируй все посылки и покажи последние события доставки
Как установить track17
1Через Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill track17 -a claude-code2Вручную: положить файлы
~/.claude/skills/track17/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/track17/
1Через Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill track17 -a codex2Вручную: положить файлы
.agents/skills/track17/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill track17 -a cursor2Вручную: положить файлы
.cursor/skills/track17/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tristanmanchester/agent-skills track172Вручную: положить файлы
.github/skills/track17/SKILL.md1Через Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill track17 -a gemini-cli2Командой платформы
gemini skills install https://github.com/tristanmanchester/agent-skills --path track17Вручную: положить файлы
.devin/skills/track17/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill track17 -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о track17
Как установить track17 в Claude Code?
Запусти команду npx skills add tristanmanchester/agent-skills --skill track17 -a claude-code, затем проверь установку в ~/.claude/skills/track17/SKILL.md.
Что нужно, чтобы track17 начал работать?
Нужны три вещи: Python 3.10 или выше, ключ 17TRACK API в переменной окружения TRACK17_TOKEN и абсолютный путь к директории для данных в переменной TRACK17_DATA_DIR. Запусти python3 "$SKILL_DIR/scripts/track17.py" init один раз при первой настройке.
Как работают вебхуки 17TRACK в track17?
Скилл проверяет подпись SHA-256 из заголовка sign, используя ключ API. Можно запустить встроенный сервер вебхуков командой python3 "$SKILL_DIR/scripts/track17.py" webhook-server --port 8789 (слушает на localhost), но перед ним обязателен реверс-прокси с TLS.