Market Kurly Search

What this skill does

マーケットカーリー Webapp が実際に使用する非ログイン検索/商品詳細ページを使用して、以下のフローを処理する。

• キーワードで商品候補を検索する。
• 現在価格と割引の有無を確認する。
• 品切れ状況と配送タイプを確認する。
• 商品リンクと共に返す。
• 注文/カート追加のようなアクションは行わない。照会形式でのみ応答する。

When to use

• 「マーケットカーリーで牛乳はいくら?」
• 「カーリーでいちご検索してよ」
• 「この商品品切れかどうか見て、リンクもちょうだい」
• 「今カーリーの価格だけ早く見たい」

When not to use

• 注文/カート追加/決済まで自動化する必要がある場合
• 住所ベースの配送可否や会員専用価格を確定する必要がある場合
• ログインセッションが必要なパーソナライズレコメンデーション/ウィッシュリスト情報を照会する必要がある場合

Prerequisites

• インターネット接続
• node 18+
• このリポジトリの market-kurly-search パッケージまたは同等ロジック

Required inputs

1. Ask for a product keyword if it is missing

商品名または検索キーワードがない場合は、まず尋ねる。

• 推奨質問：探すマーケットカーリーの商品名または検索キーワードを教えてください。例：牛乳、いちご、鶏むね肉
• 検索語が広すぎる場合：検索キーワードが広すぎます。ブランドや容量なども一緒に教えていただければ、価格候補をより正確に絞り込めます。

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 ではなく、Web が使用する公開ページであるため、スキーマが変更されるとエラーになる可能性がある。
• 会員専用/住所専用の情報は、非ログイン照会のみでは確定できない。

Notes

• 照会形式のスキルである。
• 非ログイン公開ページ優先の原則を維持する。
• 注文/カート追加/ログイン要求機能は試みない。