말 한마디로 카카오지도 연결 — Flutter 카카오맵 스킬
“카카오지도 연결해줘” 한마디로 내 Flutter 앱에 카카오지도를 붙이고, 마커·말풍선·검색까지 대화로 추가합니다.
KKENSU_LAB
무료
스킬 소개
말 한마디로
카카오지도를 내 Flutter 앱에
Claude Code · Codex 에게 이렇게 말하면, 지금 작업 중인 프로젝트 코드에 바로 붙습니다. 데모 앱을 따로 만들지 않습니다.
“카카오지도 연결해줘”“마커 추가하고 누르면 위에 말풍선 나오게 해줘”
빈 Flutter 앱에 요청 13개를 차례로 보낸 뒤의 같은 앱입니다. 검색창·파란 핀·연결선·중심 주소가 모두 대화로 추가됐습니다.
이런 걸 해 줍니다
kakao_map_plugin 을 만든 사람이, 실제 이슈 41건과 실기기 측정으로 정리한 규칙을 에이전트에게 줍니다.
flutter analyze 후 시뮬레이터·에뮬레이터에서 실행해 타일 로드를 확인합니다. 확인 못 한 건 “된다”고 말하지 않습니다.dart_defines.json 에 두고 .gitignore 에 넣습니다. 이미 git 에 올라간 키 파일은 멈추고 알려줍니다.“마커 누르면 위에 말풍선”
가장 많이 막히는 지점입니다. 말풍선 내용만 넣고 onMarkerTap 을 빼면 탭 자체가 등록되지 않아 아무 반응이 없습니다.
- 마커와 말풍선, 그리고 필수 짝인
onMarkerTap을 함께 넣습니다. - 콜백은 지도가 만들어질 때 고정되므로 처음부터 넘기고, 핫 리스타트로 확인합니다.
- 이어서 “아래에 상세 시트”라고 하면 지도를 살짝 올리고 시트를 띄웁니다.
- 화면은 Android 에뮬레이터에서 서울시청 핀을 실제로 탭한 결과입니다.
스킬 없이 vs 스킬로
같은 요청 “카카오지도 연결해줘 → 마커 누르면 말풍선”을 빈 앱 두 개에 보냈습니다.
- 지도와 마커 코드는 동작
- 앱 키를 main.dart 상수에 하드코딩
- 모바일 baseUrl 누락 → 장소 검색을 붙이면
Bad state: null - 빌드만 하고 화면은 확인하지 않음
- 지도와 마커 코드는 동작
- 키는 dart_defines.json + .gitignore
- baseUrl
http://localhost+ 콘솔 등록 안내 - 시뮬레이터에서 타일 로드와 탭까지 확인
실제로 돌려 본 결과
빈 Flutter 앱 하나에 아래 요청을 순서대로 보냈습니다. 13개 모두 flutter analyze 오류 0건입니다. 7번부터는 더 가벼운 Sonnet 모델로 실행했습니다.
| 요청 | 스킬이 한 일 | 확인 |
|---|---|---|
| 1. 카카오지도 연결해줘 | 연결 · 키 주입 · 플랫폼 설정 | iOS 에서 타일 로드 확인 |
| 2. 마커 추가하고 누르면 위에 말풍선 | 마커 + 말풍선 + onMarkerTap 필수 짝 | iOS 탭 → 말풍선 |
| 3. 마커 누르면 아래에 상세정보 시트 | 시트 + 마커 위로 이동 | iOS 탭 → 시트 |
| 4. 핀을 파란색 핀으로 | MarkerIcon.pin | iOS |
| 5. 마커 전부 한 화면에 | fitBounds | iOS |
| 6. 지도 위에 내 위치 버튼 | geolocator + 권한 설정 | analyze 0 |
| 7. 상단 장소 검색창 + 결과 마커 | keywordSearch · x=경도 · try/catch | Android 에서 실제 “카페” 검색 |
| 8. 지도 가운데 주소 하단 표시 | coord2Address | iOS “서울 중구 정동 5-5” |
| 9. 마커 많으면 묶어서 | Clusterer + 탭 목록 | analyze 0 |
| 10. 마커 순서대로 선 | Polyline | Android |
| 11. 지도 회전 버튼 (지원 안 됨) | 만들지 않고 이유와 대안 안내 | 코드 변경 없음 |
| 12. 다크 모드 지도 (지원 안 됨) | 만들지 않고 이유와 대안 안내 | 코드 변경 없음 |
| 13. 마커 눌러도 말풍선이 안 떠요 | 원인 1개 찾아 3줄 수정 | iOS 수정 전·후 비교 |
설치
압축을 풀어 스킬 폴더를 넣으면 끝입니다. 필요한 것: Flutter SDK, Python 3.10+, 카카오 개발자 콘솔 JavaScript 키.
# 프로젝트 단위 (권장) mkdir -p 내프로젝트/.claude/skills cp -R flutter-kakao-map 내프로젝트/.claude/skills/ # 모든 프로젝트에서 cp -R flutter-kakao-map ~/.claude/skills/ # Codex cp -R flutter-kakao-map 내프로젝트/.agents/skills/
알아둘 점
- 대상은 kakao_map_plugin 1.0.0 의 Android · iOS · Web 입니다. macOS · Windows · Linux 는 포함하지 않습니다.
- 카카오 개발자 콘솔 등록은 자동화하지 않습니다. 스킬이 프로젝트에 맞는 체크리스트를 보여줍니다.
- Web 은 사이트 도메인을 포트까지 등록해야 지도가 뜹니다. 예:
http://localhost:8080 - JavaScript 키는 앱 번들에 들어가므로 완전히 숨길 수 없습니다. 보호 수단은 콘솔의 도메인 제한입니다.
- 카카오 네이티브 SDK 기반의 다른 패키지는 다루지 않습니다.
자주 묻는 질문
이미 google_maps_flutter 를 쓰는 프로젝트인데요?“카카오”를 말하지 않고 “마커 추가해줘”라고 하면, 어느 지도에 할지 한 번만 묻습니다. 기존 지도 코드는 건드리지 않습니다.
flutter_dotenv 를 이미 쓰고 있어요.새 방식을 섞지 않고 기존 .env 에 키를 추가하는 방식으로 따라갑니다.
0.x 버전을 쓰고 있어요.진단에서 버전을 확인하고, 1.0.0 에서 동작이 바뀐 부분(빈 마커 목록 처리, 클러스터러 분리 등)을 먼저 점검합니다.
무료인가요?네. MIT 라이선스입니다. 버그와 제안은 플러그인 저장소 이슈로 남겨 주세요.
구매 후 첫 결과물까지
가이드에서 준비물을 확인하고, 내 자료로 첫 작업을 시작해 보세요.
구매한 스킬의 사용 가이드 열기
결제 완료 화면이나 내 라이브러리에서 사용 가이드를 열어 주세요. 필요한 계정과 준비할 자료부터 확인해요.
스킬을 받아 가이드대로 설정하기
스킬 ZIP 파일을 내려받고 사용 가이드에 따라 에이전트에 등록해 주세요. 추가 도구가 필요하면 가이드의 설정 순서를 따라가요.
내 자료로 작은 작업 하나 해보기
처음에는 주제나 자료 하나로 시작해요. 원하는 결과의 형태를 구체적으로 정하고, 완성된 결과가 내 업무에 맞는지 확인해 주세요.
막힌 부분은 스킬룸에서 질문하기
하려던 작업과 멈춘 단계, 오류 메시지를 구매자 커뮤니티에 남겨 주세요. 다음 작업을 할 때도 내 라이브러리에서 가이드로 돌아올 수 있어요.
첫 요청 예시
“말 한마디로 카카오지도 연결 — Flutter 카카오맵 스킬 스킬로 첫 작업을 해보고 싶어. 필요한 자료와 설정을 먼저 알려주고, 작은 작업 하나부터 도와줘.”
커뮤니티
구매자 전용 커뮤니티
질문하면 판매자가 답하고, 업데이트가 먼저 오고, 다른 구매자들의 결과가 쌓이는 곳이에요.
- 판매자에게 직접 질문하고 피드백 받기
- 스킬 업데이트 소식 받기
- 버그 신고 · 미래 기능 요청
- 다른 구매자들의 활용 사례 보기
구매 안내
구매 전 준비 사항과 지원 기준을 한곳에서 확인해 주세요.
구매 전에 확인해 주세요
- 받는 자료
스킬 ZIP 파일
구매한 자료는 내 라이브러리에서 열 수 있어요.
- 사용 환경
스킬을 실행할 AI 에이전트와 계정이 필요해요.
지원하는 에이전트와 준비할 서비스는 상품 설명에서 확인해 주세요.
- 추가 이용료
외부 AI 서비스는 별도 구독료나 사용료가 필요할 수 있어요.
필요한 요금제와 예상 사용량이 궁금하면 구매 전에 판매자에게 물어보세요.
보증 · 지원 정책
어떤 환경에서 검증했고, 언제까지 고쳐 주는지 먼저 밝힙니다.
- 동작 보증 대상
- Claude Code · Codex 기준으로 검증했습니다. 그 밖의 에이전트·CLI 에서는 동작을 보증하지 않습니다.
- 무상 패치 기간
- 업로드일(2026년 9월 14일)로부터 1년 — 2027년 9월 14일까지. 이 기간에 모델·CLI 변경으로 스킬이 동작하지 않으면 무상으로 고쳐 드립니다.
- 서비스 제공 기간
- 결제 즉시 다운로드로 제공되며, 결제일로부터 11개월간 [내 라이브러리]에서 다시 내려받고 열람하실 수 있습니다. 이 기간이 지나면 다운로드·열람 제공이 종료됩니다.
- 기간 내 미수정 시
- 무상 패치 기간 안에 고치지 못하면 남은 기간에 비례해 환불합니다.
- 마지막 동작 검증
- 2026년 9월 17일(스킬 최종 수정일)
