AI Skills
naver-shopping-search

naver-shopping-search

熱門

透過 k-skill-proxy 查詢 Naver 購物公開 BFF JSON，保守地比較商品候選、最低價格與銷售管道連結。

6532星標
746分支
更新於 2026/7/29
獲取技能源代碼

相關技能

flox-environments24萬cloud11萬api-security-testing5.9萬
SKILL.md
唯讀
名稱
naver-shopping-search
描述

透過 k-skill-proxy 查詢 Naver 購物公開 BFF JSON，保守地比較商品候選、最低價格與銷售管道連結。

Naver Shopping Search

此技能的功能

k-skill-proxy 優先使用 Naver 搜尋 Open API 購物搜尋（shop.json），只有在沒有金鑰時，才透過單一搜尋請求取得 Naver 購物/搜尋中無需登入的公開 BFF JSON 端點，並正規化商品候選。

  • 根據商品名稱/搜尋詞尋找 Naver 購物候選。
  • 整理目前顯示的價格、銷售管道、連結、圖片、評論/購買數量（僅在有顯示時）。
  • 可分別比較低價候選與官方商城/品牌商城候選。
  • 不涉及訂購、購物車、收藏、登入會話存取。

使用時機

  • 「在 Naver 購物上比較 AirPods 價格」
  • 「用最低價在 Naver 上找咖啡機」
  • 「比較 Naver 購物連結與各銷售管道的價格」
  • 「這個商品在 Naver 購物上大概多少錢？」

不適合使用的情況

  • 需要確認會員專屬價格、優惠券價格、Naver Pay 個人化優惠時。
  • 需要訂購、購物車、收藏、登入等動作。
  • 需要繞過封鎖、CAPTCHA、指紋偽造等存取控制。

必要輸入

若無商品名稱或搜尋詞，會先詢問。

建議提問：

請告訴我要搜尋的 Naver 購物商品名稱或搜尋詞。例如：AirPods Pro 2代、iPhone 15 保護殼

若搜尋詞過於廣泛，會進一步詢問品牌/容量/型號。

Proxy 端點

預設為公開/唯讀/無需認證的 proxy。若 proxy 伺服器設有 NAVER_SEARCH_CLIENT_ID 與 NAVER_SEARCH_CLIENT_SECRET，則優先使用官方 Search API。

curl -fsS --get "${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}/v1/naver-shopping/search" \
  --data-urlencode 'q=에어팟 프로 2세대' \
  --data-urlencode 'limit=10' \
  --data-urlencode 'sort=rel'

查詢參數：

  • q 或 query — 搜尋詞。至少 2 個字元。
  • limit — 回傳數量。預設 10，最大限制為 40。
  • page — 頁碼。預設 1。在無金鑰 BFF 備援模式下，會請求 BFF 的 page 並僅正規化該頁卡片。
  • sort — 可選 rel、date、price_asc、price_dsc、review 之一。無效值預設為 rel。
    • 官方 Search API 路徑使用 Naver API 排序。但官方 API 不支援 review 排序，因此 review 請求會以 upstream sort=sim 查詢，並標示 meta.sort_applied: "unsupported"、meta.upstream_sort: "sim"。
    • 無金鑰 BFF 備援模式下，rel 維持 BFF 顯示順序；price_asc/price_dsc/review 則在所選 BFF 頁面卡片內進行本地排序。BFF 卡片無日期欄位，因此 date 會標示 meta.sort_applied: "unsupported" 並維持 BFF 顯示順序。

回應主要欄位：

  • items[].title
  • items[].price / items[].price_text
  • items[].mall_name
  • items[].url
  • items[].image_url
  • items[].review_count、purchase_count、score（僅在有顯示時）
  • meta.extraction — 可為 naver-openapi、bff-json、embedded-json、html-card、none
  • meta.sort_applied — 可為 upstream、local、unsupported 之一

工作流程

  1. 確認搜尋詞。
  2. 呼叫 GET /v1/naver-shopping/search。
  3. 若有 items，檢查請求的 sort 與 meta.sort_applied，然後根據價格由低至高、是否為官方/品牌商城、評論數等標準，簡短比較 3~5 個候選。
  4. 一併說明 meta.extraction 與查詢時間基準。
  5. 若 items 為空或 upstream 封鎖/錯誤，不要重複嘗試繞過，而是建議縮小搜尋詞或手動透過瀏覽器確認。

回應風格

  • 價格表述為「查詢時間點 Naver 購物顯示價格」。
  • 運費、優惠券、選項加價、會員優惠不透過未登入公開搜尋確認。
  • 銷售管道可信度僅根據顯示的銷售管道名稱/評論數保守陳述。
  • 不要斷言最低價，注意同價或選項差異。

失敗模式

  • 若無官方 Search API 金鑰而使用 BFF 備援，Naver 可能對特定 IP/環境回傳 418/403 等機器人封鎖回應。
  • 無金鑰備援使用 ns-portal.shopping.naver.com/api/v2/shopping-paged-slot?query=<검색어>&source=shp_gui 公開 JSON 路徑。
  • 搜尋結果 BFF JSON 結構為非官方前端表面，可能變動。
  • 價格/缺貨/運送資訊會即時變動。
  • Proxy 不繞過存取控制，僅使用官方 Search API 或單一公開搜尋請求 + 快取 + 速率限制。

完成條件

  • 已確認搜尋詞。
  • 已回傳至少 1 個 Naver 購物候選，或說明為何無法回傳。
  • 已根據查詢時間點保守整理價格/銷售管道/連結。
  • 未超出登入/訂購/繞過封鎖的範圍。