Add vehicle search: cars, boats, and motorcycles

New commands for Blocket's mobility API:
- `blocket cars` with year, mileage (mil), fuel, and transmission filters
- `blocket boats` with length filter
- `blocket mc` with year and mileage filters
- `blocket fuels` to list available fuel types

Bump version to 0.2.0.

Author: lennart-johansson

blocket_cli/__init__.py

@@ -1,3 +1,3 @@
 """Fast CLI for searching Blocket.se — optimized for agents and scripting."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

blocket_cli/api.py

@@ -9,9 +9,12 @@
 
 BASE = "https://www.blocket.se"
 SEARCH_URL = f"{BASE}/recommerce/forsale/search/api/search/SEARCH_ID_BAP_COMMON"
+CAR_SEARCH_URL = f"{BASE}/mobility/search/api/search/SEARCH_ID_CAR_USED"
+BOAT_SEARCH_URL = f"{BASE}/mobility/search/api/search/SEARCH_ID_BOAT_USED"
+MC_SEARCH_URL = f"{BASE}/mobility/search/api/search/SEARCH_ID_MC_USED"
 
 HEADERS = {
-    "User-Agent": "blocket-cli/0.1.0 (https://github.com/lennart-johansson/blocket-cli)",
+    "User-Agent": "blocket-cli/0.2.0 (https://github.com/lennart-johansson/blocket-cli)",
 }
 
 LOCATIONS = {
@@ -68,6 +71,57 @@
 }
 
 
+FUELS = {
+    "bensin": "1",
+    "diesel": "2",
+    "el": "4",
+    "etanol": "2441",
+    "cng": "3",
+    "hybrid-bensin": "6",
+    "hybrid-diesel": "8",
+    "hybrid-gas": "5",
+    "plugin-bensin": "1352",
+    "plugin-diesel": "1356",
+}
+
+FUEL_LABELS = {
+    "bensin": "Bensin",
+    "diesel": "Diesel",
+    "el": "El",
+    "etanol": "Etanol",
+    "cng": "CNG",
+    "hybrid-bensin": "Hybrid (bensin)",
+    "hybrid-diesel": "Hybrid (diesel)",
+    "hybrid-gas": "Hybrid (gas)",
+    "plugin-bensin": "Plug-in (bensin)",
+    "plugin-diesel": "Plug-in (diesel)",
+}
+
+TRANSMISSIONS = {
+    "manuell": "1",
+    "automat": "2",
+}
+
+TRANSMISSION_LABELS = {
+    "manuell": "Manuell",
+    "automat": "Automatisk",
+}
+
+
+def _resolve_fuel(name: str) -> str:
+    code = FUELS.get(name.lower())
+    if not code:
+        raise ValueError(f"Unknown fuel '{name}'. Valid: {', '.join(sorted(FUELS))}")
+    return code
+
+
+def _resolve_transmission(name: str) -> str:
+    code = TRANSMISSIONS.get(name.lower())
+    if not code:
+        raise ValueError(f"Unknown transmission '{name}'. Valid: {', '.join(sorted(TRANSMISSIONS))}")
+    return code
+
+
 def _resolve_location(name: str) -> str:
     code = LOCATIONS.get(name.lower())
     if not code:
@@ -157,3 +211,114 @@ def handle_endtag(self, tag):
             continue
 
     return None
+
+
+def search_cars(
+    query: str,
+    *,
+    location: str | None = None,
+    price_min: int | None = None,
+    price_max: int | None = None,
+    year_min: int | None = None,
+    year_max: int | None = None,
+    mileage_min: int | None = None,
+    mileage_max: int | None = None,
+    fuel: str | None = None,
+    transmission: str | None = None,
+    sort: str | None = None,
+    page: int = 1,
+) -> dict:
+    """Search used cars on Blocket."""
+    params: list[tuple[str, str]] = [("q", query), ("page", str(page))]
+    if location:
+        params.append(("location", _resolve_location(location)))
+    if price_min is not None:
+        params.append(("price_from", str(price_min)))
+    if price_max is not None:
+        params.append(("price_to", str(price_max)))
+    if year_min is not None:
+        params.append(("year_from", str(year_min)))
+    if year_max is not None:
+        params.append(("year_to", str(year_max)))
+    if mileage_min is not None:
+        params.append(("mileage_from", str(mileage_min)))
+    if mileage_max is not None:
+        params.append(("mileage_to", str(mileage_max)))
+    if fuel:
+        params.append(("fuel", _resolve_fuel(fuel)))
+    if transmission:
+        params.append(("transmission", _resolve_transmission(transmission)))
+    if sort:
+        params.append(("sort", sort))
+
+    r = httpx.get(CAR_SEARCH_URL, params=params, headers=HEADERS, timeout=15, follow_redirects=True)
+    r.raise_for_status()
+    return r.json()
+
+
+def search_boats(
+    query: str,
+    *,
+    location: str | None = None,
+    price_min: int | None = None,
+    price_max: int | None = None,
+    length_min: int | None = None,
+    length_max: int | None = None,
+    sort: str | None = None,
+    page: int = 1,
+) -> dict:
+    """Search used boats on Blocket."""
+    params: list[tuple[str, str]] = [("q", query), ("page", str(page))]
+    if location:
+        params.append(("location", _resolve_location(location)))
+    if price_min is not None:
+        params.append(("price_from", str(price_min)))
+    if price_max is not None:
+        params.append(("price_to", str(price_max)))
+    if length_min is not None:
+        params.append(("length_feet_from", str(length_min)))
+    if length_max is not None:
+        params.append(("length_feet_to", str(length_max)))
+    if sort:
+        params.append(("sort", sort))
+
+    r = httpx.get(BOAT_SEARCH_URL, params=params, headers=HEADERS, timeout=15, follow_redirects=True)
+    r.raise_for_status()
+    return r.json()
+
+
+def search_mc(
+    query: str,
+    *,
+    location: str | None = None,
+    price_min: int | None = None,
+    price_max: int | None = None,
+    year_min: int | None = None,
+    year_max: int | None = None,
+    mileage_min: int | None = None,
+    mileage_max: int | None = None,
+    sort: str | None = None,
+    page: int = 1,
+) -> dict:
+    """Search used motorcycles on Blocket."""
+    params: list[tuple[str, str]] = [("q", query), ("page", str(page))]
+    if location:
+        params.append(("location", _resolve_location(location)))
+    if price_min is not None:
+        params.append(("price_from", str(price_min)))
+    if price_max is not None:
+        params.append(("price_to", str(price_max)))
+    if year_min is not None:
+        params.append(("year_from", str(year_min)))
+    if year_max is not None:
+        params.append(("year_to", str(year_max)))
+    if mileage_min is not None:
+        params.append(("mileage_from", str(mileage_min)))
+    if mileage_max is not None:
+        params.append(("mileage_to", str(mileage_max)))
+    if sort:
+        params.append(("sort", sort))
+
+    r = httpx.get(MC_SEARCH_URL, params=params, headers=HEADERS, timeout=15, follow_redirects=True)
+    r.raise_for_status()
+    return r.json()