carjam-nz
Query CarJam NZ public/basic vehicle information pages through a lightweight no-login CLI. Use when the task involves New Zealand vehicle plate, VIN, or chassis lookup, make/model/year/colour, public
SKILL.mdskills/carjam-nz/SKILL.md
GitHubCarJam NZ
Goal
Query public/basic CarJam NZ vehicle information from the no-login HTML report page through a deterministic Python CLI.
Use this when
- A user asks for public CarJam details for a New Zealand plate, VIN, or chassis
- A user wants a quick make/model/year/colour/plate/VIN summary
- A workflow needs machine-readable public vehicle metadata with source URLs
- A user wants to know which fields are report-gated versus visible for free
Do not use this for
- Paid CarJam report purchase, checkout, subscription, login, or account actions
- Owner name/address lookup, personal information extraction, or bypassing report gates
- Updating stolen status, reminders, watchlists, or any write/mutation flow
- Treating public snippets as official legal advice; direct users to NZTA/Waka Kotahi or CarJam for authoritative/current status
Preferred workflow
- Run
scripts/cli.py lookup <plate>for one vehicle - Add
--jsonfor structured output or chaining - Use
--rawonly when the task needs all parsed public fields rather than the concise summary - Use
batchfor a small set of plates; keep the default delay to avoid hammering the public site - Clearly distinguish public/basic fields from paid/report-gated fields shown as
Get Report,May be in Report, orSubscribe
CLI
Run with:
python3 skills/carjam-nz/scripts/cli.py <command> [flags]
Commands
lookup <identifier> [--type plate|vin|chassis] [--json] [--raw]— lookup one vehiclebatch <identifier...> [--type plate|vin|chassis] [--sleep seconds] [--fail-fast] [--json]— compact summaries for multiple identifiers
Examples:
python3 skills/carjam-nz/scripts/cli.py lookup ABC123
python3 skills/carjam-nz/scripts/cli.py lookup ABC123 --json
python3 skills/carjam-nz/scripts/cli.py lookup 7A8CJ0P0797205527 --type vin --json
python3 skills/carjam-nz/scripts/cli.py batch ABC123 KMM42 --json
Resources
- CLI entrypoint:
scripts/cli.py - Live smoke test:
scripts/smoke_test.py - Source/stability notes:
references/api-notes.md
Notes
- No API key, username, password, account cookie, browser automation, or paid report purchase is required for supported commands
- This skill parses public HTML, not a published API; CarJam page structure can change
- Some fields are intentionally report-gated by CarJam and are preserved as locked/gated rather than bypassed