whcli 🏠

Willhaben CLI - Command-line interface for willhaben.at, Austria's largest classifieds marketplace.

Features

• 🔍 Search - Find listings with filters (category, price, condition, location)
• 📋 Details - View listing details, seller info, images
• 👤 Seller - View seller profiles and ratings
• 📊 Formats - Output as table, JSON, or CSV

Installation

# Using Homebrew (recommended)
brew install pasogott/tap/whcli

# Or from source with uv
git clone https://github.com/pasogott/whcli.git
cd whcli
uv sync

Quick Start

# Search for RTX graphics cards
whcli search "rtx 4090" --category grafikkarten --max-price 1500

# View listing details
whcli show 1993072190

# View seller profile
whcli seller 29159134

# Output as JSON for scripting
whcli search "iphone" --format json

Commands

Search

whcli search <query> [OPTIONS]

Options:
  -c, --category TEXT     Category slug (grafikkarten, smartphones, etc.)
  --min-price FLOAT       Minimum price in EUR
  --max-price FLOAT       Maximum price in EUR
  --condition TEXT        Item condition (neu, gebraucht, defekt, neuwertig)
  -l, --location TEXT     Location/region filter
  -n, --rows INTEGER      Number of results [default: 30]
  -p, --page INTEGER      Page number [default: 1]
  --paylivery             Only PayLivery listings
  -f, --format [table|json|csv]  Output format [default: table]

Show

whcli show <AD_ID> [OPTIONS]

Options:
  -f, --format [table|json|csv]  Output format [default: table]

Seller

whcli seller <USER_ID> [OPTIONS]

Options:
  -f, --format [table|json|csv]  Output format [default: table]

Development

# Clone and setup
git clone https://github.com/pasogott/whcli.git
cd whcli
uv sync

# Run tests
uv run pytest

# Run linting
uv run ruff check .
uv run ruff format --check .

# Run type checking
uv run mypy src/

# Run the CLI
uv run whcli --help

License

MIT License - see LICENSE for details.

Disclaimer

This tool is for personal use. Please respect willhaben.at's terms of service and use responsibly with rate limiting.