Kakao Bar Nearby

このスキルの機能

ユーザーが教えてくれた現在地に基づいて、カカオマップで近所の居酒屋を見つけます。

• 位置情報は自動推定しません。
• 必ず最初に現在地をお尋ねします。
• ソウル駅、江南、社堂、新論峴、論峴などの駅名・地域名・ランドマーク検索をそのまま受け付けることができます。
• 結果には、営業状況、代表メニュー、座席オプション（グループ席・バーテーブルなど）、電話番号が含まれます。

使用するタイミング

• 「ソウル駅近くの居酒屋を探して」
• 「江南で今営業中のワインバーはどこ？」
• 「論峴の近くで4人で行ける居酒屋を教えて」
• 「社堂で電話番号がある居酒屋を何軒か見せて」

必須の最初の質問

位置情報なしで直接検索してはいけません。必ず最初にお尋ねください。

• 推奨質問：現在地をお教えください。ソウル駅／江南／社堂のような駅名や地域名でお送りいただければ、カカオマップ基準の近所の居酒屋を探します。
• 位置が曖昧な場合：近い駅名または洞の名前をもう一度お教えください。

公式カカオマップサーフェス

• モバイル検索：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. 受け取った位置情報文字列をカカオマップ検索で、アンカー候補（駅・ランドマーク）として解釈します。
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軒以上見つけたか、見つからなかった理由と次の質問を提示した。
• 営業状況・メニュー・座席オプション・電話番号が含まれたサマリーを表示した。