car-finderlisted
Install: claude install-skill Zachbishop8104/car-finder
# Car Finder
## What this skill needs and touches
Tell the user this before the first live run; none of it is hidden.
- **Python 3.10+, and nothing else to install.** The code uses only the
standard library. (If PyYAML happens to be installed it is used to
read `config.yaml`; otherwise a built-in reader does it.)
- **Network, read-only GETs to three services:** `api.marketcheck.com`
(dealer listings), `api.nhtsa.gov` / `vpic.nhtsa.dot.gov` (VIN decode,
recalls, complaints) and `www.fueleconomy.gov` (EPA mileage). Nothing
else is contacted and nothing is uploaded beyond the search parameters
(ZIP, radius, price and mileage range, make/model) and VINs being
looked up.
- **One optional credential:** `MARKETCHECK_API_KEY`, the user's own
free key, read from the environment or from `.env` in the data
folder. It is sent only to `api.marketcheck.com`, and only searching
dealer inventory needs it. Researching a car by VIN and `--sample`
need no key and make no Marketcheck calls. The only other environment
variable read is the
optional `CAR_FINDER_HOME`, which relocates the data folder.
- **Files:** the tool keeps the user's own data in one folder,
`~/.car-finder/` by default: `config.yaml`, `.env`, `output/` and
`.cache/`. The cache and call counter there are what protect the API
quota, so it has to persist between sessions. Nothing else on the
machine is read or modified.
`python run.py where` prints the data folder, whether a config exists
ther