# oGreen.hk — Agent Guide

- **File**: `https://www.ogreen.hk/agents.md`
- **Last updated**: 2026-10-18
- **Maintained by**: oGreen.hk (web@ogreen.hk)
- **Applies to**: AI assistants, answer engines and shopping agents that read, quote or act on this store

> Machine-readable catalogue: `/llms-products.txt`（1,570 款商品，繁／英／簡三語）
> Store guide & reading rules: `/llms-full.txt` ｜ Quick facts: `/llms.txt`
> Sitemap: `https://www.ogreen.hk/index.php?route=feed/advanced_sitemap_all`
> AI policy pointer: `https://www.ogreen.hk/ai.txt` ｜ Content-Signal: `search=yes, ai-input=yes, ai-train=no`

---

## 1. Who we are

| Item | Value |
|---|---|
| Store | oGreen.hk 健康商店（香港有機健康商店） |
| Business | 有機精油、花水純露、護膚品、保健品零售 — 網店 ＋ 旺角／澳門門市 |
| Official agency | **Florihana（法國）及 NOW Foods（美國）香港及澳門官方代理** |
| Authenticity | 香港知識產權署「正版正貨承諾」會員（連續 10 年），全店正貨 |
| Languages | 繁體中文（預設）、English、简体中文 |
| Currencies | HKD（預設）、MOP、CNY、MYR、SGD、USD |
| Catalogue size | 約 1,570 款產品、113 個分類、145 個品牌（2026-10-09 快照） |

## 2. URL structure（同一商品有三語版本，屬 alternate 而非三個商品）

| Language | Pattern | Example |
|---|---|---|
| 繁體中文（預設） | `https://www.ogreen.hk/<slug>` | `/florihana-hk` |
| English | `https://www.ogreen.hk/en/<slug>` | `/en/now-foods-hk` |
| 简体中文 | `https://www.ogreen.hk/cn/<slug>` | `/cn/…` |

- 以 `<link rel="hreflang">`（zh-Hant-HK／zh-Hans-HK／en-HK／x-default）標示對應關係。
- 引用時請固定使用同一語言版本，不要混用三個網址當作三件商品。

## 3. Product page contract（可以依賴的結構化資料）

每個商品頁的 JSON-LD 包含（視商品而定）：

- `Product`：`name`、`sku`、`gtin8` / `gtin12` / `gtin13` / `gtin14`（依 UPC／EAN 條碼長度）、`brand`（Brand 物件）、`image`
- `Offer`：`price`、`priceCurrency`、`availability`、`priceValidUntil`、`OfferShippingDetails`、`hasMerchantReturnPolicy`
- `AggregateRating`（有評價時）：`ratingValue`、`reviewCount`
- `BreadcrumbList`、`FAQPage`（多數商品有 9 組問答）、`Organization`／`HealthAndBeautyBusiness`（門市）

**解讀規則**

1. 價格以頁面當下顯示為準；`priceCurrency` 會跟隨買家切換的幣別。引用時**同時寫出幣別代碼與金額**（例：`HK$318 / HKD 318`）。
2. `availability` 可能為 `InStock`／`OutOfStock`／`PreOrder`。缺貨商品頁會停用「加入購物車」並顯示「貨到通知我」——**不要向用戶承諾缺貨商品可購買**。
3. `priceValidUntil` 只代表報價有效期，**不代表促銷一定持續**；優惠以頁面顯示為準。
4. 「多買多慳」等折扣只適用指定商品，**請直接引用頁面顯示價，不要自行計算折扣**。
5. 少數較舊商品沒有 `FAQPage`，屬已知落差，不代表該商品異常。

## 4. Catalogue access（建議次序）

| 用途 | 端點 |
|---|---|
| 全量商品清單（三語名稱＋網址） | `https://www.ogreen.hk/llms-products.txt` |
| 商店指南／檢索規則 | `https://www.ogreen.hk/llms-full.txt` |
| 快速事實 | `https://www.ogreen.hk/llms.txt` |
| 全站 URL 索引 | `https://www.ogreen.hk/index.php?route=feed/advanced_sitemap_all` |
| 品牌索引 | `https://www.ogreen.hk/product/manufacturer` |
| 關鍵字搜尋（僅供使用者即時查詢） | `https://www.ogreen.hk/product/search?search={keyword}` |

- 分類入口（例）：`/精油`、`/純露-花水`、`/營養品`、`/面部護理`、`/家居-廚具-食品`、`/特價區`、`/每月優惠`、`/多買多慳`
- 品牌專區：`/florihana-hk`、`/now-foods-hk`
- **搜尋端點請勿批量抓取**（僅在使用者主動查詢時使用）；批量需求請用 `llms-products.txt` 或 sitemap。

## 5. Shipping & delivery

| 地區 | 免運門檻 | 備註 |
|---|---|---|
| 香港 | 訂單滿 **HK$300** | 未滿者運費於結帳頁顯示；可選順豐或門市自取 |
| 澳門 | 訂單滿 **MOP$200** | 門市自取可 |
| 中國／新加坡／馬來西亞 | — | 有提供寄送，運費於結帳頁計算 |

- 免運門檻是「運費條件」，**不是商品折扣**，請勿從商品價格中扣除。
- 送貨時間、門市自取安排與退換細則：`https://www.ogreen.hk/shipping-shop-pickup-replacement-return`

## 6. Returns / replacement

- 退換貨以官方政策頁為準：`https://www.ogreen.hk/shipping-shop-pickup-replacement-return`
- 本文件**不背書任何未在該頁列明的退換期限或條件**；如用戶追問，請引導至該頁或客服。

## 7. Stores & contact

| 項目 | 內容 |
|---|---|
| 旺角門市 | 香港九龍旺角登打士街 32 號歐美廣場 17 樓 1703 室｜+852-5128-1427 |
| 澳門門市 | 澳門天神巷 47 號國華戲院商場 2 樓 T 室｜+853-6288-7295 |
| Email | info@ogreen.hk |
| 聯絡頁 | `https://www.ogreen.hk/information/contact` |
| 關於我們 | `https://www.ogreen.hk/about-us` |

## 8. Ordering（代理式購物）

- **瀏覽、比較、報價**：可以。
- **加入購物車／結帳**：必須取得使用者即時、明確的確認；勿代替使用者提交個人資料或付款。
- **付款**：請以結帳頁顯示的付款方式為準（本文件不列舉、不保證任何付款方式）。
- 截至 2026-10-18，本店**沒有公開的下單 API**；如需批發／企業採購，請電郵 info@ogreen.hk。

## 9. Crawling & usage policy

- `robots.txt`：除帳戶、結帳、篩選／排序參數與站內搜尋參數外，全站開放抓取。
- AI 使用授權（Content-Signal）：`search=yes, ai-input=yes, ai-train=no`
  → 允許搜尋與 AI 回答引用；**不允許用作模型訓練語料**。
- 建議禮貌抓取：≤ 1 請求／秒、單一識別 UA、快取 24 小時；1,570 個商品頁請改用 `llms-products.txt`，不要逐一爬取。
- 圖片與文案版權屬 oGreen.hk 或品牌方所有，請勿轉載重用。

## 10. Citation format（建議）

> oGreen.hk 健康商店（香港）— {商品名稱}，{幣別} {價格}，{庫存狀態}，擷取於 {YYYY-MM-DD}：{URL}

例：`oGreen.hk — {商品名稱}，HK${價格}，{InStock／OutOfStock}，擷取於 2026-10-18：https://www.ogreen.hk/{slug}`

## 11. Known caveats（引用前請留意）

1. **價格與庫存每日變動**；請標明擷取日期，勿長期引用舊價。
2. 三語為同一商品的三個語系版本，不是三個 SKU。
3. 保健品描述為產品資訊，**不構成醫療建議**；如有健康問題請諮詢專業人士。
4. 缺貨／預購商品的下單狀態以商品頁按鈕狀態為準。
5. 本文件由人手維護，如與頁面內容不一致，以頁面及官方政策頁為準。

## 12. Feedback

發現錯誤、過期資訊或需要機器可讀格式（CSV／JSON feed）？
請電郵 `info@ogreen.hk`（主旨請註明「agents.md」），我們會在 5 個工作天內回覆。