Menu
Kakao Local (장소 검색·주소-좌표 변환) + Kakao Mobility (자동차 길찾기) 를 k-skill-proxy 경유로 조회한다. 사용자 키 불필요.
| name | kakao-map |
| description | Kakao Local (장소 검색·주소-좌표 변환) + Kakao Mobility (자동차 길찾기) 를 k-skill-proxy 경유로 조회한다. 사용자 키 불필요. |
| license | MIT |
| metadata | {"category":"transit","locale":"ko-KR","phase":"v1"} |
Kakao Developers의 두 API를 k-skill-proxy 경유로 묶어 다음 두 종류 질문에 답한다:
KAKAO_REST_API_KEY 를 proxy 서버에만 보관한다. 사용자는 키 발급 필요 없음.korean-transit-route(ODsay) 사용KSKILL_PROXY_BASE_URL (self-host·별도 프록시 사용 시. 비우면 hosted https://k-skill-proxy.nomadamas.org 기본).사용자 머신에는 필요 없다. 운영자 proxy 서버에 다음을 둔다:
KAKAO_REST_API_KEY — Kakao Developers REST API 키 (Local + Mobility 공용)키가 없으면 모든 /v1/kakao-map/* 및 /v1/kakao-mobility/* 라우트가 503 upstream_not_configured 를 돌려준다.
| endpoint | 용도 | 주요 입력 |
|---|---|---|
GET /v1/kakao-map/search/keyword | 키워드 장소 검색 | q, optional x,y(중심좌표), radius(0category_group_code, sort(accuracy|distance), page(1size(1~15) |
GET /v1/kakao-map/search/category | 카테고리 장소 검색 (좌표 중심 필수) | category_group_code(예: FD6 음식점, CE7 카페), x, y, radius(기본 500), sort, page, size |
GET /v1/kakao-map/coord2address | 좌표 → 도로명/지번 주소 | x, y, optional input_coord(WGS84 기본) |
GET /v1/kakao-map/coord2region | 좌표 → 행정구역(시/도/시군구/동) | x, y, optional input_coord |
GET /v1/kakao-mobility/directions | 자동차 길찾기 | origin=x,y, destination=x,y, optional waypoints(최대 5, | 구분), priority(RECOMMEND|TIME|DISTANCE), car_fuel(GASOLINE|DIESEL|LPG), car_hipass(true|false), alternatives(true|false), avoid(ferries|toll|motorway|schoolzone|uturn; | 구분) |
Kakao 카테고리 그룹 코드 (자주 쓰는 것):
| 코드 | 의미 |
|---|---|
| MT1 | 대형마트 |
| CS2 | 편의점 |
| PK6 | 주차장 |
| OL7 | 주유소/충전소 |
| SW8 | 지하철역 |
| BK9 | 은행 |
| CT1 | 문화시설 |
| AT4 | 관광명소 |
| AD5 | 숙박 |
| FD6 | 음식점 |
| CE7 | 카페 |
| HP8 | 병원 |
| PM9 | 약국 |
BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
curl -fsS --get "${BASE}/v1/kakao-map/search/keyword" \
--data-urlencode 'q=스타벅스' \
--data-urlencode 'x=127.0276' \
--data-urlencode 'y=37.4979' \
--data-urlencode 'radius=500' \
--data-urlencode 'sort=distance'
응답의 documents[] 에서 place_name, road_address_name, phone, place_url, distance 를 추출해 사용자에게 보여준다.
curl -fsS --get "${BASE}/v1/kakao-map/search/category" \
--data-urlencode 'category_group_code=FD6' \
--data-urlencode 'x=127.0276' \
--data-urlencode 'y=37.4979' \
--data-urlencode 'radius=300'
curl -fsS --get "${BASE}/v1/kakao-map/coord2address" \
--data-urlencode 'x=127.0276' \
--data-urlencode 'y=37.4979'
documents[0].road_address.address_name, documents[0].address.address_name 사용.
curl -fsS --get "${BASE}/v1/kakao-map/coord2region" \
--data-urlencode 'x=127.0276' \
--data-urlencode 'y=37.4979'
응답에 region_type(B=법정동, H=행정동) 별 결과가 들어있다.
curl -fsS --get "${BASE}/v1/kakao-mobility/directions" \
--data-urlencode 'origin=126.9706,37.5559' \
--data-urlencode 'destination=127.0276,37.4979' \
--data-urlencode 'priority=RECOMMEND' \
--data-urlencode 'avoid=toll'
응답에서 routes[0].summary 를 읽는다:
distance (meter) → km 환산duration (second) → 분 환산fare.taxi, fare.toll → 원priority (요청한 값 echo)avoid 요청 시 toll 등 회피 옵션 적용장소 검색:
강남역 근처 스타벅스 5곳 (반경 500m, 가까운 순)
1) 스타벅스 강남R점 — 강남구 테헤란로 ... (120m, 02-...)
2) ...
자동차 길찾기:
자동차 경로: (126.9706,37.5559) → (127.0276,37.4979)
- 거리: 12.3km / 예상 소요시간: 25분
- 통행료: 1,200원 / 예상 택시요금: 18,500원
- 옵션: RECOMMEND, avoid=toll
- 조회 시각: 2026-05-23T14:00:00.000Z
KAKAO_REST_API_KEY 미설정 → 503 upstream_not_configured503 으로 변환 (key revoke / 쿼터 초과 신호)400 bad_requestresult_code=104 등) → 502 upstream_semantic_error + result_msg502 또는 503 (proxy cache 가 있는 만큼 호출 빈도를 줄임)502 upstream_errorkorean-transit-route 등 대체 안내.korean-transit-route 스킬을 쓴다./v1/kakao-local/geocode (기존)도 같은 키를 쓰며 여전히 사용 가능하다 (address → keyword 자동 fallback). 본 스킬은 그 위에 keyword/category/coord 계열을 명시적으로 노출한다.Use when the user asks for nearby restaurants or 근처 맛집 and wants 블루리본 picks. Always ask the user's current location first, then search official Blue Ribbon nearby restaurants via k-skill-proxy.
네이버 지도(NAVER Cloud Platform Maps) 기반 출발지→목적지 자동차 길찾기·지오코딩·역지오코딩을 k-skill-proxy 경유로 조회한다. 수동 입력 MVP, mock 기본, live opt-in.
Look up available Korean national forest recreation lodging or camping slots on foresttrip.go.kr. Use when the user asks for 숲나들e or 자연휴양림 빈 객실/빈자리 조회, not for booking.
Search, reserve, inspect, and cancel KTX or Korail tickets in Korea with the korail2 + pycryptodome Python packages. Use when the user asks for KTX seats, Korail bookings, train changes, reservation status, remaining seat numbers, car-by-car seats, or power-outlet/good-seat tips.
Convert incoming Korean text into a deterministic Korean Middle Korean-style rewrite with archaic particles, endings, Hanja hints, and tone-mark flavor.
After installing the full k-skill bundle, configure and verify the shared cross-platform setup, then optionally wire update checks and GitHub starring with explicit user consent.