with one click
kakao-map
// Kakao Local (장소 검색·주소-좌표 변환) + Kakao Mobility (자동차 길찾기) 를 k-skill-proxy 경유로 조회한다. 사용자 키 불필요.
// Kakao Local (장소 검색·주소-좌표 변환) + Kakao Mobility (자동차 길찾기) 를 k-skill-proxy 경유로 조회한다. 사용자 키 불필요.
네이버 지도(NAVER Cloud Platform Maps) 기반 출발지→목적지 자동차 길찾기·지오코딩·역지오코딩을 k-skill-proxy 경유로 조회한다. 수동 입력 MVP, mock 기본, live opt-in.
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.
서울 따릉이 실시간 대여소의 대여 가능 자전거와 빈 거치대를 좌표 주변 또는 대여소 이름으로 조회한다.
Look up Daiso products by store name and product keyword using official Daiso Mall store/search/stock surfaces. Use when the user wants to know whether a product is available at a specific Daiso store.
다나와 공개 검색/가격비교 표면으로 상품 후보를 찾고, 쇼핑몰별 최저가·배송비 포함 실구매가·카드 할인가·무이자 할부 정보를 보수적으로 비교한다.
| 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 계열을 명시적으로 노출한다.