Market Kurly Search

What this skill does

使用 Market Kurly Web App 實際採用的免登入搜尋與商品詳情頁面，處理以下流程：

透過關鍵字搜尋候選商品。
確認當前價格與折扣狀態。
確認售罄狀態與配送類型。
一併傳回商品連結。
不執行下單或加入購物車等操作，僅以查詢型態回應。

When to use

「Market Kurly 的牛奶多少錢？」
「幫我在 Kurly 搜尋草莓」
「看看這款商品有沒有缺貨，並提供連結」
「現在只想快速看一下 Kurly 的價格」

When not to use

需要自動化處理下單／購物車／結帳等作業時
需要確認基於地址的配送可行性，或確定會員專屬價格時
需要查詢需要登入工作階段的個人化推薦或收藏清單時

Prerequisites

網路連線
node 18+
此儲存庫的 market-kurly-search package 或相同邏輯

Required inputs

1. Ask for a product keyword if it is missing

若缺少商品名稱或搜尋關鍵字，請先詢問使用者。

建議提問：請提供要搜尋的 Market Kurly 商品名稱或關鍵字。例如：牛奶、草莓、雞胸肉
關鍵字過於寬鬆時：搜尋關鍵字範圍太廣了。如果能提供品牌或容量，可以更精準地篩選出價格候選項目。

2. Confirm which candidate they want when the query is ambiguous

搜尋結果有多個時，僅顯示前 2~3 個並再次向使用者確認。

建議提問：有多個候選商品，請問您想查看下方哪款商品的價格？
回應中應一併附上：商品名稱 + 當前價格 + 是否售罄 + 商品連結。

Official Market Kurly surfaces

search list: https://api.kurly.com/search/v4/sites/market/normal-search?keyword=<keyword>&page=1
search count: https://api.kurly.com/search/v3/sites/market/normal-search/count?keyword=<keyword>&filters=&allow_replace=true
product detail page: https://www.kurly.com/goods/<productNo>

Workflow

1. Search by keyword first

const { searchProducts } = require("market-kurly-search")

const result = await searchProducts("우유")
console.log(result.items.slice(0, 3))

在搜尋結果中，優先檢視以下欄位：

商品名稱
當前價格（優先使用 discountedPrice，若無則使用 salesPrice）
折扣率
是否售罄
配送類型
商品連結

2. Use the count endpoint when the result set is broad

const { countProducts } = require("market-kurly-search")

const count = await countProducts("우유")
console.log(count)

若候選項目過多，先顯示 count 並引導使用者縮小搜尋範圍。

3. Use the goods page detail as a fallback or follow-up lookup

const { getProductDetail } = require("market-kurly-search")

const detail = await getProductDetail(5063110)
console.log(detail)

從 goods/<productNo> HTML 內的 __NEXT_DATA__ 中擷取商品名稱、價格、是否售罄與配送類型。

4. Respond conservatively

請保持簡短且保守的回應內容：

商品名稱
當前價格
視需要標註原價／折扣價
是否售罄或是否可販售
商品連結
請明確說明：價格、缺貨與展示資訊可能隨時間變化，此結果僅代表查詢當下的參考值。

Done when

已確認商品關鍵字。
已從搜尋結果中傳回至少 1 個以上的候選項目與當前價格。
視需要已透過商品詳情頁面進行輔助確認。
未執行下單／加入購物車等超出範圍的操作。

Failure modes

搜尋關鍵字過於寬鬆時，候選項目可能過多。
價格、售罄狀況與配送說明可能隨時間變動。
目前使用的介面為網頁使用的公開介面，而非官方開發者 Open API，因此 Schema 變更時可能會失效。
僅靠免登入查詢無法確認會員專屬或特定地址專屬的資訊。

Notes

本 Skill 為查詢專用。
保持「免登入公開介面優先」的原則。
請勿嘗試下單、購物車或需要登入的功能。

market-kurly-search

相關技能