VIBE CODING STUDY / 4단계

제작과 배포

데이터 구조와 API 연동

🔰 전문 용어가 어렵다면, 쉬운 설명 버전으로 보기

3단계에서 뭘 남길지 정했다면, 이번엔 그 화면을 실제로 움직이는 데이터를 어떻게 구성할지 정할 차례입니다. 지도 API를 어디서 붙이고, 데이터를 누가 채우게 할지, 그 데이터를 자동화하는 데 돈을 쓸 가치가 있는지를 순서대로 다룹니다.

지도 넣기: 카카오 디벨로퍼스

지도 기반 초니치 서비스라면 대부분 카카오 디벨로퍼스(Kakao Developers)API를 씁니다. 무료 사용량 한도 안에서 시작해서, 트래픽이 실제로 늘어나면 그때 유료 전환 여부를 판단하는 순서가 안전합니다. Claude Code에게 요청할 때도 "카카오맵 API로 지도를 띄우고 마커 N개를 표시해줘"처럼, 어떤 데이터를 어떤 형태로 보여줄지 구체적으로 풀어서 요청하면 훨씬 빠르게 원하는 결과에 가까워집니다.

데이터 구조: 정적 vs 사용자 입력

수동 업데이트 (정적 데이터)

운영자가 직접 확인하고 손으로 반영하는 구조입니다. 늑구맵은 뉴스 기반이라 이 구조를 씁니다. 언론 보도가 나올 때마다 운영자가 직접 확인해서 데이터를 갱신해야 하니, 운영자 한 명의 시간이 계속 들어갑니다.

사용자 입력 구조

거지맵처럼 사용자가 직접 정보를 입력하는 구조입니다. 사용자가 사용자를 불러오기 때문에 운영자 개입 없이도 콘텐츠가 계속 쌓입니다. 가능하다면 이 구조가 장기적으로 더 좋습니다.

어느 쪽이든 처음엔 가게 목록이나 문항 같은 데이터를 화면 코드에 직접 박아넣지 말고, 별도 JSON 파일로 분리해두는 게 좋습니다. 나중에 내용만 바꿔서 업데이트하기가 훨씬 쉬워지고, 수동 구조에서 사용자 입력 구조로 넘어갈 때도 데이터와 화면이 분리돼 있어야 손대기 쉽습니다.

API로 자동화할까: ROI부터 계산

뉴스/공공 발표를 API로 자동 수집해서 수동 업데이트 부담을 줄이는 방법도 있습니다. 다만 그 API가 무료인지 유료인지, 유료라면 투자할 가치가 있는지를 먼저 계산해야 합니다. 트래픽이 이슈성으로 며칠 반짝했다가 끝날 가능성이 있다면, 유료 API에 들어가는 고정비가 실제 수익/가치보다 커질 수 있습니다.

실제 사례: 호르무즈 해협 혼잡도 지도 (미시도)

호르무즈 해협 사태 때, 투자자들의 니즈를 채우기 위해 '호르무즈 해협 혼잡도 지도'를 만들어볼까 검토했지만, 필요한 API 비용이 투자할 수 있는 범위를 벗어난다고 판단해 시도하지 않았습니다. ROI를 계산했을 때 확신이 서지 않았기 때문입니다. 공교롭게도 비슷한 시기에 이 아이디어를 실제로 구현한 해외 서비스가 있었는데, 초니치맵의 최고봉이라고 생각하는 사례라 별도 케이스스터디로 소개합니다.

실시간 인터랙션이 필요하다면

투표나 실시간 집계처럼 가벼운 인터랙션이 필요하다면, 꼭 별도 서버/DB를 구축하지 않아도 됩니다. 늑구맵의 굿즈 투표 기능은 Google Apps Script를 스프레드시트와 연동해서 실시간 투표 집계를 구현했습니다. 정식 백엔드를 세우기 전에, 이런 가벼운 도구로 먼저 검증해보는 편이 빠릅니다.

데이터/API 체크리스트

늑구맵의 생각

완벽한 자동화보다 '오늘 당장 돌아가는 구조'가 우선입니다. 늑구맵도 수동 업데이트라는 번거로운 구조를 지금까지 유지하고 있지만, 그게 니즈를 해결하는 데는 문제가 없었습니다. 데이터와 API가 준비됐다면, 다음 단계는 이걸 실제로 사람들에게 알리는 과정입니다.

업데이트 로그

  • 2026.08.23 바이브 코딩 스터디 4단계로 최초 게시했습니다.

더 자세한 확인 기준은 편집 원칙, 오류 제보는 문의 및 제보 페이지를 참고해 주세요.