cheap-gas-nearbylisted

# Cheap Gas Nearby ## What this skill does 유저가 알려준 현재 위치를 기준으로 **근처에서 가장 싼 주유소**를 찾아준다. - 위치는 자동으로 추정하지 않는다. - **반드시 먼저 현재 위치를 질문**한다. - 가격 데이터는 한국석유공사 **Opinet 공식 API**를 우선 사용한다. - 동네/역명/랜드마크 입력은 Kakao Map anchor 검색으로 좌표를 잡은 뒤 Opinet nearby 검색으로 연결한다. - 기본 제품은 **휘발유(B027)** 이고, 유저가 경유라고 명시하면 **경유(D047)** 로 바꾼다. ## When to use - "근처 가장 싼 주유소 찾아줘" - "서울역 근처 휘발유 제일 싼 데 어디야?" - "강남에서 경유 싼 주유소 몇 군데만 보여줘" - "지금 여기 근처 셀프주유소 중 싼 순으로 알려줘" ## Mandatory first question 위치 정보 없이 바로 검색하지 말고 반드시 먼저 물어본다. - 권장 질문: `현재 위치를 알려주세요. 동네/역명/랜드마크/위도·경도 중 편한 형식으로 보내주시면 근처에서 가장 싼 주유소를 찾아볼게요.` - 제품이 불명확하면: `휘발유 기준으로 볼까요, 경유 기준으로 볼까요? 따로 말씀 없으면 휘발유로 찾을게요.` - 위치가 애매하면: `가까운 역명이나 동 이름으로 한 번만 더 알려주세요.` ## Default path 기본적으로 `https://k-skill-proxy.nomadamas.org/v1/opinet/around` 와 `/v1/opinet/detail` 을 경유해 조회한다. 사용자 쪽에서 별도 `OPINET_API_KEY` 를 준비할 필요가 없다. ## Official Opinet surfaces - 오픈 API 안내: `https://www.opinet.co.kr/user/custapi/openApiInfo.do` - 반경 내 주유소: `https://www.opinet.co.kr/api/aroundAll.do` - 주유소 상세정보(ID): `https://www.opinet.co.kr/api/detailById.do` - 지역코드: `https://www.opinet.co.kr/api/areaCode.do` 반경 검색 핵심 파라미터: - `x`, `y`: 기준 위치 **KATEC** 좌표 - `radius`: 반경(m, 최대 5000) - `prodcd`: `B027`(휘발유), `D047`(경유), `B034`(고급휘발유), `C004`(등유), `K015`(LPG) - `sort=1`: 가격순 ## Location resolution surface - Kakao Map 모바일 검색: `https://m.map.kakao.com/actions/searchView?q=<query>` - Kakao Map 장소 패널 JSON: `https://place-api.map.kakao.com/places/panel3/<confirmId>` 위치 문자열은 Kakao Map으로 **anchor