willhaben

# Willhaben Listing Creator

Create listings on Willhaben.at via browser automation.

## First-Time Setup

Check if `config/user-preferences.json` exists in the skill folder.
- If missing → run setup flow (see `references/SETUP.md`)
- If exists → read preferences and apply to all listings

User preferences include: location, shipping, description style, pricing strategy, disclaimers.

## Workflow

### 1. Receive Item Details
- User sends photos (via WhatsApp/chat)
- Optional: user provides details (condition, category, price range)

### 2. Market Research
Before suggesting a price, search Willhaben for similar/identical items:
- Search willhaben.at for the item
- Note price range of comparable listings
- Check sold prices if available
- Report findings to user:
  - **Neupreis** (new price)
  - **Marktpreis** (what similar items are listed for)
  - **Empfohlener Preis** (recommended selling price)

### 3. Generate Listing
- Analyze photos to understand the item
- Generate:
  - **Title**: Concise, searchable (German)
  - **Description**: SHORT and casual - real people don't write essays. 2-3 sentences max. Mention key facts only.
  - **Price**: Based on market research, suggest realistic price
  - **Package size**: Estimate weight category for shipping (3kg / 10kg / 31.5kg)
- Ask user:
  - Location (Bezirk) - if not in preferences
  - Any damage/issues to mention
  - If they want a more detailed description (default: no)
- Present draft for confirmation **including package size estimate**

### Listing Summary Template
Show the user something like:
```
📝 Listing Draft

Title: [title]
Description: [description]
Price: €XX VB
Location: [location]
Pickup: ✅ / Shipping: ✅

📦 Package: ~Xkg (selecting [size] package)
   → If wrong, let me know!

Photos: X attached

Ready to post?
```

If package weight is unclear (e.g., unusual item), **ask the user** rather than guessing wrong.

### 4. Post to Willhaben
See detailed browser automation steps below.

## Description Style...