Skip to main content
skill CX Codex

inpost — Claude Code skill: parcel tracking and installation

This Claude Code skill tracks InPost parcels and finds parcel lockers and pickup points in Poland. It runs on requests about delivery status, a locker address, or nearby locations.

MIT ★ 60 updated 2026-11-15

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add b44x/ai-polish-skills
/plugin install inpost@polskie-skille
Open on GitHub

What inpost does

The skill runs scripts/inpost.py to check a parcel by its 24-digit tracking number or find a locker. Tracking returns the current status and delivery events. Locker lookup accepts a point code, while search can use a city, street, postal code, or GPS coordinates and sort nearby locations by distance.

The script requires Python 3.8+ and network access to api-shipx-pl.easypack24.net; it uses only Python’s standard library. Its track, point, search, near, and statuses commands return structured JSON. Tracking numbers must contain 24 digits, and API or network errors produce an error response.

What it helps with

  • check a parcel’s current delivery status
  • retrieve a shipment’s event history
  • find a locker by code, address, or postal code
  • locate nearby lockers from GPS coordinates
  • list InPost status codes and their descriptions

Example prompts for the agent

  • Check the InPost parcel with tracking number 123456789012345678901234.
  • Find locker WAW01M and give me its address.
  • Find the nearest lockers to GPS coordinates 52.2297 21.0122.

How to install inpost

1Plugin marketplace

/plugin marketplace add b44x/ai-polish-skills
/plugin install inpost@polskie-skille

This installs the whole inpost plugin with all its skills

2Skills CLI (Vercel)

npx skills add b44x/ai-polish-skills --skill inpost -a claude-code

3Manually: put the files in place

~/.claude/skills/inpost/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/inpost/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about inpost

How do I install inpost in Claude Code?

Add the marketplace with /plugin marketplace add b44x/ai-polish-skills, then install the skill with /plugin install inpost@polskie-skille.

What does inpost do?

It checks InPost parcel status and event history, searches for lockers by code or location, and finds nearby points from GPS coordinates.

What does inpost need to run?

It requires Python 3.8+ and network access to api-shipx-pl.easypack24.net. The script uses Python’s standard library and needs no external Python packages.

Source text

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

Similar skills

SKILL.md skills catalog →

From the same set52

The whole set →
moja-gmina The moja-gmina Claude Code skill searches GUS BDL data and compares Polish territorial units for a shared year. It handles queries about population, demographics, construction or unemployment. CX Codex +1 ★ 60repo stars krs This Claude Code skill retrieves Polish KRS registry records through the Ministry of Justice API. Ask about a company to see its status, officers, and rules for signing contracts. CX Codex +1 ★ 60repo stars przetargi The przetargi Claude Code skill searches Polish public procurement notices in BZP and retrieves notice details. Filter results by subject, contracting authority region, CPV code or publication date. CX Codex +1 ★ 60repo stars solid-jobs This Claude Code skill searches SOLID.Jobs listings and salary statistics. Filter results by keywords, city, experience, remote work, or pay range. CX Codex +1 ★ 60repo stars nbp The nbp skill for Claude Code retrieves Narodowy Bank Polski exchange rates and gold prices. It handles currency conversions and invoice tax calculations in PLN. CX Codex +1 ★ 60repo stars filmweb This Claude Code skill retrieves film and TV details from Filmweb. It activates for title or link searches and questions about cast, ratings, release dates, or VOD. CX Codex +1 ★ 60repo stars dzialki The dzialki Claude Code skill finds Polish cadastral parcels through ULDK. Search by a full EGiB identifier, cadastral district and parcel number, or a point’s coordinates. CX Codex +1 ★ 60repo stars odjazdy The odjazdy Claude Code skill finds stops and upcoming bus or tram departures in Gdańsk, Poznań, and Szczecin. Ask about a stop by name or ID to check its board. CX Codex +1 ★ 60repo stars

Project sponsors

Companies that keep this analytics open