Slim JSON output for agent-friendly context (~6x smaller)

Strip listings to essential fields (id, heading, price, location, url,
date, brand) by default. Full API response available via --raw flag.

Author: lennart-johansson

blocket_cli/cli.py

@@ -30,7 +30,8 @@ def main():
 @click.option("-n", "--limit", type=int, help="Max results to show")
 @click.option("-p", "--page", type=int, default=1, help="Page number")
 @click.option("-o", "--output", type=click.Choice(["table", "json", "jsonl"]), default="table", help="Output format")
-def search(query: str, location: str | None, category: str | None, price_min: int | None, price_max: int | None, sort: str | None, limit: int | None, page: int, output: str):
+@click.option("--raw", is_flag=True, help="Output full API response (default: slim agent-friendly fields)")
+def search(query: str, location: str | None, category: str | None, price_min: int | None, price_max: int | None, sort: str | None, limit: int | None, page: int, output: str, raw: bool):
     """Search listings on Blocket.
 
     \b
@@ -46,7 +47,7 @@ def search(query: str, location: str | None, category: str | None, price_min: in
             price_min=price_min, price_max=price_max,
             sort=sort_map.get(sort, sort) if sort else None, page=page,
         )
-        format.print_results(data, output=output, limit=limit)
+        format.print_results(data, output=output, limit=limit, raw=raw)
     except Exception as e:
         click.echo(f"Error: {e}", err=True)
         sys.exit(1)

blocket_cli/format.py

@@ -4,14 +4,35 @@
 
 import json
 import sys
+from datetime import datetime, timezone
 from typing import Any
 
 
 def _json_compact(data: Any) -> str:
     return json.dumps(data, ensure_ascii=False, separators=(",", ":"))
 
 
-def print_results(data: dict, *, output: str = "table", limit: int | None = None) -> None:
+def _slim(doc: dict) -> dict:
+    """Strip a listing to agent-essential fields."""
+    price = doc.get("price", {})
+    out: dict[str, Any] = {
+        "id": doc.get("id"),
+        "heading": doc.get("heading"),
+        "price": price.get("amount"),
+        "currency": price.get("currency_code", "SEK"),
+        "location": doc.get("location"),
+        "url": doc.get("canonical_url"),
+    }
+    ts = doc.get("timestamp")
+    if ts:
+        out["date"] = datetime.fromtimestamp(ts / 1000, tz=timezone.utc).strftime("%Y-%m-%d")
+    for extra in doc.get("extras", []):
+        if extra.get("id") == "brand" and extra.get("values"):
+            out["brand"] = extra["values"][0]
+    return out
+
+
+def print_results(data: dict, *, output: str = "table", limit: int | None = None, raw: bool = False) -> None:
     """Print search results."""
     docs = data.get("docs", [])
     total = data.get("metadata", {}).get("result_size", {}).get("match_count", len(docs))
@@ -20,12 +41,13 @@ def print_results(data: dict, *, output: str = "table", limit: int | None = None
         docs = docs[:limit]
 
     if output == "json":
-        print(_json_compact({"total": total, "results": docs}))
+        results = docs if raw else [_slim(d) for d in docs]
+        print(_json_compact({"total": total, "results": results}))
         return
 
     if output == "jsonl":
         for doc in docs:
-            print(_json_compact(doc))
+            print(_json_compact(doc if raw else _slim(doc)))
         return
 
     if not docs: