본문으로 건너뛰기

[23기 런칭스프린트 3주차 후기] 농사다마, 클코루프로 카카오지도api·도메인·SEO·GEO까지 연결하기

[23기 런칭스프린트 3주차 후기] 농사다마, 클코루프로 카카오지도api·도메인·SEO·GEO까지 연결하기 본문 이미지

소개

지난 스터디에서는 농촌 외국인 근로자를 위한 지역 생활정보 및 이웃 매칭 웹앱 ‘농사다마’​의 PRD를 작성하고, 이를 바탕으로 웹앱의 기본 화면을 구현했다.

이번 3주차에는 단순한 데모 페이지에서 한 단계 더 나아가 실제 서비스처럼 사용할 수 있는 형태로 발전시키고자 했다. 이를 위해 다음 작업을 목표로 설정했다.

  • 카카오맵 API를 활용한 지도 기능 추가

  • 게시판 중심이었던 서비스 구조를 지역 기반 이웃 매칭 중심으로 개편

  • 공식 도메인 nongsadama.app 구입 및 연결

  • 카카오톡·SNS 공유 기능 추가

  • 농사다마 전용 파비콘 적용

  • Google 및 네이버 검색 노출을 위한 SEO 설정

  • ChatGPT와 Claude 등 생성형 AI 검색 환경을 고려한 GEO 설정

특히 농사다마는 사용자가 자신의 주변에 있는 같은 언어권 이웃과 생활정보를 찾는 서비스이기 때문에, 지도는 단순히 추가하면 좋은 기능이 아니라 서비스의 핵심 경험을 보여주는 기능이라고 판단했다.

또한 GitHub Pages의 개발용 주소만 사용하는 것보다 기억하기 쉬운 공식 도메인을 연결하고, 검색엔진과 AI 검색 서비스가 농사다마를 정확하게 이해할 수 있도록 기본적인 검색 최적화 작업도 함께 진행하고자 했다.


진행 방법

이번 작업은 대부분 Claude Code를 활용해 진행했다.

지난 스터디에서 무재님이 알려주신 Claude Code 루프 활용 방법을 참고해, 반복적인 확인과 수정이 필요한 작업을 밤에 실행해두는 방식으로 활용했다.

기존에는 Claude Code가 파일을 수정하거나 명령어를 실행할 때마다 중간 과정을 직접 확인해야 했지만, 작업 목표와 검증 조건을 구체적으로 전달하고 루프 형태로 실행하니 다음과 같은 작업을 연속적으로 처리하는 데 큰 도움이 되었다.

  • 프로젝트 구조 확인

  • 관련 파일 수정

  • 빌드 오류 점검

  • Git 커밋 및 배포

  • 실제 서비스 주소 접속 확인

  • 문제가 있을 경우 재수정

특히 카카오맵 API 연동이나 전체 화면의 뼈대를 변경하는 작업은 여러 파일을 함께 수정해야 했기 때문에, 루프를 활용한 밤샘 작업 방식이 효과적이었다.

결과와 배운 점

1️⃣ 카카오맵 API 연동 및 서비스 구조 개편

기존 농사다마는 게시판과 생활정보 메뉴를 중심으로 구성되어 있었다.

하지만 외국인 계절근로자가 처음 서비스를 이용할 때 직접 게시글을 작성해야만 다른 사람과 연결될 수 있는 구조는 진입장벽이 높을 수 있다고 판단했다.

따라서 사용자가 자신의 국적과 언어를 선택하면 같은 지역에서 같은 언어를 사용하는 이웃을 지도에서 확인할 수 있도록 서비스의 중심 구조를 변경했다.

Claude Code에는 전체 프로젝트 구조와 기존 기능을 먼저 분석하게 한 뒤, 지도 중심의 홈 화면과 이웃 매칭 흐름으로 개편하도록 요청했다.

사용한 대표 프롬프트는 다음과 같다.

현재 농사다마 웹앱의 전체 프로젝트 구조와 주요 화면을 먼저 분석해줘.

농사다마는 농촌 외국인 근로자를 위한 지역 기반 생활정보 및
1:1 이웃 매칭 서비스야.

현재 게시판 중심으로 구성된 화면을 다음 사용자 흐름에 맞게 개편해줘.

1. 사용자가 국적과 언어를 선택한다.
2. 현재 지역 또는 선택한 지역을 기준으로 주변 이웃을 확인한다.
3. 같은 언어를 사용하는 이웃을 카카오맵 위에서 확인한다.
4. 이웃 프로필을 선택하면 1:1 대화 또는 연결 화면으로 이동한다.
5. 병원, 마트, 행정기관 등의 지역 생활정보도 지도에서 확인할 수 있게 한다.

기존 디자인과 기능을 최대한 유지하되,
지도와 이웃 매칭이 서비스의 핵심 기능으로 보이도록
홈 화면과 메뉴 구조를 수정해줘.

작업 후에는 빌드 오류를 확인하고,
오류가 있으면 원인을 수정한 뒤 다시 빌드해줘.

카카오맵 JavaScript API를 적용하는 과정에서는 API 키뿐 아니라 실제 서비스 도메인을 카카오 개발자 콘솔에 등록해야 지도가 정상적으로 표시된다는 점도 알게 되었다.

개발 주소와 공식 도메인을 함께 사용하고 있었기 때문에, 허용 도메인이 누락되지 않았는지 확인하는 과정이 필요했다.

한국의 사업장 위치를 ​​보여주는 지도

2️⃣ 공식 도메인 연결

기존에는 GitHub Pages와 Cloudflare Workers의 개발 주소를 사용했다. 그러나 외부 인터뷰나 서비스 소개 과정에서 주소가 길고 기억하기 어렵다는 문제가 있었다.

이에 농사다마 서비스명과 일치하는 도메인을 구입해 공식 주소로 연결했다.

도메인을 연결한 뒤에는 단순히 접속 여부만 확인하지 않고 다음 항목도 함께 수정했다.

  • canonical 주소

  • Open Graph 공유 주소

  • 사이트맵 내부 URL

  • robots.txt의 사이트맵 주소

  • 구조화 데이터의 서비스 URL

  • 카카오맵 API 허용 도메인

  • SNS 공유 버튼의 기본 주소

처음에는 SEO 설정이 기존 Cloudflare Workers 주소를 공식 주소로 가리키고 있었다. 이 상태로 두면 검색엔진이 nongsadama.app이 아닌 개발 주소를 원본 페이지로 판단할 수 있었다.

Claude Code를 통해 기존 주소가 남아 있는 파일을 전체 검색한 후, 공식 도메인을 기준으로 일괄 수정했다.

농사다마의 공식 도메인을 https://nongsadama.app으로 사용하려고 해.

프로젝트 전체에서 기존 GitHub Pages 주소와
Cloudflare Workers 주소가 사용된 부분을 찾아줘.

다음 항목은 모두 공식 도메인을 기준으로 수정해줘.

- canonical URL
- og:url
- og:image
- Twitter 카드 URL
- JSON-LD 구조화 데이터 URL
- robots.txt의 sitemap 주소
- sitemap.xml 내부 URL
- SNS 공유 버튼의 공유 URL

기존 배포 주소는 접속 가능하도록 유지하되,
검색엔진이 nongsadama.app을 공식 주소로 인식하도록 설정해줘.

작업 후 실제 배포 주소에서 각 항목이 정상적으로 제공되는지도 확인해줘.

그 결과 현재 농사다마는 다음 공식 도메인으로 접속할 수 있다.

https://nongsadama.app

한국 음식 배달 앱의 스크린샷

3️⃣ SNS 공유 기능과 파비콘 추가

서비스를 인터뷰 대상자나 스터디원에게 전달할 때 주소를 복사해 보내는 것보다, 화면에서 바로 공유할 수 있는 기능이 필요하다고 생각했다.

이에 모바일 환경에서 활용할 수 있는 공유 기능과 URL 복사 기능을 추가했다.

지원 가능한 환경에서는 브라우저의 기본 공유 기능을 이용하고, 지원하지 않는 환경에서는 링크를 클립보드에 복사하도록 구성했다. Open Graph 정보도 함께 설정하여 카카오톡이나 메신저로 공유했을 때 농사다마의 제목, 설명, 대표 이미지가 표시될 수 있도록 했다.

또한 브라우저 탭에서 기본 아이콘이 표시되던 문제를 해결하기 위해 농사다마 로고를 활용한 파비콘도 제작해 적용했다.

농사다마 웹앱에 SNS 공유 기능을 추가해줘.

모바일 브라우저에서 Web Share API를 지원하면
기본 공유창이 열리도록 하고,
지원하지 않으면 공식 주소를 클립보드에 복사해줘.

공유되는 정보는 다음과 같이 설정해줘.

제목: 농사다마
설명: 농촌 외국인 근로자를 위한 지역 생활정보 및 이웃 매칭 서비스
URL: https://nongsadama.app

카카오톡이나 메신저에서 공유 미리보기가 잘 표시되도록
Open Graph와 Twitter Card 설정도 확인해줘.

추가로 농사다마 로고를 활용한 파비콘을 적용하고,
PC와 모바일 브라우저에서 정상적으로 표시되는지 확인해줘.


4️⃣ SEO 적용

공식 도메인을 연결한 뒤에는 검색엔진이 농사다마의 내용을 이해할 수 있도록 기본적인 SEO 작업을 진행했다.

Claude Code에 Google과 네이버의 검색 최적화 항목을 확인하게 하고, 현재 프로젝트에 적용 가능한 부분을 반영하도록 요청했다.

적용한 주요 항목은 다음과 같다.

  • 서비스 내용을 설명하는 <title>

  • 한국어와 영어를 포함한 meta description

  • Open Graph 및 Twitter Card

  • 공식 도메인을 가리키는 canonical

  • robots.txt

  • sitemap.xml

  • WebApplication JSON-LD 구조화 데이터

  • 공유용 대표 이미지

농사다마 웹앱의 검색 노출을 개선하기 위해
Google과 네이버 기준의 기본 SEO를 적용해줘.

서비스 정보는 다음과 같아.

서비스명: 농사다마
공식 주소: https://nongsadama.app
서비스 설명: 농촌 외국인 근로자를 위한 지역 생활정보 및 이웃 매칭 웹앱

다음 항목을 점검하고 부족한 부분을 구현해줘.

- title
- meta description
- canonical
- Open Graph
- Twitter Card
- robots.txt
- sitemap.xml
- JSON-LD 구조화 데이터
- 공유 대표 이미지

사이트맵에는 주요 서비스 경로를 포함하고,
모든 URL은 공식 도메인인 nongsadama.app을 사용해줘.

작업 후 각 파일과 메타태그가 실제 배포 환경에서
정상적으로 제공되는지도 확인해줘.

Google Search Console에도 공식 도메인을 등록하고 다음 사이트맵을 제출했다.

https://nongsadama.app/sitemap.xml

이를 통해 검색엔진에 농사다마의 주요 페이지 구조를 전달할 수 있게 되었다.


5️⃣ 생성형 AI 검색을 위한 GEO 적용

SEO 작업을 진행하면서 일반 검색엔진뿐 아니라 ChatGPT나 Claude와 같은 생성형 AI 서비스가 사이트의 내용을 어떻게 읽는지도 확인했다.

농사다마는 React 기반의 CSR 방식으로 구현되어 있어 브라우저에서는 화면이 정상적으로 표시되지만, JavaScript를 실행하지 않는 일부 AI 크롤러에는 본문 내용이 충분히 보이지 않을 수 있다는 문제를 발견했다.

이에 OpenAI와 Anthropic의 봇 관련 문서를 참고하여 GEO 전략을 수립했다.

실제로 사용한 프롬프트는 다음과 같다.

블로그/콘텐츠 미디어 분야 웹사이트를 AI의 생성 엔진에
최적화(GEO)하려고 해.

다음 링크를 참고해서 우리 사이트에 반영할 부분을
전략적으로 제시해줘.

추가로 문서에 없는 GEO 관련 팁이 있다면 전략에 포함해줘.

앤트로픽:
privacy.claude.com/en/articles/8896518

오픈AI:
developers.openai.com/api/docs/bots

분석 결과, AI 크롤러가 차단된 것은 아니었지만 CSR 구조로 인해 실제 본문을 충분히 읽지 못할 가능성이 있다는 점이 가장 큰 문제였다.

이를 보완하기 위해 다음 작업을 적용했다.

  • 검색 및 인용 목적의 AI 봇 접근 허용

  • GPTBot·ClaudeBot 등 학습 목적 봇의 /board 접근 제한

  • llms.txt 파일 추가

  • FAQPage JSON-LD 구조화 데이터 추가

  • 임금·비자·긴급상황 관련 공공기관 번호를 정적 텍스트로 제공

특히 게시판에는 외국인 근로자가 작성한 사용자 콘텐츠가 포함될 수 있기 때문에, AI 검색에서의 실시간 인용 가능성은 유지하되 모델 학습 데이터로 수집되는 것은 제한하는 방향을 선택했다.

GEO 전략 중 다음 3개 항목을 적용해줘.

1. robots.txt에 AI 검색 및 인용 봇은 명시적으로 허용한다.
2. GPTBot과 ClaudeBot 등 학습 목적 봇은 /board 접근을 차단한다.
3. llms.txt와 FAQPage JSON-LD를 추가한다.

llms.txt에는 다음 내용을 정적 텍스트로 정리해줘.

- 농사다마 서비스 정의
- 주요 기능
- 대상 사용자
- 병원·행정·임금·비자 관련 생활정보
- 주요 공공기관 연락처
- 개인정보 및 사용자 게시글 보호 원칙

적용 후 공식 도메인에서 robots.txt와 llms.txt가
정상적으로 제공되는지 확인해줘.

그 결과 공식 도메인에서 다음 파일들이 정상적으로 제공되는 것을 확인했다.

https://nongsadama.app/robots.txt
https://nongsadama.app/sitemap.xml
https://nongsadama.app/llms.txt

도움 받은 글

지난스터디때의 무재님의 클로드코드 루프작동법을 알려주어 큰 도움이 되었고 토요일 오프모임때 이미지캔바나 미리캔버스로 파비콘 적용할 원하는 이미지 생성이 시간이 잘 안되고 있을때 Diane님이 pinterest로 우선 예시이미지를 찾고 Lovart로 해당 이미지와 유사한 이미지를 생성하는 것을 추천해주셔서 도움을 받았다. 그리고 브랜든님께서 지난 오프모임때 스터디 분위기를 파이팅있게 만들어주셔서 어렵게 보이던 배포까지의 과정을 보다 쉽게 진행할 수 있었다.

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기