# 🦐 NaruEvi-chan Family Restaurant — Agent Skills

## Overview
This restaurant provides a REST API for AI agents to browse the menu and place orders.
Base URL: `https://naruevi-famires.hentai-naru-sensei.workers.dev`

---

## Skills

### 1. Get Menu
Fetch the full menu, optionally filtered by category and sorted by rating or price.

```
GET /api/menu
GET /api/menu?category={category}&sort={sort}&lang={lang}
```

**Parameters:**
| Name | Type | Values | Description |
|------|------|--------|-------------|
| category | string | `drink` `food` `dessert` | Filter by category |
| sort | string | `rating` `price` | Sort order |
| lang | string | `ja` `en` `zh` | Response language (default: `ja`) |

**Example request:**
```
GET /api/menu?category=food&sort=rating&lang=en
```

**Example response:**
```json
[
  {
    "id": 5,
    "category": "food",
    "price": 1080,
    "rating": 4.9,
    "name": "Fried Shrimp Set",
    "description": "3 crispy fried shrimps (NaruEvi's top pick 🦐)"
  },
  ...
]
```

---

### 2. Place Order
Submit an order by providing item IDs.

```
POST /api/order
Content-Type: application/json
```

**Request body:**
```json
{
  "items": [1, 5, 8],
  "note": "Ordered by NaruEvi 🦐",
  "lang": "en"
}
```

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| items | number[] | ✅ | Array of menu item IDs |
| note | string | ❌ | Order note / agent name |
| lang | string | ❌ | Language for response messages |

**Example response:**
```json
{
  "orderId": "ord_abc123",
  "items": ["Draft Beer", "Fried Shrimp Set", "Karaage Set"],
  "total": 2580,
  "message": "🦐 Order received!"
}
```

---

### 3. Get Order History
Retrieve all orders placed in this session.

```
GET /api/orders
```

**Example response:**
```json
[
  {
    "id": "ord_abc123",
    "items": [1, 5, 8],
    "total": 2580,
    "note": "Ordered by NaruEvi 🦐",
    "createdAt": "2026/5/3 10:30:00"
  }
]
```

---

## Menu Item IDs

| ID | Name (EN) | Category | Price |
|----|-----------|----------|-------|
| 1 | Draft Beer | drink | ¥550 |
| 2 | Oolong Tea | drink | ¥280 |
| 3 | Cola | drink | ¥280 |
| 4 | Hamburg Steak Lunch | food | ¥980 |
| 5 | Fried Shrimp Set ⭐ | food | ¥1080 |
| 6 | Pizza Toast | food | ¥680 |
| 7 | Omurice | food | ¥880 |
| 8 | Karaage Set | food | ¥950 |
| 9 | Pudding à la Mode | dessert | ¥580 |
| 10 | Soft Serve Ice Cream | dessert | ¥350 |

---

## Reference: Saizeriya Official API Items (Scanned)
> Real menu items from Saizeriya's official ordering system (ioes.saizeriya.co.jp)
> Scanned IDs 1000–2000. Use as reference data for real-world restaurant API integration.

### Lunch (ランチ)
| ID | Name (JA) | Price |
|----|-----------|-------|
| 1110 | ほうれん草とパンチェッタのスパゲッティ | ¥500 |
| 1115 | スパゲッティポモドーロ | ¥500 |
| 1135 | タラコソースシシリー風 | ¥500 |
| 1160 | タラコとエビのドリア | ¥500 |
| 1920 | 牛オニオンハンバーグ | ¥600 |
| 1921 | 牛オニオンハンバーグ（ライス大） | ¥650 |
| 1922 | 牛オニオンハンバーグ（ライス小） | ¥550 |
| 1930 | 牛デミハンバーグ | ¥600 |
| 1931 | 牛デミハンバーグ（ライス大） | ¥650 |
| 1932 | 牛デミハンバーグ（ライス小） | ¥550 |

### Salad (サラダ)
| ID | Name (JA) | Price |
|----|-----------|-------|
| 1202 | 小エビのサラダ | ¥350 |
| 1203 | チキンのサラダ | ¥350 |
| 1205 | わかめのサラダ | ¥350 |
| 1207 | モッツァレラのサラダ | ¥400 |
| 1208 | グリーンサラダ（ラペ入り） | ¥350 |
| 1413 | にんじんサラダ | ¥200 |
| 1425 | 青豆とペコリーノの温サラダ | ¥200 |

### Soup (スープ)
| ID | Name (JA) | Price |
|----|-----------|-------|
| 1301 | コーンクリームスープ | ¥150 |
| 1303 | 冷たいパンプキンスープ | ¥150 |
| 1305 | 田舎風ミネストローネ | ¥300 |
| 1307 | たまねぎのズッパ | ¥300 |

### Antipasto / Side (前菜・サイド)
| ID | Name (JA) | Price |
|----|-----------|-------|
| 1401 | 辛味チキン | ¥300 |
| 1402 | アロスティチーニ | ¥400 |
| 1403 | ほうれん草のソテー | ¥200 |
| 1404 | ポップコーンシュリンプ | ¥300 |
| 1405 | エスカルゴのオーブン焼き | ¥400 |
| 1406 | 小エビのカクテル | ¥280 |
| 1407 | チョリソー | ¥400 |
| 1408 | 鶏ささみの香味ソース | ¥280 |
| 1410 | ムール貝のガーリック焼き | ¥400 |
| 1415 | カリっとポテト | ¥280 |
| 1420 | バッファローモッツァレラ | ¥300 |
| 1452 | アロスティチーニ（ダブルサイズ） | ¥800 |
| 1470 | バッファローモッツァレラ（Wサイズ） | ¥600 |

---

## Quick Start for Agents

```javascript
// Step 1: Get top-rated food items
const menu = await fetch('https://naruevi-famires.hentai-naru-sensei.workers.dev/api/menu?category=food&sort=rating&lang=en').then(r => r.json());

// Step 2: Order the top 3
const top3 = menu.slice(0, 3).map(i => i.id);
const order = await fetch('https://naruevi-famires.hentai-naru-sensei.workers.dev/api/order', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ items: top3, note: 'Ordered by AI Agent 🤖', lang: 'en' })
}).then(r => r.json());

console.log(order.message); // 🦐 Order received!
```

---

*🦐 NaruEvi-chan Family Restaurant — powered by Cloudflare Workers*
*[@NullEvi03](https://x.com/NullEvi03)*