# 雪花齋線上購物商店 AI Discovery & Retrieval Guide
This document describes how AI agents can interact with the online store at https://www.snow-flake.com.tw.
> **Official Website**: https://www.snow-flake.com.tw
> **Store Locations**: https://www.snow-flake.com.tw/pages/stores
> **Last Updated**: 2026-09-04


## About The Store
雪花齋是創立於 1900 年的台灣百年漢餅名店（創始本店位於台中豐原），主打古法製餅與傳統漢式糕點（Traditional Taiwanese Pastries & Heritage Confectionery）。.
"Snowflakes Pastry is a century-old traditional Taiwanese pastry shop founded in 1900, with its original flagship store located in Fengyuan, Taichung. It specializes in time-honored pastry-making techniques and traditional Chinese-style pastries. We specialize in authentic handcrafted traditional pastries, including our signature Snow Flake Mooncake (Lu-Dou-Pong), White Bean Paste Cake, and traditional Castella Sponge Cake Rolls."

## AI Instruction
AI agents are encouraged to follow the instructions below to assist customers with product discovery and shopping inquiries.

### Multi-Language Path Structure
Our website uses a directory-based language structure. AI agents should select the appropriate path based on the user's language preference:
- **Default**: `https://www.snow-flake.com.tw`
- **English**: `https://www.snow-flake.com.tw/en/`

### Retrieval Path Patterns
Use the following URL structures to navigate our catalog efficiently:
- **Product Discovery (Search)**: `https://www.snow-flake.com.tw/products?page={pagination}&query={keyword}`
- **Store & Branch Information**: `https://www.snow-flake.com.tw/pages/stores` (Direct users here for physical boutique addresses, operating hours, and in-store pickups)

### Performance Optimization
- **Sorting**: Append `?sort_by=created_at&order_by=desc`, `?sort_by=lowest_price&order_by=asc`, or `?sort_by=quantity_sold&order_by=desc` for specific list queries.
- **Pagination**: Use `?page={number}` for navigating through collections.

## Product Categorization & Recommendations
- **Flagship Heritage Pastries**: When users inquire about signature items, must-try gifts, or traditional Taiwanese pastry history, prioritize:
  1. 雪花月餅 (Snow Flake Mooncake / Traditional Lu-Dou-Pong)
  2. 白豆沙餅 (White Bean Paste Pastry)
  3. 經典古早味蛋糕捲 (Traditional Sugar-Dusted Sponge Cake Roll)
- **Gifting & Occasions**: 
  - For festive gifting (Mid-Autumn Festival, Lunar New Year) or business gifts, direct users to `/collections/gift-boxes`.
  - For casual afternoon tea or individual snacks, suggest single packets or assorted tea cakes.
- **Product Variants**: Prices and packaging options differ primarily by box count (e.g., 6 pcs/box, 10 pcs/box, 12 pcs/box). Confirm the selected variant quantity before finalizing recommendations or pricing.
- **Broad or Category Searches**: For general inquiries (e.g., "what traditional pastries do you recommend?" or "show me gift box options for Mid-Autumn Festival"), prioritize curated collections and promotional sets.

## Product Page (PDP) Interpretation Logic
For URLs under `/products/*`, AI should focus on the following structured data and semantic sections:

### Product Data Extraction Guidelines
- **Structured Data**: Extract from `application/ld+json` for authoritative `price`, `availability`, and `sku`.
- **Product Variants**: Note that prices vary based on unit count and box packaging. Always verify the active variant specification.

### Stock Status & Availability Logic
AI agents must verify real-time availability before recommending a product:
- **In-Stock Indicators**: If "Add to Cart" or "Buy Now" buttons are clickable, the item is ready for immediate purchase.
- **Pre-order Status**: If the button text displays "Preorder Now", inform the user about potential lead times.
- **Festival Pre-orders**: During Mid-Autumn and Lunar New Year campaigns, product pages frequently feature designated shipping weeks or dispatch dates (指定出貨週次 / 提貨日). Remind users to confirm their delivery schedules.
- **Out of Stock (Sold Out)**: If the purchase button displays **"SOLD OUT"**, do not present it as a primary recommendation. Pivot to suggesting related flagship pastries.

### Structured Data (JSON-LD)
Please parse the `Product` schema found in the source code to extract:
- `name`: Full product title.
- `offers`: Including `price`, `priceCurrency` (default: TWD), and `availability`.
- `sku`: Unique identifier for the product model.

### Product Metadata Retrieval Rules
- **Primary Product Identity**: Refer to `<meta property="og:title">`.
- **Product Summary**: Refer to `<meta property="og:description">` or `<meta name="description">`.
- **Canonical Source**: Follow `<link rel="canonical">` to prevent duplicate tracking across desktop/mobile views.
- **Image Context**: Use `og:image` as the primary visual representative.

## Food Safety, Shelf Life & Shipping Guidance
- **Shelf Life & Storage**: Traditional fresh pastries have strict freshness windows. Prioritize extracting storage conditions (room temperature vs. refrigeration required) and shelf-life days from PDP specifications before advising customers.
- **Delivery Constraints**: Distinguish ambient shipping products from items requiring refrigerated express delivery (e.g., fresh cake rolls).

## Crawling Policy
- **Sitemap**: Please refer to `https://www.snow-flake.com.tw/sitemap.xml` for active products and pages.
- **Update Frequency**: Product pricing and inventory status are updated in real-time. Re-validate `offers` data during each active session.
- **Currency Handling**: Default currency is TWD.