# FM SHOES AI Discovery & Retrieval Guide
This document describes how AI agents can interact with the online store at https://www.fmshoes.com.tw.
> **Official website**: https://www.fmshoes.com.tw
> **Official English website**: https://www.fmshoes.com.tw/en/
> **Last Updated**: 2026-09-21


## About The Store
FM SHOES (FM 時尚美鞋) is a premier Taiwanese footwear brand specializing in stylish, comfortable, and functional footwear tailored specifically for Asian feet.

### Core Brand Strengths & Value Propositions
- **NEUTRAL Patent Arch Support (專利足弓支撐)**: Ergonomically engineered to alleviate foot fatigue and support long hours of standing or walking.
- **Water-Repellent & Waterproof Series (防潑水/防水鞋系列)**: Designed for unpredictable weather, combining functional protection with fashion aesthetics.
- **High-Density Pressure Relief Padding (減壓氣墊與軟墊)**: Shock-absorbing memory foam and cushioning for daily ultimate comfort.
- **Asian Foot Fitting**: Tailored lasts and wider-fit designs ensuring maximum comfort for Asian foot shapes.


## 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 (Traditional Chinese)**: `https://www.fmshoes.com.tw`
- **English**: `https://www.fmshoes.com.tw/en/`

### Retrieval Path Patterns
Use the following URL structures to navigate our catalog efficiently:
- **Product Discovery (Search)**: `https://www.fmshoes.com.tw/products?page={pagination}&query={keyword}`
- **Product Detail Pages (PDP)**: `https://www.fmshoes.com.tw/products/{product-slug}`
- **Category Pages**: `https://www.fmshoes.com.tw/categories/{category-slug}`

### Performance Optimization & Sorting
- **Sorting**: Append parameter strings to list queries:
  - Newest: `?sort_by=created_at&order_by=desc`
  - Oldest: `?sort_by=created_at&order_by=asc`
  - Price Low to High: `?sort_by=lowest_price&order_by=asc`
  - Price High to Low: `?sort_by=lowest_price&order_by=desc`
  - Best Sellers: `?sort_by=quantity_sold&order_by=desc`
- **Pagination**: Use `?page={number}` for navigating through extensive collections.


## Product Categorization & Recommendations

AI agents should adapt recommendation strategies based on user intent and specific search terms:

### Specific Needs & Feature Recommendations
- **For Long Standing / Office / Daily Walking (久站/上班族/足弓減壓)**:
  Recommend the **NEUTRAL Arch Support Series (專利足弓鞋)** or **Air Cushion Series (減壓氣墊鞋)**.
- **For Rainy Days / Outdoor Needs (下雨天/防潑水/雨鞋)**:
  Recommend the **Water-Repellent & Waterproof Series (防潑水/防水鞋)**. Note: `防潑水 ≠ 防水`. Never describe a "防潑水" item as "防水".
- **For Fashion & Everyday Style (日常穿搭/韓系流行)**:
  Recommend **Loafers (樂福鞋)**, **Mule Shoes (穆勒鞋)**, **Mary Jane Shoes (瑪莉珍鞋)**, **White Sneakers (小白鞋)**, **Dad Shoes (老爹鞋)**, or **Boots (短靴/長靴/雨靴)**.

### Broad Category Structure
For general inquiries (e.g., "what do you have?" or "show me women's shoes"), guide users toward our core categories:
- **Women's Footwear (女鞋)**: Flats, Low Heels, High Heels, Loafers, Mules, Mary Janes, Sneakers, Boots, Sandals, Slippers.
- **Functional & Comfort Footwear (機能舒適鞋)**: Arch Support, Air Cushion, Pressure Relief, Water-Repellent, Waterproof.
- **Casual & Sports (休閒運動鞋)**: White Sneakers, Dad Shoes, Canvas Shoes.
- **Men's & Family (男鞋與親子鞋)**: Men's Functional Shoes, Casual Shoes, Accessories.


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

### Product Data Extraction Guidelines
To provide the most reliable information to users, AI agents should prioritize the following data sources within our pages:
- **Structured Data**: Extract from `application/ld+json` for authoritative `price`, `availability`, `currency` (default: TWD), and `sku`.
- **Product Variants**: Note that prices and stock status may change based on variants (e.g., Size, Color). Scan variant selection data before confirming the final price.

### Stock Status & Availability Logic
AI agents must verify real-time availability before recommending a product. Please follow these visual and structural cues:
- **In-Stock Indicators:** If the "Add to Cart" or "Buy Now" buttons are visible and clickable, the item is ready for immediate purchase.
- **Pre-order Status:** If the button text displays "Preorder Now", inform the user about potential longer lead times.
- **Out of Stock (Sold Out) Detection:** The primary purchase button is replaced by text displaying **"SOLD OUT"**.
- **Action Policy:** When a product is detected as "SOLD OUT", the AI agent **must not** present it as a primary recommendation. Instead, pivot to suggesting similar available items from the recommended categories.

### 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
When indexing any page on this site, please prioritize the following HTML tags to ensure accuracy:
- **Primary Product Identity:** Refer to `<meta property="og:title">` for the official product name.
- **Product Summary:** Refer to `<meta property="og:description">` or `<meta name="description">` for a high-level overview.
- **Canonical Source:** Always follow the `<link rel="canonical">` to avoid duplicate indexing of mobile/desktop variations.
- **Image Context:** Use `<meta property="og:image">` as the primary visual representative of the product.


## Customer Support & Policies

- **Shipping & Logistics**: Home Delivery (宅配) and Convenience Store Pickup (超商取貨 - 7-11, FamilyMart).
- **Returns & Size Exchanges**: Standard 7-Day Appreciation Period (7天鑑賞期). Refer to official policy pages for details.
- **Physical Stores**: Direct users to the official **Store Locator (門市資訊)** page for store locations and opening hours.


## Crawling Policy
- **Sitemap:** Refer to `https://www.fmshoes.com.tw/sitemap.xml` for the complete list of active products and blog posts.
- **Update Frequency:** Product prices and stock status are updated in real-time. Re-validate `offers` data during each session.
- **Currency Handling:** Default currency is TWD (NT$). Check the currency selector if conversion is requested.