inpost — скилл для Claude Code: отслеживание и установка
Скилл для Claude Code отслеживает посылки InPost и ищет постаматы с пунктами выдачи в Польше. Запускается на запрос о статусе отправления, адресе постамата или ближайшей точке.
MIT ★ 60 обновлён 2026-11-15
/plugin marketplace add b44x/ai-polish-skills
/plugin install inpost@polskie-skilleЧто делает inpost
Скилл запускает scripts/inpost.py, чтобы проверить отправление по 24-значному номеру или найти постамат. По номеру он возвращает статус и события доставки; по коду точки — адрес и описание места. Поиск также работает по городу, улице, индексу или GPS-координатам, с расстояниями до ближайших точек.
Скрипту нужны Python 3.8+ и доступ к сети для обращения к api-shipx-pl.easypack24.net; зависимости ограничены стандартной библиотекой Python. Команды track, point, search, near и statuses возвращают структурированный JSON. Неверный номер должен содержать не 24 цифры, а сетевые ошибки API завершают команду ошибкой.
Какие задачи решает
- проверить текущий статус посылки по номеру
- посмотреть историю событий доставки
- найти постамат по коду, адресу или индексу
- определить ближайшие постаматы по GPS-координатам
- получить список кодов и описаний статусов InPost
Примеры запросов агенту
- Проверь статус посылки InPost по номеру
123456789012345678901234. - Найди постамат по коду
WAW01Mи покажи адрес. - Найди ближайшие постаматы к координатам
52.2297 21.0122.
Как установить inpost
1Через маркетплейс плагинов
/plugin marketplace add b44x/ai-polish-skills/plugin install inpost@polskie-skilleКоманда ставит плагин inpost целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill inpost -a claude-code3Вручную: положить файлы
~/.claude/skills/inpost/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/inpost/
1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill inpost -a codex2Вручную: положить файлы
.agents/skills/inpost/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill inpost -a cursor2Вручную: положить файлы
.cursor/skills/inpost/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install b44x/ai-polish-skills skills/inpost2Вручную: положить файлы
.github/skills/inpost/SKILL.md1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill inpost -a gemini-cli2Командой платформы
gemini skills install https://github.com/b44x/ai-polish-skills --path skills/inpostВручную: положить файлы
.devin/skills/inpost/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об inpost
Как установить inpost в Claude Code?
Добавь маркетплейс командой /plugin marketplace add b44x/ai-polish-skills, затем установи скилл: /plugin install inpost@polskie-skille.
Что делает inpost?
Скилл проверяет статус и историю посылки InPost, ищет постаматы по коду, адресу, индексу или координатам и показывает расстояние до ближайших точек.
Что нужно для работы inpost?
Нужны Python 3.8+ и доступ к сети для подключения к api-shipx-pl.easypack24.net. Внешние Python-зависимости не требуются: используется стандартная библиотека.
Исходный текст
SKILL.md · MIT
---
name: inpost
display_name: InPost & Paczkomaty
version: 1.0.0
description: >-
Track InPost shipments and find Paczkomat parcel lockers and pickup points across Poland.
Check shipment status and historical events by 24-digit tracking number (e.g. "gdzie moja paczka InPost",
"status przesyłki"). Look up Paczkomat locker details by code (e.g. WAW01M, KRA01A) including address,
location description, 24/7 accessibility, easy access zone (Strefa Łatwego Dostępu), payment options,
and photo. Search lockers by city, street, postal code, or find nearest Paczkomaty by GPS coordinates
with distances in meters. Use whenever the user asks about an InPost parcel, Paczkomat location,
"gdzie jest paczkomat", "najbliższy paczkomat", or pastes an InPost tracking link/number.
category: logistics
language: pl
country: PL
license: MIT
author: Michell Hoduń (https://github.com/b44x)
repository: https://github.com/b44x/ai-polish-skills
network: true
authentication: none
source: InPost ShipX API
source_type: public_api
official: false
homepage: https://inpost.pl
documentation: https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/11731057/ShipX+API
rate_limit: fair use
last_verified: 2026-09-28
tags:
- inpost
- paczkomaty
- tracking
- przesylki
- kurier
- logistyka
compatibility: Python 3.8+ (standard library only); network access to api-shipx-pl.easypack24.net.
---
# InPost & Paczkomaty
Tracks parcels and searches for Paczkomat lockers and pickup points across Poland using
`scripts/inpost.py`. Always outputs structured JSON.
## Running the script
Run from this skill's directory (or use relative path from repo root):
| OS | Command |
|---|---|
| Linux / macOS | `python3 scripts/inpost.py <command> …` |
| Windows | `py scripts/inpost.py <command> …` (or `python`) |
Zero external dependencies required (standard library only).
## Workflow
1. **Parcel Tracking:**
- User provides a 24-digit tracking number or InPost link:
`python3 scripts/inpost.py track <number>`
- Report the current status title (`statusTitle`), timestamp, and if present, target locker (`targetMachine`).
- If the user wants full journey history, list items from `events`.
2. **Finding a Paczkomat / Locker Point:**
- **By locker code** (e.g. `WAW01M`, `KRA01A`):
`python3 scripts/inpost.py point <name>`
- **By city / address / street**:
`python3 scripts/inpost.py search --city "Warszawa" --query "Chmielna"`
- **By postal code**:
`python3 scripts/inpost.py search --post-code "00-517"`
- **By GPS coordinates** (closest lockers with distance in meters):
`python3 scripts/inpost.py near 52.2297 21.0122 --limit 5`
3. **Presenting the locker to the user:**
- Give the locker code (`name`), street address, and `locationDescription` (e.g. "Przy wejściu do Rossmanna").
- Mention whether it is accessible 24/7 (`is24_7`) and if it supports Strefa Łatwego Dostępu (`easyAccessZone`).
- Provide the `googleMapsUrl` for easy navigation.
## Commands
| Command | Description | Returns |
|---|---|---|
| `track <number>` | Track parcel by 24-digit tracking number | `status`, `statusTitle`, `targetMachine`, `events`, `trackingUrl` |
| `point <name>` | Look up locker details by code (e.g. `WAW322M`) | `name`, `typeDescription`, `address`, `locationDescription`, `openingHours`, `easyAccessZone`, `googleMapsUrl` |
| `search [--city C] [--query Q] [--post-code P]` | Search lockers in a city, street, or postal code | Matching operating lockers list with addresses and location tips |
| `near <lat> <lon> [--limit N] [--max-distance M]` | Find closest lockers to GPS coordinates | Closest lockers sorted by distance in meters (`distanceFormatted`) |
| `statuses` | List all official InPost parcel status codes & descriptions | Full catalog of parcel statuses in Polish |
Field reference: [references/output.md](references/output.md).
## Exit codes
JSON goes to stdout; errors go to stderr as `{"error": "...", "type": "..."}`.
| Code | Meaning | What to do |
|---|---|---|
| `0` | Success | Use the JSON output |
| `2` | Not found | Tracking number or point code does not exist |
| `64` | Bad usage | Invalid tracking number (must be 24 digits) or invalid arguments |
| `69` | Network / InPost API error | Retry once; check internet connection |
## Rules
- Don't invent fake tracking numbers or locations.
- If the user provides a tracking URL (e.g. `https://inpost.pl/sledzenie-przesylek?number=622...`), extract the 24-digit number.
- For locker inquiries, always include the code (`name`) and `locationDescription` (visual cue) to help the user identify the machine easily.
© Michell Hoduń (https://github.com/b44x) · MIT · b44x/ai-polish-skills