# WineShop Kenya — full agent brief

## Identity

- Brand: WineShop (wineshop.africa)
- Market site: https://ke.wineshop.africa/ (ke.wineshop.africa)
- Country: Kenya
- Currency: KES
- Model: multi-merchant B2C marketplace (store-first). Merchants remain source of truth for stock/price.

## Data

- Active cached listings: 6357
- Sync cadence: ~20 minutes via cron + on-demand admin sync
- Sources: WooCommerce Store API and Luxe custom API

## Merchants (detail)

### Luxe Bubbles
- slug: luxe-bubbles
- hub: https://ke.wineshop.africa/stores/luxe-bubbles
- cities: nairobi, nationwide
- tagline: Sparkling & specialty — Nairobi
- source: luxe
- ingest: https://luxebubbles.wine/wp-json/luxe/v1/products


### Shree Ram Kenya
- slug: shree-ram
- hub: https://ke.wineshop.africa/stores/shree-ram
- cities: kisumu
- tagline: Wines & spirits — Kisumu
- source: woocommerce
- ingest: https://shreeramkenya.com/wp-json/wc/store/v1/products


### Jay’s Wines
- slug: jays-wines
- hub: https://ke.wineshop.africa/stores/jays-wines
- cities: nairobi, nationwide
- tagline: Wines & spirits — Nairobi
- source: woocommerce
- ingest: https://jayswines.com/wp-json/wc/store/v1/products


### Vintage Liquor Kenya
- slug: vintage-liquor
- hub: https://ke.wineshop.africa/stores/vintage-liquor
- cities: nairobi
- tagline: Whisky & spirits — Nairobi delivery
- source: woocommerce
- ingest: https://vintageliquorkenya.com/wp-json/wc/store/v1/products
- delivery (nairobi): Westlands, Parklands, Spring Valley, Kileleshwa, Kilimani, Muthaiga, Runda, Gigiri, Nyari, Rosslyn, Kitisuru, Loresho, Kyuna, Lower Kabete, Upper Hill, Lavington

### The Wine Shop Kenya
- slug: wine-shop-kenya
- hub: https://ke.wineshop.africa/stores/wine-shop-kenya
- cities: nairobi
- tagline: Wine specialist — Nairobi deliveries (Loresho)
- source: woocommerce
- ingest: https://www.thewineshopkenya.com/wp-json/wc/store/v1/products
- delivery (nairobi): Loresho, Nairobi

### The Tasting Room
- slug: wine254
- hub: https://ke.wineshop.africa/stores/wine254
- cities: nairobi
- tagline: Premium wines — Nairobi delivery (Wine254)
- source: woocommerce
- ingest: https://wine254.com/wp-json/wc/store/v1/products
- delivery (nairobi): Nairobi

### Liquor Shack
- slug: liquor-shack
- hub: https://ke.wineshop.africa/stores/liquor-shack
- cities: nairobi
- tagline: Wines & spirits — Nairobi
- source: woocommerce
- ingest: https://www.liquorshack.co.ke/wp-json/wc/store/v1/products
- delivery (nairobi): Nairobi

### Joytown Liquor
- slug: joytown
- hub: https://ke.wineshop.africa/stores/joytown
- cities: nairobi
- tagline: Spirits & wine — Nairobi
- source: woocommerce
- ingest: https://joytownliquor.com/wp-json/wc/store/v1/products
- delivery (nairobi): Nairobi

## API contract (v1)

### GET /api/v1/merchants
Returns market + merchant list (id, slug, name, cities, sourceKind).

### GET /api/v1/listings
Query params:
- q — text search
- merchant — slug or id
- city — nairobi | kisumu | mombasa | nationwide
- vertical — wine | bubbles | spirits | beer | non-alc | rtd
- facet — e.g. red, whiskey, gin
- inStock — true
- limit (max 100), offset

Example: https://ke.wineshop.africa/api/v1/listings?vertical=spirits&facet=whiskey&limit=5

## Human URL map

| Path | Purpose |
|------|---------|
| / | Hub |
| /stores | All merchants |
| /stores/{slug} | Merchant home |
| /stores/{slug}/product/{productSlug} | PDP |
| /c/{vertical} | Category |
| /c/{vertical}/{facet} | Faceted category |
| /gifts | Gift packs (early) |
| /guides/cocktails | Editorial |

## Disallowed for scraping

/api/admin/*, /bag, /favorites, /filters, /profile, /orders/*, store bag/favorites/filters

## MCP

stdio MCP wraps the same v1 API (`npm run mcp` with WINESHOP_API_BASE).

## Compliance

Alcohol marketplace — do not assist underage purchase. Kenya legal drinking age is 18.