kakao-bar-nearby

Kakao Bar Nearby

What this skill does

根据用户提供的当前位置，查找 Kakao Map 基准下的附近酒吧。

• 不会自动推断位置。
• 必须先询问当前位置。
• 可以直接接收如 서울역（首尔站）、강남（江南）、사당（舍堂）、신논현（新论岘）、논현（论岘）等地铁站名、街区或地标查询。
• 结果中包含当前营业状态、代表菜单/招牌菜、座位选项（如团体席、吧台席等）以及联系电话。

When to use

• “帮我找找首尔站附近的酒吧”
• “江南附近现在营业的红酒吧有哪些？”
• “论岘附近适合 4 个人去的酒吧推荐一下”
• “舍堂附近推荐几家有联系电话的居酒屋”

Mandatory first question

绝不能在没有位置信息的情况下直接搜索，必须先询问位置。

• 推荐提问方式：请告诉我您的当前位置。您可以发送如首尔站/江南/舍堂等地铁站名或街区名称，我将基于 Kakao Map 为您查找附近的酒吧。
• 若位置不够明确：请再告诉我一次就近的地铁站名或行政洞（街区）名称。

Official Kakao Map surfaces

• 移动端搜索：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>

Workflow

1. 必须先向用户询问当前位置。
2. 将接收到的位置字符串提交给 Kakao Map 搜索，解析为定位锚点候选（地铁站/地标）。
3. 在同一位置字符串后附加 술집（酒吧）关键词，获取附近的酒吧搜索结果。
4. 查询排名靠前候选的 panel3 JSON，格式化整理当前营业状态、菜单、座位选项及电话号码。
5. 优先展示正在营业的酒吧，必要时可附带展示即将营业的地方。

Responding

通常简要整理 3~5 家即可。

• 酒吧名称
• 分类
• 营业状态（如 营业中、未营业、休息日 等）
• 招牌菜单 2~3 个
• 座位/容纳人数提示（如 团体席、吧台席 等）
• 电话号码
• 距离（若可行）

Node.js example

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;
});

Done when

• 已首先确认用户的当前位置。
• 基于 Kakao Map 找到了至少 1 个酒吧结果，或给出了未找到的原因及后续提问建议。
• 展示了包含营业状态、菜单、座位选项及电话号码的摘要信息。