← WebMCP Directory

Tool tree

tw.bid.yahoo.com

CommerceTools verified
Website
Yahoo Auctions Taiwan, an online auction marketplace with free listings, buyer and seller transaction protection, and product and store search.
Explore capabilities
    product_searchAction

    Search products by keywords

    View tool JSON
    {
      "name": "product_search",
      "kind": "act",
      "impl": "imperative",
      "description": "Search products by keywords",
      "inputSchema": {
        "type": "object",
        "properties": {
          "p": {
            "type": "string",
            "description": "search keyword"
          },
          "store": {
            "type": "string",
            "description": "store or seller name"
          },
          "refine": {
            "type": "string",
            "description": "product type or state",
            "anyOf": [
              {
                "const": "all",
                "title": "所有類型商品"
              },
              {
                "const": "buy_now",
                "title": "直購類型商品"
              },
              {
                "const": "bidding",
                "title": "競標類型商品"
              },
              {
                "const": "con_used",
                "title": "二手商品"
              },
              {
                "const": "has_coupon",
                "title": "可使用折扣碼商品"
              }
            ]
          },
          "sort": {
            "type": "string",
            "description": "search sorting",
            "anyOf": [
              {
                "const": "rel",
                "title": "與關鍵字最相關商品資訊"
              },
              {
                "const": "auc_ranking",
                "title": "拍賣全站排名"
              },
              {
                "const": "popular",
                "title": "最高人氣"
              }
            ]
          },
          "minp": {
            "type": "number",
            "default": null,
            "minimum": 1,
            "description": "設定最低商品價格條件"
          },
          "maxp": {
            "type": "number",
            "default": null,
            "maximum": 3000000,
            "description": "設定最高商品價格條件"
          },
          "uloc0": {
            "type": "string",
            "default": null,
            "description": "商品所在地",
            "anyOf": [
              {
                "const": "台北市",
                "title": "台北市"
              },
              {
                "const": "新北市",
                "title": "新北市"
              },
              {
                "const": "基隆市",
                "title": "基隆市"
              },
              {
                "const": "宜蘭縣",
                "title": "宜蘭縣"
              },
              {
                "const": "桃園市",
                "title": "桃園市"
              },
              {
                "const": "新竹市",
                "title": "新竹市"
              },
              {
                "const": "新竹縣",
                "title": "新竹縣"
              },
              {
                "const": "苗栗縣",
                "title": "苗栗縣"
              },
              {
                "const": "台中市",
                "title": "台中市"
              },
              {
                "const": "彰化縣",
                "title": "彰化縣"
              },
              {
                "const": "南投縣",
                "title": "南投縣"
              },
              {
                "const": "嘉義市",
                "title": "嘉義市"
              },
              {
                "const": "嘉義縣",
                "title": "嘉義縣"
              },
              {
                "const": "雲林縣",
                "title": "雲林縣"
              },
              {
                "const": "台南市",
                "title": "台南市"
              },
              {
                "const": "高雄市",
                "title": "高雄市"
              },
              {
                "const": "屏東縣",
                "title": "屏東縣"
              },
              {
                "const": "花蓮縣",
                "title": "花蓮縣"
              },
              {
                "const": "台東縣",
                "title": "台東縣"
              },
              {
                "const": "澎湖縣",
                "title": "澎湖縣"
              },
              {
                "const": "金門",
                "title": "金門"
              },
              {
                "const": "馬祖",
                "title": "馬祖"
              }
            ]
          }
        },
        "required": [
          "p"
        ]
      }
    }
    store_searchAction

    Search store by keywords

    View tool JSON
    {
      "name": "store_search",
      "kind": "act",
      "impl": "imperative",
      "description": "Search store by keywords",
      "inputSchema": {
        "type": "object",
        "properties": {
          "p": {
            "type": "string",
            "description": "search keyword"
          },
          "sort": {
            "type": "string",
            "description": "search sorting",
            "anyOf": [
              {
                "const": "-rating",
                "title": "評價數高"
              },
              {
                "const": "-productCount",
                "title": "商品數高"
              },
              {
                "const": "-likeCount",
                "title": "粉絲數高"
              }
            ],
            "enum": [
              "-rating",
              "-productCount",
              "-likeCount"
            ]
          }
        },
        "required": [
          "p"
        ]
      }
    }
    buyer_orders_searchAction

    搜尋並篩選買家(Buyer)的歷史訂單。適用於使用者詢問:『幫我查上週買的衣服』、『我有一筆訂單退款了嗎』、『追蹤 7-11 運送進度』或提供特定的訂單編號/商品關鍵字進行查詢時。

    View tool JSON
    {
      "name": "buyer_orders_search",
      "kind": "act",
      "impl": "imperative",
      "description": "搜尋並篩選買家(Buyer)的歷史訂單。適用於使用者詢問:『幫我查上週買的衣服』、『我有一筆訂單退款了嗎』、『追蹤 7-11 運送進度』或提供特定的訂單編號/商品關鍵字進行查詢時。",
      "inputSchema": {
        "type": "object",
        "properties": {
          "queryContext": {
            "type": "string",
            "description": "搜尋的關鍵字內容(例如:\"洋裝\"、\"O2026060901\")。請與 queryType 參數搭配使用,將核心搜尋標的填入此處。",
            "default": ""
          },
          "shippingType": {
            "type": "string",
            "description": "依運送方式/物流渠道篩選。當使用者提及特定超商(如全家、7-11)或特定宅配(如低溫、都會送)時填入。若未提及則維持預設值。",
            "default": "全部運送方式",
            "enum": [
              "全部運送方式",
              "郵寄掛號",
              "宅配",
              "低溫配送",
              "全家取貨付款",
              "7-11 取貨付款",
              "7-11 取貨不付款",
              "萊爾富取貨付款",
              "離島寄送",
              "跨國寄送",
              "大型/超重物品運送",
              "面交/自取",
              "郵局貨到付款",
              "都會送"
            ]
          },
          "shippingStatus": {
            "type": "string",
            "description": "依出貨與物流狀態篩選。當使用者詢問『收到了沒』、『出貨了嗎』、『怎麼退貨了』時,對應映射到此狀態(例如:詢問物流卡住可選\"買家商品配送中\",詢問退貨進度可選\"退貨中\")。",
            "default": "全部出貨狀態",
            "enum": [
              "全部出貨狀態",
              "尚未出貨",
              "已上傳出貨檔,待出貨",
              "部份商品已出貨",
              "已出貨",
              "買家商品配送中",
              "買家商品重新配送中",
              "買家商品配送失敗,等待重試",
              "買家商品已到店",
              "買家已取貨",
              "已退貨",
              "退貨中",
              "退貨商品已到物流",
              "退貨商品已到店",
              "賣家申請領回",
              "賣家已取退貨",
              "商品已拋棄 (賣家選擇拋棄)",
              "商品已拋棄 (逾期未領自動拋棄)",
              "逾期未出貨",
              "物流驗收失敗",
              "遺失賠償",
              "毀損賠償"
            ]
          },
          "paymentType": {
            "type": "string",
            "description": "依付款方式篩選。當使用者提及『刷卡』、使用『ATM轉帳』或『超商付款』時進行篩選。",
            "default": "全部付款方式",
            "enum": [
              "全部付款方式",
              "ATM",
              "拍賣帳戶餘額",
              "FamiPort",
              "信用卡",
              "全家取貨付款",
              "7-11 取貨付款",
              "萊爾富取貨付款",
              "郵局貨到付款"
            ]
          },
          "escrowStatus": {
            "type": "string",
            "description": "依價金保管、訂單及退款執行狀態篩選。適用於處理糾紛或確認款項流向,如使用者詢問『什麼時候撥款』、『申請退款進度』或『訂單完成了沒』時。",
            "default": "全部價金保管",
            "enum": [
              "全部價金保管",
              "保管期中",
              "已申請退款",
              "已同意退款",
              "已自動退款",
              "已拒絕退款",
              "已進入協商",
              "協商處理完成",
              "完成訂單"
            ]
          },
          "queryType": {
            "type": "string",
            "description": "指定 queryContext 的搜尋維度。必須根據使用者輸入的內容進行推理選擇:若輸入純數字或序號,優先判斷為\"訂單編號\"或\"商品編號\";若輸入文字,則預設為\"商品關鍵字\"。",
            "default": "商品關鍵字",
            "enum": [
              "訂單編號",
              "商品關鍵字",
              "商品編號",
              "賣家店名",
              "賣家拍賣代號",
              "帳單編號",
              "條碼",
              "商品貨號"
            ]
          },
          "sortBy": {
            "type": "string",
            "description": "查詢結果的排序規則。",
            "default": "訂單成立新到舊",
            "enum": [
              "訂單成立新到舊",
              "訂單成立舊到新",
              "更新時間新到舊"
            ]
          }
        },
        "required": [
          "shippingType",
          "shippingStatus",
          "paymentType",
          "escrowStatus",
          "queryType",
          "sortBy"
        ]
      }
    }
    add_productAction

    將完整的商品資料提交上架。此工具支援「雙模態相容路徑」,Agent 必須嚴格遵守以下決策優先級: 1.【優先路徑 - 多模態直接分析】:若使用者在對話中直接「夾帶/上傳圖片檔案」,Agent 必須發揮多模態視覺能力直接辨識該圖片,並將圖片轉化為 Data URI Base64 格式填入 imageBase64,此時不需執行 analyze_product_image 工具。 2.【次要路徑 - 工具鏈依賴】:若使用者僅提供純文字或圖片網址、未在上下文直接夾帶圖片檔案,則【必須強制先執行】 analyze_product_image 工具取得視覺事實。 ⚠️【超時與錯誤熔斷硬約束】:執行 analyze_product_image 工具的極限超時時間(Timeout)為 60 秒。若該工具執行超過 60 秒無回應,或回傳 isError: true 失敗結果時,代表圖片解析發生異常。模型【嚴禁繼續重試呼叫】、且【嚴禁通靈捏造文案】!必須視同發生致命異常(Throw Exception),立刻中斷所有工具鏈,直接向使用者回報:『圖片分析超時或失敗,上架程序終止。』 ⚠️ 嚴格禁止路徑交叉:若走優先路徑,imageBase64 填入標準 Data URI;若走次要路徑,imageBase64 固定填寫 "未夾帶圖片,已透過工具分析"。所有產出的文案欄位絕對不可憑空想像、必須完全符合圖片事實。

    View tool JSON
    {
      "name": "add_product",
      "kind": "act",
      "impl": "imperative",
      "description": "將完整的商品資料提交上架。此工具支援「雙模態相容路徑」,Agent 必須嚴格遵守以下決策優先級:\n1.【優先路徑 - 多模態直接分析】:若使用者在對話中直接「夾帶/上傳圖片檔案」,Agent 必須發揮多模態視覺能力直接辨識該圖片,並將圖片轉化為 Data URI Base64 格式填入 imageBase64,此時不需執行 analyze_product_image 工具。\n2.【次要路徑 - 工具鏈依賴】:若使用者僅提供純文字或圖片網址、未在上下文直接夾帶圖片檔案,則【必須強制先執行】 analyze_product_image 工具取得視覺事實。\n   ⚠️【超時與錯誤熔斷硬約束】:執行 analyze_product_image 工具的極限超時時間(Timeout)為 60 秒。若該工具執行超過 60 秒無回應,或回傳 isError: true 失敗結果時,代表圖片解析發生異常。模型【嚴禁繼續重試呼叫】、且【嚴禁通靈捏造文案】!必須視同發生致命異常(Throw Exception),立刻中斷所有工具鏈,直接向使用者回報:『圖片分析超時或失敗,上架程序終止。』\n⚠️ 嚴格禁止路徑交叉:若走優先路徑,imageBase64 填入標準 Data URI;若走次要路徑,imageBase64 固定填寫 \"未夾帶圖片,已透過工具分析\"。所有產出的文案欄位絕對不可憑空想像、必須完全符合圖片事實。",
      "inputSchema": {
        "type": "object",
        "properties": {
          "productName": {
            "type": "string",
            "maxLength": 80,
            "description": "商品名稱。例如:\"極簡風陶瓷馬克杯\"。長度嚴格限制在 80 個中文字以內。名稱必須高度符合圖片展現的真實商品品類、顏色與外觀風格。"
          },
          "brand": {
            "type": "string",
            "description": "品牌名稱。若輸入未提及,請根據商品風格自動生成一個虛擬品牌。"
          },
          "imageUrl": {
            "type": "string",
            "format": "uri",
            "description": "商品圖片的完整 URL 網址。若為多模態上傳,請帶入系統生成的圖片託管 URL。"
          },
          "imageBase64": {
            "anyOf": [
              {
                "type": "string",
                "format": "data-uri",
                "description": "【優先路徑使用】當使用者有直接夾帶實體圖片檔案時,請將該圖片數據轉換為標準的 Data URI 格式(如 data:image/jpeg;base64,...)。"
              },
              {
                "type": "string",
                "enum": [
                  "未夾帶圖片,已透過工具分析"
                ],
                "description": "【次要路徑使用】當使用者沒有夾帶實體圖片檔案時,必須固定填寫此精準字串。"
              }
            ]
          },
          "shortDescription": {
            "type": "string",
            "maxLength": 70,
            "description": "適合放在商品列表的精簡短描述。風格活潑有趣,長度嚴格限制在 70 個中文字以內。⚠️注意:文案內容皆須嚴格結合真實圖片特徵(實體圖片內容或前述工具分析之事實)進行撰寫,嚴格禁止脫離圖片事實憑空捏造特色。"
          },
          "productDescription": {
            "type": "string",
            "description": "豐富的商品完整詳細描述。⚠️【字數與事實硬性約束】:總字數必須「至少 500 字」,且「絕對不可超過 1000 字」。文案內容皆須嚴格結合真實圖片特徵進行撰寫,嚴格禁止通靈與脫離事實。\n\n💡【行銷長文案建議結構】:為確保內容豐富且層次分明,請包含以下四大區塊:\n1.【吸睛引言】:結合圖片呈現的氛圍,點出商品的質感與第一眼印象。\n2.【細節與材質解密】:深入描繪觀察到的顏色細節、線條、材質或特殊工藝,將視覺轉化為文字觸感。\n3.【多元情境舞台】:想像並描繪至少兩個這件商品最適合出現的生活場景或使用體驗(例如:辦公桌上的儀式感、週末約會的焦點)。\n4.【品牌情感連結】:呼應 brand 欄位,撰寫一段符合該商品風格的品牌堅持或貼心語錄,完成高質感的行銷長文案。"
          },
          "hashtags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 3,
            "maxItems": 5,
            "description": "社群熱門雜湊標籤(Hashtags)。數量嚴格限制在最少 3 個,最多 5 個。標籤內容必須高度相關於圖片中商品的真實特徵、分類或風格(例如:#針織背心、#復古馬克杯),勿帶入無關的萬用詞。"
          }
        },
        "required": [
          "productName",
          "brand",
          "imageUrl",
          "imageBase64",
          "shortDescription",
          "productDescription",
          "hashtags"
        ]
      }
    }
    analyze_product_imageAction

    當使用者提供商品圖片網址,但沒有提供細節特徵時使用。此工具會由後端下載圖片並完成視覺辨識,回傳該商品的顏色、材質、外觀、風格等具體文字描述。

    View tool JSON
    {
      "name": "analyze_product_image",
      "kind": "act",
      "impl": "imperative",
      "description": "當使用者提供商品圖片網址,但沒有提供細節特徵時使用。此工具會由後端下載圖片並完成視覺辨識,回傳該商品的顏色、材質、外觀、風格等具體文字描述。",
      "inputSchema": {
        "type": "object",
        "properties": {
          "imageUrl": {
            "type": "string",
            "format": "uri",
            "description": "需要解析的商品圖片網址。"
          }
        },
        "required": [
          "imageUrl"
        ]
      }
    }
    compare_productsAction

    比較多個商品的優缺點。 ⚠️【前置硬性條件】:Agent 必須先呼叫 get_product_details 取得商品基礎事實資料。 ⚠️【大腦推理提前中斷機制】:若 get_product_details 的回傳結果因部分商品不存在、下架或系統錯誤,導致「最終成功取得詳細資料的有效商品不足 2 筆」時,此比較工具已失去執行意義。模型【嚴禁】強行呼叫此工具!模型必須立刻中斷工具鏈流程,並以親切的自然語言向使用者說明哪些商品讀取失敗、以及因有效商品不足兩筆而無法進行比較的真實原因。 💡【分析原則】:當符合前置條件時,請由模型針對各個維度進行深度分析,並將結構化的比較結果傳回後端。注意:分析內容必須嚴格基於 get_product_details 所提供的客觀資料,嚴禁虛構特徵。

    View tool JSON
    {
      "name": "compare_products",
      "kind": "act",
      "impl": "imperative",
      "description": "比較多個商品的優缺點。\n⚠️【前置硬性條件】:Agent 必須先呼叫 get_product_details 取得商品基礎事實資料。\n⚠️【大腦推理提前中斷機制】:若 get_product_details 的回傳結果因部分商品不存在、下架或系統錯誤,導致「最終成功取得詳細資料的有效商品不足 2 筆」時,此比較工具已失去執行意義。模型【嚴禁】強行呼叫此工具!模型必須立刻中斷工具鏈流程,並以親切的自然語言向使用者說明哪些商品讀取失敗、以及因有效商品不足兩筆而無法進行比較的真實原因。\n💡【分析原則】:當符合前置條件時,請由模型針對各個維度進行深度分析,並將結構化的比較結果傳回後端。注意:分析內容必須嚴格基於 get_product_details 所提供的客觀資料,嚴禁虛構特徵。",
      "inputSchema": {
        "type": "object",
        "properties": {
          "productIds": {
            "type": "array",
            "minItems": 2,
            "maxItems": 5,
            "items": {
              "type": "string"
            },
            "description": "參與比較的商品編號陣列。"
          },
          "analysisResult": {
            "type": "object",
            "description": "模型對商品進行多維度分析後的結構化結果。",
            "properties": {
              "comparisonDimensions": {
                "type": "array",
                "description": "不同比較維度(例如:價格、外觀設計、規格與色系)的對比列表。",
                "items": {
                  "type": "object",
                  "properties": {
                    "dimensionName": {
                      "type": "string",
                      "description": "比較的維度名稱,例如 \"價格競爭力\"、\"硬體規格\"、\"續航力\""
                    },
                    "analysisSummary": {
                      "type": "string",
                      "description": "該維度下各商品的綜合對比概述。"
                    },
                    "productComparisonList": {
                      "type": "array",
                      "description": "每個商品在此維度下的細緻表現對比列表。必須包含所有參與比較的商品。",
                      "items": {
                        "type": "object",
                        "properties": {
                          "productId": {
                            "type": "string",
                            "description": "參與比較的商品編號(Product ID),必須與 productIds 陣列中的字串完全一致(例如 \"101734803016\"),嚴禁帶有任何 \"item_\" 或 \"long_\" 前綴。"
                          },
                          "rating": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 5,
                            "description": "該商品在此維度的表現評等。數值範圍為 1 到 5 的整數(1 代表最差、5 代表最佳)。"
                          },
                          "pros": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "該商品在此維度下的優點列表(必須基於事實,嚴禁胡謅)"
                          },
                          "cons": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "該商品在此維度下的缺點列表(必須基於事實,嚴禁胡謅)"
                          }
                        },
                        "required": [
                          "productId",
                          "rating",
                          "pros",
                          "cons"
                        ]
                      }
                    }
                  },
                  "required": [
                    "dimensionName",
                    "analysisSummary",
                    "productComparisonList"
                  ]
                }
              },
              "finalVerdict": {
                "type": "string",
                "description": "整體的購買建議與客群推薦總結。\n⚠️【重要格式命令】:此欄位【必須】完全使用標準 Markdown 語法撰寫,嚴禁輸出純文字!\n請嚴格遵循以下 Markdown 結構模板進行排版:\n### 🎯 整體購買建議\n(這裡填寫一兩句總結核心重點)\n\n### 👥 依需求推薦客群\n* **追求性價比/小資包色**:首選 `商品ID`,因為...\n* **追求獨特設計感**:首選 `商品ID`,因為...\n\n> 💡 *小提醒:三款商品均為同一賣家提供,可視穿衣習慣與場景需求進行搭配挑選。*"
              }
            },
            "required": [
              "comparisonDimensions",
              "finalVerdict"
            ]
          }
        },
        "required": [
          "productIds",
          "analysisResult"
        ]
      }
    }
    get_product_detailsAnswer

    當使用者提供一個或者多個商品編號(Product IDs)時,批量查詢並提供對應的完整商品資訊,包含:商品名稱、商品短描述、商品長描述、商品規格、hashtags、價格、付款方式以及商品狀態等。此工具通常作為商品比較(compare_products)的前置步驟。 ⚠️【失敗處理與中斷規範】:若此工具呼叫後回傳 isError: true,代表資料庫完全無此商品、商品已下架或伺服器異常。模型【嚴禁】在未經使用者指示下自行修改參數(如胡亂猜測 ID、或移除看似錯誤的 ID)並重複呼叫此工具!模型必須立刻中止工具鏈流程,並將「系統查詢失敗,查無此商品」的訊息直接誠實呈現給使用者。

    View tool JSON
    {
      "name": "get_product_details",
      "kind": "answer",
      "impl": "imperative",
      "description": "當使用者提供一個或者多個商品編號(Product IDs)時,批量查詢並提供對應的完整商品資訊,包含:商品名稱、商品短描述、商品長描述、商品規格、hashtags、價格、付款方式以及商品狀態等。此工具通常作為商品比較(compare_products)的前置步驟。\n⚠️【失敗處理與中斷規範】:若此工具呼叫後回傳 isError: true,代表資料庫完全無此商品、商品已下架或伺服器異常。模型【嚴禁】在未經使用者指示下自行修改參數(如胡亂猜測 ID、或移除看似錯誤的 ID)並重複呼叫此工具!模型必須立刻中止工具鏈流程,並將「系統查詢失敗,查無此商品」的訊息直接誠實呈現給使用者。",
      "inputSchema": {
        "type": "object",
        "properties": {
          "productIds": {
            "type": "array",
            "minItems": 1,
            "maxItems": 5,
            "items": {
              "type": "string",
              "description": "單一商品的唯一識別編號(Product ID)"
            },
            "description": "包含一個或多個商品編號的陣列,用於批量查詢商品細節。"
          }
        },
        "required": [
          "productIds"
        ]
      }
    }