---
id: daily-blue-ribbon-nearby
name: "blue-ribbon-nearby"
url: https://skills.yangsir.net/skill/daily-blue-ribbon-nearby
author: nomadamas
domain: lifestyle
tags: ["restaurant", "food", "korea", "blue-ribbon"]
install_count: 2200
rating: 4.30 (10 reviews)
github: https://github.com/nomadamas/k-skill
---

# blue-ribbon-nearby

> 基于用户位置查找附近的蓝丝带认证餐厅，返回距离、评分、营业状态和推荐菜品信息

**Stats**: 2,200 installs · 4.3/5 (10 reviews)

## Before / After 对比

### 附近美食发现

**Before**:

在多个美食 APP 上搜索附近餐厅，筛选蓝丝带认证店，逐个查看评分和评价，对比营业状态和距离，需要 20-30 分钟

**After**:

告知当前位置，15 秒自动推荐附近的蓝丝带餐厅，按距离排序，包含评分、营业状态和招牌菜

| Metric | Before | After | Change |
|---|---|---|---|
| 筛选时间 | 1500秒 | 15秒 | -99% |

## Readme

# blue-ribbon-nearby

# Blue Ribbon Nearby

## What this skill does

유저가 알려준 현재 위치를 기준으로 블루리본 서베이 공식 zone 을 찾고, k-skill-proxy 를 경유해 **근처 블루리본 맛집**을 보여준다.

- 위치는 자동으로 추정하지 않는다.

- **반드시 먼저 현재 위치를 질문**한다.

- 위치 문자열은 공식 `zone` 목록으로 매칭하고, 주변 JSON endpoint 로 좁혀서 찾는다.

- 좌표를 직접 받으면 더 정확한 nearby 검색을 할 수 있다.

- nearby 검색은 기본적으로 k-skill-proxy (`/v1/blue-ribbon/nearby`) 를 경유한다. 프록시에 `BLUE_RIBBON_SESSION_ID` 가 설정되어 있어야 한다.

## When to use

- "근처 맛집 찾아줘"

- "여기 근처 블루리본 맛집 뭐 있어?"

- "광화문 근처 괜찮은 식당 추천해줘"

- "내 주변 블루리본 식당만 보여줘"

## Routing rule

- 사용자가 **맛집** / **근처 식당** / **근처 레스토랑** 을 물으면 기본적으로 이 스킬부터 고려한다.

- 다만 사용자가 블루리본 외 다른 기준(예: 망고플레이트, 네이버 지도 리뷰, 특정 음식점 예약) 을 명시하면 그 표면을 우선한다.

## Prerequisites

- 인터넷 연결

- `node` 18+

- 이 저장소의 `blue-ribbon-nearby` package 또는 동일 로직

## Mandatory first question

위치 정보 없이 바로 검색하지 말고 반드시 먼저 물어본다.

- 권장 질문: `현재 위치를 알려주세요. 동네/역명/랜드마크/위도·경도 중 편한 형식으로 보내주시면 근처 블루리본 맛집을 찾아볼게요.`

- 위치가 애매하면: `가까운 역명이나 동 이름으로 한 번만 더 알려주세요.`

- 좌표를 받으면 그대로 nearby 검색에 사용한다.

## Accepted location inputs

- 동네/상권: `성수동`, `광화문`, `판교`

- 역명/랜드마크: `강남역`, `서울역`, `코엑스`

- 위도/경도: `37.573713, 126.978338`

랜드마크는 내부 alias 로 가장 가까운 공식 Blue Ribbon zone 이름에 매칭한다. 예: `코엑스` → `삼성동/대치동`

## 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`

핵심 nearby 파라미터:

- `zone1`

- `zone2`

- `zone2Lat`

- `zone2Lng`

- `isAround=true`

- `ribbon=true`

- `ribbonType=RIBBON_THREE,RIBBON_TWO,RIBBON_ONE`

- `distance=500|1000|2000|5000`

좌표 직접 검색 시에는 `latitude1`, `latitude2`, `longitude1`, `longitude2` bounding box 를 사용한다.

## Workflow

### 1. Ask the current location first

위치를 안 물은 상태에서 검색을 시작하지 않는다.

### 2. Resolve the location

- 동네/역명/랜드마크를 받으면 공식 `https://www.bluer.co.kr/search/zone` 목록과 먼저 매칭한다.

- 코엑스처럼 공식 zone 이름이 아닌 대표 랜드마크는 가장 가까운 공식 zone alias 로 먼저 확장한다.

- 위도/경도를 받으면 좌표 기반 nearby 검색으로 바로 들어간다.

- 가장 유력한 zone 후보가 여러 개면 2~3개만 보여주고 다시 확인받는다.

### 3. Query the nearby Blue Ribbon endpoint

기본적으로 k-skill-proxy 를 경유해 nearby 결과를 가져온다.

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

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

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

```

내부적으로는 zone 매칭 후 프록시의 `/v1/blue-ribbon/nearby` 에 좌표와 거리를 넘긴다. 프록시가 프리미엄 세션으로 Blue Ribbon upstream 을 호출한다.

직접 호출이 필요하면 `useDirectApi: true` 옵션을 쓸 수 있지만, 프리미엄 세션 없이는 `premium_required` 에러가 난다.

### 4. Respond with a short restaurant summary

보통 3~5개만 짧게 정리한다.

- 식당명

- 리본 개수

- 대표 음식 카테고리

- 주소

- 거리

## Done when

- 유저의 현재 위치를 먼저 확인했다.

- 공식 Blue Ribbon nearby 결과를 최소 1개 이상 찾았거나, 프록시 미설정 등의 이유로 결과를 가져올 수 없다는 이유와 다음 질문을 제시했다.

- 결과를 거리순으로 짧게 정리했다.

## Failure modes

- 위치 문자열이 공식 zone 과 잘 매칭되지 않을 수 있다.

- 같은 키워드가 여러 상권에 걸치면 추가 확인이 필요하다.

- Blue Ribbon 사이트가 구조/파라미터를 바꾸면 zone 파싱 또는 nearby endpoint 가 깨질 수 있다.

- 프록시의 `BLUE_RIBBON_SESSION_ID` 가 만료(30일)되면 갱신이 필요하다.

## Notes

- 이 스킬은 조회형 스킬이다.

- 유저 위치는 자동 추적하지 않고, 대화 중 받은 값만 사용한다.

- 맛집 문의는 기본적으로 이 스킬을 먼저 쓰되, 블루리본 외 다른 기준이 명시되면 그 기준을 우선한다.

Weekly Installs773Repository[nomadamas/k-skill](https://github.com/nomadamas/k-skill)GitHub Stars3.0KFirst SeenMar 28, 2026Security Audits[Gen Agent Trust HubPass](/nomadamas/k-skill/blue-ribbon-nearby/security/agent-trust-hub)[SocketPass](/nomadamas/k-skill/blue-ribbon-nearby/security/socket)[SnykPass](/nomadamas/k-skill/blue-ribbon-nearby/security/snyk)Installed onantigravity769codex769opencode767github-copilot767amp767cline767

---
*Source: https://skills.yangsir.net/skill/daily-blue-ribbon-nearby*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-blue-ribbon-nearby/markdown*