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 registration/WOF/licence snippets, odometer snippets, or CarJam source URLs. Read-only; no paid report purchase, owner lookup, login, account, or write actions.From its SKILL.md
npx -y skills add thecolab-ai/.skills --skill carjam-nzAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
3.5 KB, as published. Nobody here has run it
CarJam 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