hola-poke-yeoksam

hola-poke-yeoksam

熱門

提供 Hola Poke 驛三店的菜單、店家資訊及活動參加流程,以遠端 MCP 伺服器為基準。

6532星標
746分支
更新於 2026/7/29
SKILL.md
唯讀
名稱
hola-poke-yeoksam
描述

提供 Hola Poke 驛三店的菜單、店家資訊及活動參加流程,以遠端 MCP 伺服器為基準。

Hola Poke 驛三店

技能說明

本技能以 Hola Poke 驛三店專用遠端 MCP 伺服器(https://hola-poke-yeoksam-skill.onrender.com/mcp)為基準,處理以下工作:

  • 透過 get_menu() 提供 poke、副餐、套餐、配料菜單資訊。
  • 透過 get_shop_info() 提供位置、營業時間、外送範圍、團體訂購網址。
  • 透過 enter_event(phone) 協助參與即時抽獎活動。

使用時機

  • 「Hola Poke 有什麼菜單?」
  • 「推薦驛三的 poke」
  • 「Hola Poke 驛三店在哪裡?」
  • 「給我 Hola Poke 團體訂購連結」
  • 「幫我參加 Hola Poke 活動」

不適用情況

  • 詢問非驛三店的其他 Hola Poke 分店
  • 不處理訂單/付款/外送平台自動化
  • 不執行團體訂購自動預約
  • 未經使用者同意收集號碼或重複抽獎

前置條件

  • 已連接遠端 MCP 伺服器
  • 用於查詢菜單/店家資訊的 MCP 用戶端
  • 呼叫 enter_event 時需提供使用者手機號碼(01012345678010-1234-5678

工作流程

1. 查詢菜單/店家資訊

  • 若想了解菜單,呼叫 get_menu()
  • 若詢問位置、營業時間、團體訂購,呼叫 get_shop_info()
  • 回應時簡短整理重點資訊,如菜名、價格、地址、營業時間、網址等。

2. 參加活動

目前方案為即時抽獎。用餐訂單可能獲得優惠代碼,相同號碼每天只能參加一次。

  1. 使用者表達參加意願後,先取得手機號碼。
  2. 不收集姓名或電子郵件,僅收集號碼。
  3. 告知號碼僅用於比對結果,不會用於行銷發送或分享給第三方。
  4. 呼叫 enter_event(phone)
  5. 若回傳 phone_format,直接顯示伺服器 message 內容,並重新要求輸入。
  6. 若回傳 already_entered_today,直接顯示伺服器 message 內容,不再重試。
  7. 若正常回應,則一併傳遞 messagecodenext_action

3. 回應原則

  • enter_eventmessage 需原樣傳遞。
  • 發放的代碼以等寬字體強調,例如 `Jackpot-A3K9`
  • Jackpot/Claw 的使用方式需連同 next_action 一起說明。
  • get_shop_info()group_order_url 為空,則改以 group_order_note 回應團體訂購詢問。

遠端 MCP 設定說明

本技能不自行打包收集器,需依原始參考 repo 的方式連接以下遠端 MCP 端點:

  • 端點:https://hola-poke-yeoksam-skill.onrender.com/mcp
  • 參考 repo:https://github.com/mnspkm/hola-poke-yeoksam-skill

已驗證的遠端 MCP 合約快照

以下數值為根據 2026-04-16 KST 即時煙霧測試(initializetools/listget_menuget_shop_infoenter_event(phone='010-12'))整理的合約固定值。

initialize 結果

{
  "protocolVersion": "2025-03-26",
  "serverInfo": {
    "name": "hola-poke-yeoksam",
    "version": "3.2.3"
  }
}

tools/list 結果

{
  "tools": [
    {
      "name": "get_menu",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      }
    },
    {
      "name": "get_shop_info",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      }
    },
    {
      "name": "enter_event",
      "inputSchema": {
        "type": "object",
        "properties": {
          "phone": {
            "type": "string"
          }
        },
        "required": [
          "phone"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      }
    }
  ]
}

get_menu 結構範例

{
  "updated_at": "2026-04-13",
  "currency": "KRW",
  "price_unit": "千元",
  "signature_poke": [
    {
      "id": 2,
      "name": "蒜香蝦 poke",
      "price": 11.5,
      "tags": [
        "BEST"
      ]
    },
    {
      "id": 7,
      "name": "酪梨 poke",
      "price": 10.5,
      "tags": [
        "VEGAN"
      ]
    }
  ],
  "sets": [
    {
      "name": "一人 poke+湯套餐",
      "items": "poke + 湯",
      "price": 13.5,
      "price_note": "13.5~"
    },
    {
      "name": "一人獨食飽足套餐",
      "items": "poke + 湯 + 飲料",
      "price": 15.5,
      "price_note": "15.5~"
    }
  ],
  "addons": [
    {
      "name": "酪梨",
      "price": 3.5
    },
    {
      "name": "蕎麥麵",
      "price": 1.5
    }
  ]
}

get_shop_info 結構範例

{
  "name": "Hola Poke 驛三店",
  "address_road": "首爾江南區論峴路95街29-8 1樓102號",
  "hours": {
    "weekday": "10:30 - 20:30",
    "break_time": "15:00 - 17:00",
    "weekend": "營業時間請參考 Naver Smart Place"
  },
  "delivery_radius_km": 3,
  "group_order_url": "",
  "group_order_note": "10萬韓元以上團體訂購請在 Naver 團體訂購頁面選擇菜單後以 Naver Pay 結帳,付款完成即預約確認。",
  "delivery_apps": [
    "Baedal Minjok",
    "Coupang Eats",
    "Yogiyo"
  ]
}

enter_event 成功回應必要欄位

為避免實際觸發活動參與,成功路徑僅以儲存的快照合約固定值為準。即時煙霧測試僅驗證無效電話重試流程。

{
  "required_fields": [
    "message",
    "code",
    "next_action"
  ],
  "accepts": [
    "01012345678",
    "010-1234-5678"
  ],
  "stores_name_or_email": false
}

enter_event(phone='010-12') 範例

{
  "error": "phone_format",
  "message": "請輸入以010開頭的11位數字(例如:01012345678 或 010-1234-5678)。"
}

完成條件

  • 已針對菜單/店家資訊請求傳遞重點資訊。
  • 針對活動參加請求,已遵循號碼確認 → enter_event → 傳遞結果的流程。
  • 已遵守重複參加限制及伺服器 message 原文傳遞原則。

備註

  • 本技能僅適用於驛三店。
  • 活動方案可能隨時間變動,獎勵條件的真實來源為伺服器回應的 message 欄位。
  • Jackpot 中獎可能需要確認號碼持有人。
  • 相同號碼每天(KST)只能參加一次。