Blue Ribbon Nearby

What this skill does

ユーザーが提供した現在位置に基づいて、Blue Ribbon公式ゾーンを検索し、k-skill-proxyを経由して近くのBlue Ribbonレストランを表示します。

• 位置は自動推定しません。
• 必ず先に現在位置を質問します。
• 位置文字列は公式zoneリストにマッチし、近くのJSONエンドポイントで絞り込みます。
• 座標を直接受け取ると、より正確な近くの検索ができます。
• 近くの検索は基本的にk-skill-proxy (/v1/blue-ribbon/nearby) を経由します。プロキシにBLUE_RIBBON_SESSION_IDが設定されている必要があります。

When to use

• "近くのおいしいお店を探して"
• "ここら辺のBlue Ribbonレストランはどこ？"
• "光化門の近くのいい食堂をすすめてよ"
• "私の周りのBlue Ribbon飲食店だけを見せて"

Routing rule

• ユーザーがおいしいお店 / 近くのレストラン / 近くのレストラン について質問したら、基本的にこのスキルから考慮します。
• ただし、ユーザーがBlue Ribbon以外の基準（例：MangoPlate、Naver Map レビュー、特定の飲食店予約）を明示したら、その基準を優先します。

Prerequisites

• インターネット接続
• node 18+
• このリポジトリのblue-ribbon-nearbyパッケージまたは同等ロジック

Mandatory first question

位置情報なしでいきなり検索してはいけません。必ず先に質問してください。

• 推奨質問：現在位置を教えてください。町名／駅名／ランドマーク／緯度・経度のいずれかの形式で送っていただければ、近くのBlue Ribbonレストランを探してみます。
• 位置が曖昧な場合：一番近い駅名または町名をもう一度教えてください。
• 座標を受け取ったら、そのまま近くの検索に使用します。

Accepted location inputs

• 町名／商圏：成水洞、光化門、版教
• 駅名／ランドマーク：江南駅、ソウル駅、COEX
• 緯度／経度：37.573713, 126.978338

ランドマークは内部エイリアスで最も近い公式Blue Ribbonゾーン名にマッチします。例：COEX → 三星洞／大治洞

Official Blue Ribbon surfaces

• zone catalog: https://www.bluer.co.kr/search/zone
• nearby search JSON: https://www.bluer.co.kr/restaurants/map
• search page: https://www.bluer.co.kr/search

重要な近くのパラメータ：

• zone1
• zone2
• zone2Lat
• zone2Lng
• isAround=true
• ribbon=true
• ribbonType=RIBBON_THREE,RIBBON_TWO,RIBBON_ONE
• distance=500|1000|2000|5000

座標を直接検索する場合は、latitude1、latitude2、longitude1、longitude2バウンディングボックスを使用します。

Workflow

1. Ask the current location first

位置を聞かずに検索を開始しないでください。

2. Resolve the location

• 町名／駅名／ランドマークを受け取ったら、まず公式https://www.bluer.co.kr/search/zoneリストと照合します。
• COEXのような公式ゾーン名ではなく代表的なランドマークの場合は、最も近い公式ゾーンエイリアスに最初に拡張します。
• 緯度／経度を受け取ったら、座標ベースの近くの検索に直接進みます。
• 最も有力なゾーン候補が複数ある場合は、2～3個だけを表示して再度確認します。

3. Query the nearby Blue Ribbon endpoint

基本的にk-skill-proxyを経由して近くの結果を取得します。

const { searchNearbyByLocationQuery } = require("blue-ribbon-nearby");

const result = await searchNearbyByLocationQuery("광화문", {
  distanceMeters: 1000,
  limit: 5
});

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

内部的には、ゾーンマッチング後、プロキシの/v1/blue-ribbon/nearbyに座標と距離を渡します。プロキシはプレミアムセッションでBlue Ribbonアップストリームを呼び出します。

直接呼び出しが必要な場合は、useDirectApi: trueオプションを使用できますが、プレミアムセッションなしではpremium_requiredエラーが発生します。

4. Respond with a short restaurant summary

通常3～5個だけを簡潔に整理します。

• 店名
• リボン数
• 代表的なカテゴリー
• 住所
• 距離

Done when

• ユーザーの現在位置を先に確認しました。
• 公式Blue Ribbon近くの結果を最低1つ以上見つけた、またはプロキシが未設定などの理由で結果を取得できないことを示し、次の質問を提示しました。
• 結果を距離順に簡潔に整理しました。

ブラウザフォールバック（ボット遮断回避）

bluer.co.krが自動化アクセスをブロック（403）する場合、rebrowser-playwrightがインストールされていれば、実際のChromeブラウザを経由して自動的にフォールバックします。

条件

• rebrowser-playwrightがインストールされている必要があります：npm install rebrowser-playwright
• Google Chromeがシステムにインストールされている必要があります
• headedモードで動作します（ディスプレイ環境が必要）

動作方式

1. 既存のfetch要求が403を返した場合、自動的にブラウザフォールバックを有効化
2. stealth パッチを適用（webdriver削除、plugins/languages スプーフィングなど）
3. 実際のChromeでゾーンカタログまたはnearby APIを呼び出し
4. 結果を既存のパイプラインにそのまま渡す

追加の設定なしに、rebrowser-playwrightをインストールするだけで自動的に動作します。インストールされていない場合は、既存通り403エラーをそのまま返します。

Failure modes

• 位置文字列が公式ゾーンとうまくマッチしない可能性があります。
• 同じキーワードが複数の商圏にまたがる場合、追加の確認が必要です。
• Blue Ribbonサイトが構造やパラメータを変更すると、ゾーン解析またはnearbyエンドポイントが壊れる可能性があります。
• プロキシのBLUE_RIBBON_SESSION_IDが期限切れ（30日）になったら更新が必要です。
• ブラウザフォールバックはheadedモード専用のため、サーバー（CI）環境では動作しません。

Notes

• このスキルは検索型スキルです。
• ユーザーの位置は自動追跡せず、会話中に受け取った値のみを使用します。
• 飲食店の問い合わせは基本的にこのスキルを先に使いますが、Blue Ribbon以外の基準が明示された場合はその基準を優先します。