market-kurly-search

Market Kurly 商品搜索

功能说明

通过 Market Kurly Web App 实际使用的免登录搜索与商品详情公开接口，处理以下流程：

• 根据关键字搜索候选商品。
• 查看当前价格及折扣信息。
• 确认缺货/售罄状态以及配送类型。
• 附带返回商品链接。
• 仅供查询，绝不执行下单、加购等任何写/交易操作。

适用场景

• “帮我在 Market Kurly 上查查牛奶多少钱？”
• “在 Kurly 上搜一下草莓”
• “看看这款商品是不是售罄了，把链接发我”
• “现在想快速查一下 Kurly 的价格”

不适用场景

• 需要自动化处理下单、加购物车或支付等流程
• 需要确认基于地址的配送覆盖情况或会员专属价格
• 需要查询依赖登录态的个性化推荐或收藏夹信息

前置条件

• 网络连接
• node 18+
• 本仓库的 market-kurly-search package 或同等实现逻辑

输入要求

1. 若缺少商品关键字，先向用户询问

若未提供商品名或搜索关键词，先主动询问。

• 推荐提问：请输入您要在 Market Kurly 搜索的商品名称或关键词，例如：牛奶、草莓、鸡胸肉
• 若关键词太宽泛：搜索词范围有点大哦。如果能提供品牌或规格容量，能帮您更精准地筛选价格和候选商品。

2. 当搜索结果存在歧义时，与用户确认候选商品

若搜索结果有多个候选，仅展示前 2~3 个并向用户二次确认。

• 推荐提问：找到多个相关商品，请问您想查看下面哪一个的价格呢？
• 回复内容中应附带：商品名 + 当前价格 + 是否缺货/售罄 + 商品链接。

Market Kurly 官方公开接口

• 搜索列表：https://api.kurly.com/search/v4/sites/market/normal-search?keyword=<keyword>&page=1
• 搜索计数：https://api.kurly.com/search/v3/sites/market/normal-search/count?keyword=<keyword>&filters=&allow_replace=true
• 商品详情页：https://www.kurly.com/goods/<productNo>

工作流程

1. 首先按关键字搜索

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

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

在搜索结果中优先关注以下字段：

• 商品名
• 当前价格（优先使用 discountedPrice，若无则使用 salesPrice）
• 折扣率
• 是否缺货/售罄
• 配送类型
• 商品链接

2. 当搜索结果数量较多时，先调用计数接口

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

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

若匹配的候选商品过多，先展示 count（总数），并引导用户缩小搜索范围。

3. 使用商品页详情作为备用或后续补充查询

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

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

从 goods/<productNo> HTML 的 __NEXT_DATA__ 中提取商品名、价格、缺货状态及配送类型。

4. 谨慎严谨地回复

回复内容应简洁且保持保守态度：

• 商品名
• 当前价格
• 是否为原价/折后价（如有必要）
• 是否售罄或可售状态
• 商品链接
• 明确提示：价格、库存售罄情况和商品展示信息具有时效性，上述数据仅作为当前查询时间点的参考值。

完成标准

• 已确认商品关键词。
• 已从搜索结果中至少返回 1 个候选商品及其当前价格。
• 必要时已通过商品详情页完成辅助确认。
• 未执行任何超出范围的操作（如下单、加购物车）。

异常与失败场景

• 搜索词过于宽泛可能导致候选结果过多。
• 价格、缺货状态及配送文案可能随时间发生变化。
• 当前使用的接口为 Web 端公开调用的前端接口，而非官方开发者 Open API，因此结构变更可能导致脚本失效。
• 会员专属/特定地址专属的信息无法仅通过免登录查询来确定。

注意事项

• 本 Skill 为纯查询类 Skill。
• 始终坚持优先使用免登录公开接口的原则。
• 切勿尝试下单、加购物车或要求登录等操作。