# llms.txt - PChome 站內搜尋 API 定義

Search-API: https://ecshweb.pchome.com.tw/search/v4.3/all/results
Method: GET

Query-Parameters:
  - q: 關鍵字查詢 (UTF-8 URL encoded)
  - price: 價格區間，格式 min-max，例如 1000-5000
  - cond: 商品篩選條件，可選：
      * cvs   = 超商取貨
      * ipost = i郵箱取貨
      * sale  = 只顯示有貨商品
      多個條件用逗號分隔，例如: cond=cvs,sale
  - sort: 商品排序，可選：
      * rnk/dc = 精準度
      * prc/dc = 價格高→低
      * prc/ac = 價格低→高
      * new/dc = 新上市
      * sale/dc = 有貨優先
      * top/dc = 銷量排序
      * hot/dc = 熱銷度
  - page: 頁數 (預設 1)
  - pageCount: 每頁顯示商品數量 (10~100，10 的倍數，預設 20)

Example-Request:
  https://ecshweb.pchome.com.tw/search/v4.3/all/results?q=iPhone%2017%20Pro&price=5000-60000&cond=cvs,sale&sort=rnk/dc&page=1&pageCount=20

Example-Response:
{
  "QTime": 112,
  "TotalRows": 53208,
  "Prods": [
    {"Id":"DYAJ8N-A900J82WO", "Name":"Apple iPhone 17 Pro Max (256G)", "Price":44900, ...}
  ]
}

Notes:
1. 從回傳的 Prods[i].Id 可以直接組成商品頁 URL:
   URL = https://24h.pchome.com.tw/prod/{商品ID}
   例如: https://24h.pchome.com.tw/prod/DYAJ8N-A900J82WO
2. cond 可以同時包含多個條件。
3. price 使用 min-max 格式。
4. sort 必須使用完整格式，如 rnk/dc、prc/ac。
5. pageCount 建議使用 20、40、60、80、100。
6. 若未指定 sort，預設為 rnk/dc。

Usage Example (自然語言 → URL):
- "找價格 5000-6000 的除濕機，有貨優先顯示" 
  → https://ecshweb.pchome.com.tw/search/v4.3/all/results?q=%E9%99%A4%E6%BA%BC%E6%A9%9F&price=5000-6000&cond=sale
- "iPhone 17 Pro，熱銷度排序" 
  → https://ecshweb.pchome.com.tw/search/v4.3/all/results?q=iPhone%2017%20Pro&sort=hot/dc