kakao-bar-nearby

Kakao Bar Nearby

這個技能的功能

根據使用者提供的目前位置，透過 Kakao Map 尋找附近酒吧。

• 不會自動推測位置。
• 務必先詢問目前位置。
• 可直接接受如 서울역、강남、사당、신논현、논현 等站名/區域/地標查詢。
• 結果包含目前營業狀態、代表菜單、座位選項（團體席/吧檯等）、電話號碼。

使用時機

• "幫我找首爾站附近的酒吧"
• "江南現在有營業的葡萄酒吧有哪些？"
• "論峴附近適合四個人去的酒吧"
• "舍堂有電話的居酒屋推薦幾間"

必問的第一個問題

在沒有位置資訊時，不要直接搜尋，務必先詢問。

• 建議提問：현재 위치를 알려주세요. 서울역/강남/사당 같은 역명이나 동네명으로 보내주시면 카카오맵 기준 근처 술집을 찾아볼게요.
• 若位置不明確：가까운 역명이나 동 이름으로 한 번만 더 알려주세요.

官方 Kakao Map 頁面

• 行動搜尋：https://m.map.kakao.com/actions/searchView?q=<query>
• 地點面板 JSON：https://place-api.map.kakao.com/places/panel3/<confirmId>
• 地點詳細頁面：https://place.map.kakao.com/<confirmId>

工作流程

1. 務必先詢問使用者的目前位置。
2. 將取得的位置字串透過 Kakao Map 搜尋解析為錨點候選（車站/地標）。
3. 在同一位置字串加上 술집 關鍵字，取得附近酒吧搜尋結果。
4. 查詢前幾個候選的 panel3 JSON，正規化目前營業狀態、菜單、座位選項、電話號碼。
5. 優先顯示正在營業的酒吧，必要時也顯示即將營業的店家。

回應方式

通常簡短整理 3~5 間。

• 酒吧名稱
• 類別
• 營業狀態（영업 중、영업 전、휴무일 等）
• 代表菜單 2~3 項
• 座位/人數容納提示（단체석、바테이블 等）
• 電話號碼
• 距離（如果有的話）

Node.js 範例

const { searchNearbyBarsByLocationQuery } = require("kakao-bar-nearby");

async function main() {
  const result = await searchNearbyBarsByLocationQuery("서울역", {
    limit: 5
  });

  console.log(result.anchor);
  console.log(result.items);
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

完成條件

• 已先確認使用者的目前位置。
• 已找到至少 1 間 Kakao Map 上的酒吧結果，或說明找不到的原因並提出後續問題。
• 已顯示包含營業狀態/菜單/座位選項/電話號碼的摘要。