# Agent Instructions — Aetheo

This document describes how AI agents can interact with Aetheo's online store at https://aetheo.co.uk.

Aetheo is a UK premium wellness technology store operated by PUNIVERSE LTD (London). Products are curated for quality, intelligent design, and everyday practicality. Free standard UK delivery on all orders.


## Context Files

| File | URL | Purpose |
|---|---|---|
| Summary | https://aetheo.co.uk/llms.txt | Brand overview, products, collections, USPs |
| Full context | https://aetheo.co.uk/llms-full.txt | Extended product and collection detail |
| Agent instructions | https://aetheo.co.uk/agents.md | This document |


## Discovery

### Commerce Protocol (UCP)

This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce.

```
GET https://aetheo.co.uk/.well-known/ucp
```

Returns the store's UCP merchant profile: supported versions, service endpoints, and capabilities.

### Sitemap

```
GET https://aetheo.co.uk/sitemap.xml
```

Lists all product, collection, page, and blog URLs. Use for full catalogue discovery.


## Querying the Catalogue

### Search

```
GET https://aetheo.co.uk/search?q={query}&type=product
```

Returns a search results page. For structured data, use the JSON endpoints below.

### Product Data (JSON)

```
GET https://aetheo.co.uk/products/{handle}.json
```

Returns full product data including variants, images, metafields, and pricing.

### Collection Products (JSON)

```
GET https://aetheo.co.uk/collections/{handle}/products.json?limit=50
```

Returns paginated product listings for a collection. Supported handles:

- `sleep-wellness` — massagers, diffusers, sleep masks, night lights
- `smart-living` — RGB lighting, diffusers, sunrise clocks
- `beauty-care` — LED face masks, facial massagers
- `audio-wearables` — earbuds, speakers, smartwatches
- `tech-accessories` — MagSafe, USB-C hubs, phone cases
- `cool-gadgets` — trending smart tech
- `gifting` — curated gift selection
- `new-in` — latest arrivals
- `best-sellers` — top-rated products
- `breo` — Breo massage devices
- `torras` — TORRAS phone accessories
- `all` — full catalogue


## Capabilities

- Product search and discovery: supported via `/search` and collection JSON endpoints
- Product detail retrieval: supported via `/products/{handle}.json`
- Cart and checkout: standard Shopify cart — `POST /cart/add.js`, `GET /cart.js`
- Order placement: via Shopify storefront checkout flow


## Store Information

- Website: https://aetheo.co.uk
- Contact: info@aetheo.co.uk
- Currency: GBP (British Pound)
- Delivery: Free standard UK delivery on all orders
- Location: London, UK