Tracking Skill

An OpenAI Codex skill for tracking air-freight shipments by AWB, with a dispatcher for future ocean-freight adapters.

Included adapters

• China Southern Cargo (CZ, AWB prefix 784)
• XiamenAir Cargo (MF, AWB prefix 731)
• Qantas Freight (QF, AWB prefix 081)
• Scaffold responses for other known airline prefixes

The adapters use official carrier endpoints and return structured status, route, flight, weight, and milestone data when the carrier makes it available. Some carriers may return blocked when route information, CAPTCHA handling, or an official tracking response is required.

Install

Copy this directory to the Codex skills directory as tracking, preserving the agents, references, and scripts subdirectories. The skill entry point is SKILL.md.

Install the Python dependencies in the environment that runs the scripts:

python -m pip install -r requirements.txt

Run

python scripts/track_shipment.py 784-69127704 --mode airline --carrier cz --json
python scripts/track_shipment.py 081-12345675 --mode airline --json
python scripts/track_shipment.py CONTAINER123 --mode shipping-line --json

Run the local adapter health check with:

python scripts/health_check.py --allow-captcha --json

Scope and data handling

Use the skill with public shipment identifiers and official carrier services. Do not commit credentials, cookies, private shipment documents, or generated debug artifacts.

License

MIT. See LICENSE.