tradera-cli 0.1.0__py3-none-any.whl

tradera_cli/__init__.py

@@ -0,0 +1,2 @@
+__all__ = ["__version__"]
+__version__ = "0.1.0"

tradera_cli/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

tradera_cli/api.py

@@ -0,0 +1,137 @@
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+from typing import Any
+
+import requests
+from requests import RequestException
+
+
+BASE_URL = "https://www.tradera.com"
+
+
+class TraderaApiError(RuntimeError):
+    pass
+
+
+@dataclass
+class TraderaClient:
+    base_url: str = BASE_URL
+    timeout_seconds: int = 20
+
+    def __post_init__(self) -> None:
+        self.session = requests.Session()
+        self.session.headers.update(
+            {
+                "accept": "application/json, text/plain, */*",
+                "user-agent": "tradera-cli/0.1.0",
+            }
+        )
+
+    def _request(self, method: str, path: str, **kwargs: Any) -> Any:
+        headers = dict(kwargs.pop("headers", {}))
+        if "json" in kwargs:
+            headers.setdefault("content-type", "application/json")
+
+        needs_token = path.startswith("/api/webapi/") or path.startswith("/ajax/")
+        if needs_token and path != "/api/webapi/auth/web/client/token":
+            self._ensure_client_token()
+
+        url = f"{self.base_url}{path}"
+        try:
+            response = self.session.request(method, url, timeout=self.timeout_seconds, headers=headers, **kwargs)
+        except RequestException as exc:
+            raise TraderaApiError(f"Request failed for {path}: {exc}") from exc
+
+        if response.status_code in {400, 401} and needs_token:
+            self._ensure_client_token(force=True)
+            try:
+                response = self.session.request(method, url, timeout=self.timeout_seconds, headers=headers, **kwargs)
+            except RequestException as exc:
+                raise TraderaApiError(f"Request retry failed for {path}: {exc}") from exc
+
+        if response.status_code >= 400:
+            raise TraderaApiError(f"{response.status_code} {response.reason}: {path}")
+        content_type = response.headers.get("content-type", "")
+        if "application/json" in content_type:
+            try:
+                return response.json()
+            except ValueError as exc:
+                raise TraderaApiError(f"Invalid JSON response from {path}") from exc
+        return response.text
+
+    def _ensure_client_token(self, force: bool = False) -> None:
+        if not force and self.session.cookies.get("trd_at"):
+            return
+        try:
+            response = self.session.post(
+                f"{self.base_url}/api/webapi/auth/web/client/token",
+                timeout=self.timeout_seconds,
+                headers={"content-type": "application/json", "accept": "application/json"},
+            )
+        except RequestException as exc:
+            raise TraderaApiError(f"Failed to establish anonymous client token: {exc}") from exc
+        if response.status_code >= 400:
+            raise TraderaApiError("Failed to establish anonymous client token")
+
+    def search(
+        self,
+        query: str,
+        page: int = 1,
+        page_size: int = 50,
+        sort_by: str = "Relevance",
+        language_code_iso2: str = "sv",
+        shipping_country_code_iso2: str = "SE",
+        automatic_translation_preferred: bool = True,
+    ) -> dict[str, Any]:
+        payload: dict[str, Any] = {
+            "isCsaSearchQuery": False,
+            "query": query,
+            "page": page,
+            "pageSize": page_size,
+            "sortBy": sort_by,
+            "languageCodeIso2": language_code_iso2.lower(),
+            "shippingCountryCodeIso2": shipping_country_code_iso2.upper(),
+            "automaticTranslationPreferred": automatic_translation_preferred,
+            "attributeFilters": [],
+            "categoryPath": [],
+            "currentCategoryId": 0,
+            "filterCounties": None,
+            "filterCategories": {},
+            "filterPrice": {},
+            "filters": {},
+            "headerText": None,
+            "internalSearch": {"showSearchBar": False},
+            "introText": None,
+            "isSavedSearchEmailEnabled": False,
+            "isShopOwnedByCurrentMember": False,
+            "items": [],
+            "relatedItems": [],
+            "itemsOnDisplay": [],
+            "mainText": None,
+            "pagination": None,
+            "totalItems": 0,
+            "searchLanguages": [],
+            "itemsMatchedViewModel": None,
+            "suggestion": None,
+        }
+        return self._request("POST", "/api/webapi/discover/web/independent-search", json=payload)
+
+    def item(self, item_id: int) -> dict[str, Any]:
+        data = self._request("GET", f"/ajax/item/{item_id}")
+        if not isinstance(data, dict):
+            raise TraderaApiError(f"Unexpected item response for item {item_id}")
+        return data
+
+    def categories(self, level: int = 1, lang: str = "sv") -> Any:
+        return self._request("GET", f"/api/categories/{level}?languageCodeIso2={lang}&next=1")
+
+
+def parse_item_id(value: str) -> int:
+    if value.isdigit():
+        return int(value)
+    match = re.search(r"/(\d{6,})", value)
+    if not match:
+        raise ValueError(f"Could not parse item id from: {value}")
+    return int(match.group(1))

tradera_cli/cli.py

@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+import argparse
+import sys
+from typing import Any
+
+from .api import TraderaApiError, TraderaClient, parse_item_id
+from .formatters import (
+    normalize_categories_rows,
+    normalize_search_rows,
+    to_json,
+    to_jsonl,
+    to_table,
+)
+
+
+def _print_output(raw: Any, rows: list[dict[str, Any]], fmt: str, columns: list[str]) -> None:
+    if fmt == "json":
+        print(to_json(raw))
+        return
+    if fmt == "jsonl":
+        print(to_jsonl(rows))
+        return
+    print(to_table(rows, columns))
+
+
+def cmd_search(args: argparse.Namespace) -> int:
+    client = TraderaClient()
+    data = client.search(
+        query=args.query,
+        page=args.page,
+        page_size=args.page_size,
+        sort_by=args.sort,
+        language_code_iso2=args.lang,
+        shipping_country_code_iso2=args.country,
+        automatic_translation_preferred=not args.no_translate,
+    )
+    rows = normalize_search_rows(data)
+    _print_output(
+        raw=data,
+        rows=rows,
+        fmt=args.format,
+        columns=["itemId", "title", "price", "currency", "endDate", "url"],
+    )
+    return 0
+
+
+def cmd_item(args: argparse.Namespace) -> int:
+    client = TraderaClient()
+    item_id = parse_item_id(args.item)
+    data = client.item(item_id)
+    if args.format == "table":
+        row = {
+            "itemId": data.get("itemId") or data.get("id") or item_id,
+            "title": data.get("shortDescription") or data.get("title") or "",
+            "price": data.get("buyNowPrice") or data.get("nextBid") or data.get("price") or "",
+            "currency": data.get("currency") or "SEK",
+            "seller": (data.get("seller") or {}).get("alias") if isinstance(data.get("seller"), dict) else "",
+        }
+        print(to_table([row], ["itemId", "title", "price", "currency", "seller"]))
+    else:
+        print(to_json(data))
+    return 0
+
+
+def cmd_categories(args: argparse.Namespace) -> int:
+    client = TraderaClient()
+    data = client.categories(level=args.level, lang=args.lang)
+    rows = normalize_categories_rows(data)
+    _print_output(raw=data, rows=rows, fmt=args.format, columns=["id", "name", "level"])
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="tradera", description="Tradera CLI")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    search = subparsers.add_parser("search", help="Search listings")
+    search.add_argument("query", help="Search query")
+    search.add_argument("--page", type=int, default=1)
+    search.add_argument("--page-size", type=int, default=50)
+    search.add_argument("--sort", default="Relevance")
+    search.add_argument("--lang", default="sv")
+    search.add_argument("--country", default="SE")
+    search.add_argument("--no-translate", action="store_true")
+    search.add_argument("--format", choices=["table", "json", "jsonl"], default="table")
+    search.set_defaults(func=cmd_search)
+
+    item = subparsers.add_parser("item", help="Get item details")
+    item.add_argument("item", help="Item id or item URL")
+    item.add_argument("--format", choices=["table", "json"], default="json")
+    item.set_defaults(func=cmd_item)
+
+    categories = subparsers.add_parser("categories", help="List categories by level")
+    categories.add_argument("--level", type=int, default=1)
+    categories.add_argument("--lang", default="sv")
+    categories.add_argument("--format", choices=["table", "json", "jsonl"], default="table")
+    categories.set_defaults(func=cmd_categories)
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> None:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    try:
+        code = args.func(args)
+    except (TraderaApiError, ValueError) as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        raise SystemExit(2) from exc
+    raise SystemExit(code)

tradera_cli/formatters.py

@@ -0,0 +1,67 @@
+from __future__ import annotations
+
+import json
+from typing import Any
+
+
+def to_json(data: Any) -> str:
+    return json.dumps(data, ensure_ascii=False, indent=2)
+
+
+def to_jsonl(items: list[dict[str, Any]]) -> str:
+    return "\n".join(json.dumps(item, ensure_ascii=False) for item in items)
+
+
+def to_table(rows: list[dict[str, Any]], columns: list[str]) -> str:
+    if not rows:
+        return "No results"
+
+    widths = {column: len(column) for column in columns}
+    for row in rows:
+        for column in columns:
+            widths[column] = max(widths[column], len(str(row.get(column, ""))))
+
+    def line(values: list[str]) -> str:
+        return " | ".join(value.ljust(widths[col]) for value, col in zip(values, columns))
+
+    header = line(columns)
+    sep = "-+-".join("-" * widths[col] for col in columns)
+    body = [line([str(row.get(col, "")) for col in columns]) for row in rows]
+    return "\n".join([header, sep, *body])
+
+
+def normalize_search_rows(data: dict[str, Any]) -> list[dict[str, Any]]:
+    items = data.get("items") or data.get("result", {}).get("items") or []
+    rows: list[dict[str, Any]] = []
+    for item in items:
+        rows.append(
+            {
+                "itemId": item.get("itemId") or item.get("id"),
+                "title": item.get("shortDescription") or item.get("title") or "",
+                "price": item.get("buyNowPrice") or item.get("nextBid") or item.get("price") or "",
+                "currency": item.get("currency") or "SEK",
+                "endDate": item.get("endDate") or item.get("endTime") or "",
+                "url": item.get("itemUrl") or item.get("itemLink") or "",
+            }
+        )
+    return rows
+
+
+def normalize_categories_rows(data: Any) -> list[dict[str, Any]]:
+    if isinstance(data, dict):
+        categories = data.get("categories") or data.get("items") or []
+    elif isinstance(data, list):
+        categories = data
+    else:
+        categories = []
+
+    rows: list[dict[str, Any]] = []
+    for category in categories:
+        rows.append(
+            {
+                "id": category.get("id") or category.get("categoryId"),
+                "name": category.get("name") or category.get("title") or "",
+                "level": category.get("level") or "",
+            }
+        )
+    return rows

tradera_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: tradera-cli
+Version: 0.1.0
+Summary: CLI for Tradera web endpoints
+Author: Johnny W
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Paatsu/tradera-cli
+Project-URL: Repository, https://github.com/Paatsu/tradera-cli
+Project-URL: Issues, https://github.com/Paatsu/tradera-cli/issues
+Keywords: cli,tradera,marketplace,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.32.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2.2; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: twine>=5.1.1; extra == "dev"
+Dynamic: license-file
+
+# tradera-cli
+
+Fast CLI for searching public Tradera listings from the terminal.
+
+Designed for scripts, agents, and quick lookups with structured output.
+
+## Install
+
+From PyPI:
+
+```bash
+pip install tradera-cli
+```
+
+With `uv`:
+
+```bash
+uv tool install tradera-cli
+```
+
+With `pipx`:
+
+```bash
+pipx install tradera-cli
+```
+
+Upgrade:
+
+```bash
+pip install --upgrade tradera-cli
+```
+
+## Usage
+
+### Search listings
+
+```bash
+tradera search "iphone"
+tradera search "pokemon" --page 2 --page-size 20
+tradera search "kamera" --sort AddedOn --format json
+tradera search "klocka" --country SE --lang sv --format jsonl
+```
+
+### Get item details
+
+```bash
+tradera item 717898129
+tradera item 717898129 --format json
+tradera item "https://www.tradera.com/item/340186/717885898/iphone-12-pro"
+```
+
+### Browse categories
+
+```bash
+tradera categories --level 1
+tradera categories --level 2 --lang sv --format json
+```
+
+## Output formats
+
+| Format | Description | Best for |
+|---|---|---|
+| `table` (default) | Human-readable table | Interactive terminal use |
+| `json` | Pretty JSON object | `jq`, scripts, integrations |
+| `jsonl` | One JSON object per line | Streaming/log pipelines |
+
+## Common options
+
+Search command (`tradera search`) supports:
+
+| Option | Description |
+|---|---|
+| `--page` | Page number (default: `1`) |
+| `--page-size` | Results per page (default: `50`) |
+| `--sort` | Sort mode (default: `Relevance`) |
+| `--lang` | Language code (default: `sv`) |
+| `--country` | Shipping country code (default: `SE`) |
+| `--no-translate` | Disable automatic translation preference |
+| `--format` | Output format: `table`, `json`, `jsonl` |
+
+## Development
+
+From source:
+
+```bash
+git clone https://github.com/Paatsu/tradera-cli.git
+cd tradera-cli
+pip install -e .[dev]
+```
+
+Build distributions:
+
+```bash
+python -m build
+```
+
+Check the package metadata before upload:
+
+```bash
+python -m twine check dist/*
+```
+
+Run tests:
+
+```bash
+pytest -q
+```
+
+## Agent integration
+
+Examples for automation:
+
+```bash
+# Take first 3 listings as JSON
+tradera search "iphone" --format json | jq '.items[:3]'
+
+# Stream listings line-by-line
+tradera search "lego" --format jsonl
+
+# Pull one item as machine-readable JSON
+tradera item 717898129 --format json
+```
+
+## Notes
+
+- Uses web endpoints from Tradera's frontend.
+- Anonymous client token is fetched automatically when needed.
+- Endpoint behavior can change over time.

tradera_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+tradera_cli/__init__.py,sha256=tXbRXsO0NE_UV1kIHiZTTQQH0fj0U2KoxxNusu_gzrM,48
+tradera_cli/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
+tradera_cli/api.py,sha256=rGJExNV7tq3z8TrHdAmbVmxw47lStG91k-KVREnvEhc,5047
+tradera_cli/cli.py,sha256=IB0vvV6ctqCO7UskXDJyNVn59C-qVfDN9q-L6-eX0KU,3874
+tradera_cli/formatters.py,sha256=ZGyHycffhHqc3Vm88nwp5ZR_1lyjOOsOlxuiG3bR77U,2287
+tradera_cli-0.1.0.dist-info/licenses/LICENSE,sha256=JlB4zqH_oJ1H4a4kkasUxorVnIpVRo-t3DRvU5akaro,1065
+tradera_cli-0.1.0.dist-info/METADATA,sha256=5hfLNvwKshJMHEDKN0w8zm-QxAGDOuwfUBqPNYtaYoQ,3501
+tradera_cli-0.1.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+tradera_cli-0.1.0.dist-info/entry_points.txt,sha256=eC23nFxJkduOjEPhI7FGLWRFFh489gje8G6IlQN296M,49
+tradera_cli-0.1.0.dist-info/top_level.txt,sha256=v7bZc-4QcMWcBOk4BwP3g_29soHfURhh2P1HCxZTA_E,12
+tradera_cli-0.1.0.dist-info/RECORD,,

tradera_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tradera_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tradera = tradera_cli.cli:main

tradera_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Johnny W
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tradera_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+tradera_cli