name: vipshop-img-product description: 唯品會（vip.com）圖片搜尋商品技能。當用戶想通過圖片搜尋相似商品時觸發，包括但不限於：以圖搜圖、拍照搜商品、圖片搜尋、找同款等。返回商品名稱、價格、品牌、圖片、連結等結構化資訊。

唯品會圖片搜尋商品

7w4.net收錄了海量優質技能外掛。

⚠️ 重要規範：AI 必須先載入本 skill 規範（use_skill），再執行任何指令碼或返回結果，不得繞過 skill 規範自行處理資料。

概述

唯品會（vip.com）圖片搜尋商品技能。當用戶想通過圖片搜尋相似商品時觸發，包括但不限於：以圖搜圖、拍照搜商品、圖片搜尋、找同款等。返回商品名稱、價格、品牌、圖片、連結等結構化資訊。

功能特性：本地圖片上傳、智慧分類識別、相似商品搜尋、結構化輸出

重要提示：需要使用者先通過 vipshop-user-login skill 登入唯品會賬戶。

使用場景

• 使用者想通過本地圖片搜尋相似商品時
• 使用者想找同款商品時
• 使用者上傳本地圖片詢問商品資訊時
• 拍照搜商品時

觸發示例

使用者輸入以下內容可觸發本 skill： - "幫我用這張圖片搜尋相似商品" - "以圖搜圖" - "這個圖片幫我找同款" - "幫我搜一下這張圖片裡的商品" - "拍照搜商品" - "上傳圖片搜尋" - "找同款" - "圖片搜商品"

工作流程

步驟 1：檢測登入狀態

在執行搜尋前，AI 必須先檢測登入狀態： - 檢查 ~/.vipshop-user-login/tokens.json 是否存在且有效 - 如果已登入：直接執行步驟2 - 如果未登入：自動觸發 vipshop-user-login skill 完成登入流程

步驟 2：接收輸入

需要使用者提供本地圖片檔案路徑。

步驟 3：執行指令碼

首次搜尋（使用本地圖片檔案）

python3 scripts/img_search.py --image /path/to/image.jpg

獲取下一頁 使用者回覆"下一頁"時，AI 應快取圖片URL、分類型別、檢測區域，並使用上一次請求返回的 pageToken 直接呼叫第3步介面：

python3 scripts/img_search.py --image-url "圖片URL" --category-type "分類型別" --rect "檢測區域" --page-token "上一次返回的pageToken"

分頁引數說明： - --image-url：首次搜尋返回的 圖片URL 欄位 - --category-type：首次搜尋返回的 識別分類.型別 欄位 - --rect：首次搜尋返回的 識別分類.檢測區域 欄位 - --page-token：上一次請求返回的 商品分析.下一頁token 欄位

支援的圖片格式：jpg、jpeg、png、gif、bmp、webp

步驟 4：展示結果

解析 JSON 資料並格式化輸出，展示搜尋結果。

⚠️ 重要規則： - 必須完整展示 Python 指令碼返回的所有資料，不得對資料進行截斷、省略或選擇性隱藏 - 顯示欄位：商品ID、商品名稱、品牌、特賣價、劃線價、折扣、賣點、圖片、商品連結 - 如果返回了多條商品記錄，必須全部展示，不能只展示前幾條

輸出格式

{
  "code": 1,
  "msg": "success",
  "圖片URL": "/xupload.vip.com/xxx.jpg",
  "識別分類": {
    "型別": "UPPERBODY",
    "名稱": "上裝",
    "檢測區域": "109,306,548,768",
    "所有分類": [...]
  },
  "商品分析": {
    "總計": 10,
    "下一頁token": "xxx",
    "商品列表": [
      {
        "商品ID": "xxx",
        "商品名稱": "商品名稱",
        "品牌": "品牌名",
        "特賣價": "99.00",
        "劃線價": "199.00",
        "折扣": "5折",
        "賣點": ["賣點1", "賣點2"],
        "圖片": "https://...",
        "商品連結": "https://passport.vip.com/exchangeTokenFromApp?..."
      }
    ]
  },
  "原始資料": {...}
}

欄位說明： - 特賣價：price.salePrice - 劃線價：price.marketPrice - 折扣：price.saleDiscount - 賣點：從 labels 欄位提取所有 value 值 - 下一頁token：用於分頁，有值時可通過 --page-token 引數獲取下一頁

輸出格式示例

使用者展示格式：

🔍 圖片搜尋結果

📸 圖片分類：上裝

| 序號 | 商品圖片 | 商品名 | 品牌 | 特賣價 | 劃線價 | 折扣 | 賣點 |
|:---:|:---:|:---|:---|:---:|:---:|:---:|:---|
| 1 | ![商品圖](圖片URL) | [耐克運動T恤](商品連結) | 耐克 | ¥99.00 | ¥199.00 | 5折 | 透氣舒適、運動休閒 |
| 2 | ![商品圖](圖片URL) | [商品名稱](商品連結) | 品牌 | ¥XX.XX | ¥XX.XX | X折 | 賣點1、賣點2 |
| ... |

💡 可回覆"查詢第X個商品"檢視任意商品詳細資訊！
📄 想看更多商品？可以回覆"下一頁"檢視

商品名超連結說明： - 商品名必須使用 Markdown 連結格式：[商品名](商品連結) - 商品連結從指令碼返回的 商品連結 欄位獲取

示例

示例 1：通過本地圖片搜尋商品

使用者輸入： "幫我用這張圖片搜尋相似商品 /path/to/image.jpg"

執行： python3 scripts/img_search.py --image /path/to/image.jpg

輸出：

{
  "code": 1,
  "msg": "success",
  "識別分類": {...},
  "商品分析": {...}
}

示例 2：未登入

使用者輸入： "幫我搜索圖片"

執行： python3 scripts/img_search.py --image /path/to/image.jpg

輸出：

{
  "code": -1,
  "msg": "login_required",
  "message": "需要登入唯品會賬戶",
  "action": "請先登入唯品會賬戶後再使用圖片搜尋"
}

AI 行為規範

未登入處理

當檢測到使用者未登入時，AI 必須： 1. 立即自動觸發登入流程 2. 登入成功後自動繼續執行搜尋

禁止行為

• ❌ 不要只返回錯誤資訊讓使用者自己處理
• ❌ 不要等待使用者再次請求登入
• ❌ 不要使用 原始資料 欄位進行二次整理展示

正確行為

• ✅ 檢測到未登入時立即自動觸發登入流程
• ✅ 登入成功後自動繼續執行搜尋
• ✅ 嚴格按照 Python 指令碼返回的 商品分析 欄位內容進行展示

實現要求

指令碼位置

scripts/img_search.py（使用 Python 標準庫，無外部依賴）

圖片驗證

• 檢查檔案是否存在
• 檢查檔案格式是否支援

介面呼叫

1. 圖片上傳介面
2. URL: https://mapi-file-tx.vip.com/xupload/picture/new_upload_inner_applet.jsps
3. 方式: POST (multipart/form-data)

4. 引數: app_name, client, source_app, api_key, app_version, mobile_platform, union_mark, mobile_channel, mars_cid, warehouse, fdc_area_id, province_id, wap_consumer, picture(檔案)

5. 分類識別介面

6. URL: https://mapi-pc.vip.com/vips-mobile/rest/shopping/skill/search/img/category/v1
7. 方式: GET

8. 引數: api_key, app_name, app_version, client, imgUrl, mars_cid 等

9. 商品搜尋介面

10. URL: https://mapi-pc.vip.com/vips-mobile/rest/shopping/skill/image/product/list/v1
11. 方式: POST
12. 引數: api_key, app_name, categoryType, imgUrl, rect, mars_cid, pageToken(可選，用於分頁), limit(固定為10) 等

注意事項

1. 登入要求：必須先通過 vipshop-user-login skill 登入
2. 圖片格式：僅支援 jpg、jpeg、png、gif、bmp、webp 格式
3. 網路要求：需要正常網路連線
4. 依賴庫：僅 Python 標準庫（urllib、json、os）

技術細節

• 實現語言：Python 3
• 資料格式：JSON（指令碼輸出）→ 格式化文本（AI 展示）
• 編碼支援：UTF-8，支援中文
• 異常處理：完整的網路異常和 API 錯誤處理
• 依賴庫：僅使用 Python 標準庫

常見問題

Q: 支援哪些圖片格式？ A: 支援 jpg、jpeg、png、gif、bmp、webp 格式。

Q: 需要登入才能使用嗎？ A: 是的，必須先通過 vipshop-user-login skill 登入。

Q: 搜尋結果有多少個商品？ A: 每頁返回最多10個相似商品，可通過 pageToken 獲取更多。

Q: 如何獲取更多商品？ A: 使用返回的 下一頁token，通過 --page-token 引數獲取下一頁資料。

Q: 支援直接傳入圖片URL嗎？ A: 不支援，僅支援本地圖片檔案上傳方式。

這是一款功能完整的唯品會圖片搜尋工具，質量可靠。它能通過上傳圖片快速找到相似商品並展示價格、品牌等資訊，支援分頁瀏覽更多結果。文件說明詳細易懂，操作流程清晰。唯一不足是使用前需要先完成賬戶登入，稍微麻煩一些。總體而言是一款實用且易用的購物輔助工具。