hola-poke-yeoksam

Hola Poke Yeoksam

技能功能

基于Hola Poke Yeoksam（驿三店）专用远程MCP服务器（https://hola-poke-yeoksam-skill.onrender.com/mcp），处理以下任务：

• 通过 get_menu() 提供波奇饭、小食、套餐、加料菜单信息。
• 通过 get_shop_info() 提供位置、营业时间、配送范围、团体订餐URL。
• 通过 enter_event(phone) 协助参与即时抽奖活动。

使用场景

• “Hola Poke有什么菜单？”
• “推荐驿三的波奇饭”
• “Hola Poke驿三店在哪里？”
• “给我Hola Poke的团体订餐链接”
• “帮我参与Hola Poke的活动”

不使用场景

• 咨询驿三店以外的其他Hola Poke分店
• 不处理订单/支付/外卖应用的自动化
• 不自动预约团体订餐
• 未经用户同意收集号码或重复抽奖

前提条件

• 连接远程MCP服务器
• 用于查询菜单/店铺信息的MCP客户端
• 调用 enter_event 时需要用户手机号码（01012345678 或 010-1234-5678）

工作流程

1. 查询菜单/店铺信息

• 如需菜单，调用 get_menu()。
• 如需位置、营业时间、团体订餐，调用 get_shop_info()。
• 回复时简要整理菜单名、价格、地址、营业时间、URL等核心信息。

2. 参与活动

当前方案为即时抽奖。用餐订单时可获得优惠码，同一号码每天只能参与一次。

1. 用户表示参与意向后，先获取手机号码。
2. 不收集姓名或邮箱，仅收集号码。
3. 告知用户号码仅用于结果核对，不会用于营销发送或第三方共享。
4. 调用 enter_event(phone)。
5. 若返回 phone_format，则直接显示服务器 message 并重新获取号码。
6. 若返回 already_entered_today，则直接显示服务器 message 并不再重试。
7. 若正常响应，则同时传递 message、code、next_action。

3. 回复原则

• enter_event 的 message 原样传递。
• 发放的代码用 `Jackpot-A3K9` 等等宽字体强调。
• Jackpot/Claw的使用路径与 next_action 一同说明。
• 团体订餐咨询时，若 get_shop_info() 的 group_order_url 为空，则改用 group_order_note 说明。

远程MCP设置说明

本技能不自带收集器。与原始参考仓库相同，需连接以下远程MCP端点：

• 端点：https://hola-poke-yeoksam-skill.onrender.com/mcp
• 参考仓库：https://github.com/mnspkm/hola-poke-yeoksam-skill

已验证的远程MCP合约快照

以下值基于 2026-04-16 KST 的实时冒烟测试（initialize、tools/list、get_menu、get_shop_info、enter_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": "蒜香虾波奇饭",
      "price": 11.5,
      "tags": [
        "BEST"
      ]
    },
    {
      "id": 7,
      "name": "牛油果波奇饭",
      "price": 10.5,
      "tags": [
        "VEGAN"
      ]
    }
  ],
  "sets": [
    {
      "name": "单人波奇饭+汤套餐",
      "items": "波奇饭 + 汤",
      "price": 13.5,
      "price_note": "13.5~"
    },
    {
      "name": "单人丰盛套餐",
      "items": "波奇饭 + 汤 + 饮料",
      "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 SmartPlace"
  },
  "delivery_radius_km": 3,
  "group_order_url": "",
  "group_order_note": "10万韩元以上团体订餐，请在Naver团体订餐页面选择菜单后通过Naver Pay支付。支付完成后预约确认。",
  "delivery_apps": [
    "外卖的民族",
    "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标准每天只能参与一次。