Update README with vehicle search commands

Author: lennart-johansson

README.md

@@ -6,7 +6,7 @@
 
 Fast CLI for searching [Blocket.se](https://www.blocket.se) — Sweden's largest marketplace.
 
-Designed for agents, scripts, and quick terminal lookups. Minimal dependencies, structured output.
+Search the general marketplace, cars, boats, and motorcycles. Designed for agents, scripts, and quick terminal lookups. Minimal dependencies, structured output.
 
 ## Install
 
@@ -22,7 +22,7 @@ uv tool install blocket-cli
 
 ## Usage
 
-### Search listings
+### Search general marketplace
 
 ```bash
 blocket search "soffa"
@@ -31,6 +31,28 @@ blocket search "mountainbike" -c sports --sort price-asc -n 10
 blocket search "ps5" -c electronics -o json | jq '.results[:3]'
 ```
 
+### Search cars
+
+```bash
+blocket cars "volvo xc60" --year-min 2018 --mileage-max 12000
+blocket cars "tesla model 3" --fuel el --sort price-asc
+blocket cars "vw alltrack" -l stockholm --price-max 300000 -o json
+```
+
+### Search boats
+
+```bash
+blocket boats "segelbat" --length-min 30
+blocket boats "bayliner" --sort price-asc -o json
+```
+
+### Search motorcycles
+
+```bash
+blocket mc "yamaha mt-07" --year-min 2020
+blocket mc "harley" --sort price-desc -o json
+```
+
 ### Get ad details
 
 ```bash
@@ -41,8 +63,9 @@ blocket ad 20851738 -o json
 ### Browse filters
 
 ```bash
-blocket categories
-blocket locations
+blocket categories    # general marketplace categories
+blocket locations     # Swedish counties
+blocket fuels         # fuel types for car search
 ```
 
 ## Output formats
@@ -53,32 +76,71 @@ blocket locations
 | `-o json` | Compact JSON | Piping to `jq`, API consumption |
 | `-o jsonl` | One JSON object per line | Streaming, log processing |
 
-## Search options
+## Common options
+
+All search commands support these shared options:
 
 | Option | Description |
 |--------|-------------|
 | `-l`, `--location` | Filter by Swedish county (e.g. `stockholm`, `skane`) |
-| `-c`, `--category` | Filter by category (e.g. `electronics`, `furniture`) |
 | `--price-min` | Minimum price in SEK |
 | `--price-max` | Maximum price in SEK |
 | `--sort` | Sort order (`relevance`, `price-asc`, `price-desc`, `date`) |
 | `-n`, `--limit` | Max results to display |
 | `-p`, `--page` | Page number |
 | `-o`, `--output` | Output format (`table`, `json`, `jsonl`) |
+| `--raw` | Full API response instead of slim fields |
+
+### General marketplace options
+
+| Option | Description |
+|--------|-------------|
+| `-c`, `--category` | Category filter (`electronics`, `furniture`, `sports`, etc.) |
+
+### Car options
+
+| Option | Description |
+|--------|-------------|
+| `--year-min` / `--year-max` | Model year range |
+| `--mileage-min` / `--mileage-max` | Mileage in Swedish mil (1 mil = 10 km) |
+| `--fuel` | Fuel type (`bensin`, `diesel`, `el`, `hybrid-bensin`, etc.) |
+| `--transmission` | `manuell` or `automat` |
+| `--sort` | Also supports `mileage-asc`, `mileage-desc`, `year-asc`, `year-desc` |
+
+### Boat options
+
+| Option | Description |
+|--------|-------------|
+| `--length-min` / `--length-max` | Length in feet |
+
+### Motorcycle options
+
+| Option | Description |
+|--------|-------------|
+| `--year-min` / `--year-max` | Model year range |
+| `--mileage-min` / `--mileage-max` | Mileage in Swedish mil |
+| `--sort` | Also supports `mileage-asc`, `mileage-desc`, `year-asc`, `year-desc` |
 
 ## Agent integration
 
 The JSON output is designed for LLM agents and automation:
 
 ```bash
-# Structured search results
-blocket search "cykel" -l stockholm --price-max 5000 -o json
+# Compact car search results
+blocket cars "volvo" --year-min 2020 -o json | jq '.results[:3]'
 
-# Stream results line by line
+# Stream general listings line by line
 blocket search "soffa" -o jsonl
 
-# Filter by category
-blocket search "lampa" -c furniture -o json | jq '[.results[] | {title: .heading, price: .price.amount, location}]'
+# Price analysis
+blocket cars "tesla model 3" --fuel el -o json | python3 -c "
+import sys, json
+data = json.load(sys.stdin)
+prices = [r['price'] for r in data['results'] if r.get('price') and r['price'] > 10]
+print(f'Found {data[\"total\"]} listings')
+print(f'Price range: {min(prices):,} - {max(prices):,} SEK')
+print(f'Average: {sum(prices)//len(prices):,} SEK')
+"
 ```
 
 ## License