delivery-tracking
Track CJ대한통운 and 우체국 parcels by invoice number with official carrier endpoints, and structure the workflow around a carrier adapter that can grow to more couriers later.
Security Assessment
Detected risks:
About delivery-tracking
The delivery-tracking skill provides a structured workflow for tracking parcel delivery status using official courier tracking surfaces from CJ Logistics (CJ대한통운) and Korea Post (우체국). Instead of relying on unofficial aggregation services, the skill directly interacts with the carriers’ official tracking endpoints to retrieve shipment progress by invoice number. It normalizes the returned data into a shared format that includes the carrier identifier, invoice number, current delivery status, and recent tracking events. The skill is designed to validate invoice numbers before sending requests, reducing unnecessary network calls and improving reliability.
A key capability of this skill is its carrier adapter architecture, which separates courier-specific logic into reusable adapters. Each adapter defines validation rules, transport type, parsing logic, status normalization rules, and retry behavior. The current implementation supports two adapters: a CJ Logistics adapter using a JSON-based tracking flow with CSRF token handling, and an ePost adapter using an HTML-based form workflow. The included workflow demonstrates how to normalize input, preserve cookies during requests, extract required tokens, parse tracking payloads, and map raw carrier status codes into simplified delivery states. The implementation uses standard command-line tools such as curl and python3, with optional jq support for JSON inspection.
This skill is useful for developers building logistics automation, shipment monitoring utilities, customer support tools, or AI agents that need reliable parcel tracking capabilities for Korean couriers. It is also appropriate for teams that want an extensible tracking framework where additional carriers can be added later through new adapters. Typical use cases include checking whether a package has been delivered, monitoring shipment movement, and integrating official delivery status lookups into backend workflows or conversational interfaces.
FAQ
Which carriers are currently supported?
The skill currently supports CJ Logistics (CJ대한통운) and Korea Post (우체국) through dedicated carrier adapters.
What input information is required for tracking?
You must provide both a supported carrier identifier and a valid invoice number. Supported carrier identifiers are `cj` and `epost`.
Does the skill support unofficial parcel aggregation services?
No. The workflow is designed around official carrier tracking endpoints and does not use unofficial integrated tracking services.
What are the invoice number validation requirements?
CJ Logistics tracking numbers must be numeric values with 10 or 12 digits, while Korea Post tracking numbers must contain 13 numeric digits.
Can additional couriers be added later?
Yes. The skill uses a carrier adapter structure that separates validation, transport handling, parsing, status mapping, and retry logic, making it easier to extend support for additional carriers.
Install delivery-tracking
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
nomadamas/k-skill