15. 세상에 내 웹사이트를 알리다: SEO 최적화와 구글 서치 콘솔, 그리고 최종 회고록

👤 관리자

조회 수 114

들어가며: 집은 다 지었는데, 왜 아무도 안 올까?

댓글 시스템에 스팸 도배 방지(Rate Limit)까지 적용하고 나니, 제 방구석 구형 노트북에서 돌아가고 있는 커뮤니티 웹사이트는 기술적으로 제법 완벽한 형태를 갖추게 되었습니다.

가족과 지인들에게 링크를 돌려 가입을 시키고 며칠을 흐뭇하게 지켜보았죠. 그런데 문득 뼈아픈 현실을 마주했습니다. 지인들을 제외하고는, 구글이나 네이버 검색을 통해 제 웹사이트에 자발적으로 들어오는 순수 방문자가 '단 한 명도' 없다는 사실이었습니다.

비유하자면 저는 산속 깊은 곳에 엄청나게 화려하고 예쁜 카페를 지어놓고, 산 밑에 표지판 하나 세워두지 않은 채 손님이 오기만을 기다리고 있었던 것입니다. 구글이라는 거대한 검색 엔진에게 "여기 내 웹사이트가 있으니 제발 와서 가져가 주세요!"라고 소리치고 지도를 쥐여주는 작업, 바로 **SEO(검색엔진 최적화)**와 서치 콘솔(Search Console) 등록이 절실한 시점이었습니다.

1. 로봇을 위한 친절한 안내서: 메타 태그와 robots.txt

가장 먼저 한 일은 구글의 검색 로봇(크롤러)이 제 사이트에 방문했을 때, 이 사이트가 뭐 하는 곳인지 쉽게 파악할 수 있도록 '명함'을 달아주는 작업이었습니다.

FastAPI 백엔드와 연결된 Jinja2의 <code>base.html</code> (모든 페이지의 뼈대가 되는 파일) 상단 <code><head></code> 구역을 열고, 그동안 신경 쓰지 않았던 **메타 태그(Meta Tag)**들을 정성스럽게 채워 넣었습니다. 사이트의 제목(<code><title></code>), 사이트가 다루는 핵심 주제와 설명(<code><meta name="description"></code>), 그리고 사람들이 카카오톡이나 SNS로 링크를 공유했을 때 예쁘게 뜨도록 돕는 오픈그래프(<code><meta property="og:..."></code>) 태그까지 빈틈없이 작성했죠.

그리고 프로젝트 최상단 폴더에 **<code>robots.txt</code>**라는 아주 작은 메모장 파일을 하나 만들었습니다. 여기에 <code>User-agent: *</code>, <code>Allow: /</code> 라고 단 두 줄을 적어 서버에 올렸습니다. 해석하자면 "세상의 모든 검색 로봇들아, 내 웹사이트의 모든 페이지를 마음껏 긁어가도 좋아!"라는 아주 친절한 환영 인사말입니다.

2. 내 웹사이트의 족보를 바치다: Sitemap.xml 생성

명함과 환영 인사를 준비했으니, 이제 로봇이 사이트 구석구석을 길 잃지 않고 돌아다닐 수 있도록 **'지도(Sitemap)'**를 만들어 줄 차례였습니다.

웹사이트에 메뉴가 하나둘 늘어나면서 자유게시판, 랭킹 보드 등 여러 페이지가 생겼기 때문에, 이 주소(URL)들을 한데 모아둔 XML 형식의 파일이 필요했습니다. 파이썬 FastAPI에서 동적으로 사이트맵을 생성해 주는 코드를 작성할까 고민도 했지만, 일단은 사이트 구조가 직관적이어서 기본 경로들을 담은 <code>sitemap.xml</code> 정적 파일을 직접 작성하여 서버의 <code>static</code> 폴더에 고이 모셔두었습니다.

"이 지도대로만 움직이면 내 커뮤니티의 모든 글을 볼 수 있어!"라는 마음으로 지도를 꾹꾹 눌러 쓴 셈입니다.

3. 구글 서치 콘솔 등록: "구글님, 제발 저 좀 봐주세요"

준비물은 모두 갖춰졌습니다. 드디어 전 세계 웹사이트들의 호적 등본(?)과도 같은 **'구글 서치 콘솔(Google Search Console)'**에 접속했습니다.

제 도메인인 <code>inspeep.com</code>을 입력하니, 구글은 "이 도메인이 진짜 네 것이 맞는지 증명해 봐"라며 복잡한 텍스트 코드를 하나 던져주었습니다. 당황하지 않고 도메인을 구매했던 네임칩(Namecheap)의 DNS 관리 페이지로 들어가, 구글이 준 코드를 TXT 레코드에 살포시 끼워 넣었습니다.

약 10분 뒤, 서치 콘솔 화면에서 **[소유권 확인 완료]**라는 초록색 마크가 떴을 때의 그 짜릿함이란! 곧바로 왼쪽 메뉴에서 'Sitemaps'를 클릭하고, 아까 만들어둔 <code>inspeep.com/sitemap.xml</code> 주소를 제출했습니다. 상태 창에 **'성공(Success)'**이라는 글자가 뜨는 순간, 드디어 제 웹사이트가 구글이라는 거대한 인터넷 세상의 정식 일원으로 인정받은 것 같아 가슴이 뭉클해졌습니다.

4. 최종 회고록: 40만 원의 예산, 그리고 진짜 개발자로의 성장

이 모든 세팅을 끝내고 나니, 문득 이 거대한 삽질의 첫 출발점이 떠올랐습니다.

평화롭게 로스트아크를 즐기며 차곡차곡 모았던 골드. 그 게임 재화를 현금화해서 얻었던 약 40만 원의 소박한 시드머니가 모든 일의 시작이었습니다. 처음엔 "AI가 다 짜주겠지"라는 안일한 생각으로 도메인과 EasyWP 호스팅을 무작정 결제했었죠.

하지만 현실은 냉혹했습니다. 워드프레스 테마(Astra)와의 끔찍한 코드 충돌, 호스팅 갱신일의 압박, 그리고 복사 붙여넣기만 반복하던 '바이브 코딩'의 참혹한 결말(사이트 접속 불가 사태)까지. 포기하고 싶은 순간이 수없이 많았습니다.

그러나 그 위기들은 결국 저를 낡은 구형 노트북을 꺼내 들게 만들었고, 리눅스(Ubuntu)의 까만 터미널 화면과 친해지게 만들었으며, 클라우드플레어 터널과 tmux를 다루게 해 주었습니다. FastAPI로 백엔드 뼈대를 세우고, Jinja2로 프론트엔드를 통제하며, OpenCV로 썸네일을 자동 추출하는 지금까지의 과정. 돌이켜보면 에러 메시지를 붙들고 제미나이, 클로드와 밤새 씨름하던 그 고통스러운 시간들이 저를 수동적인 '게임 유저'에서 무언가를 창조해 내는 '개발자'로 성장시켜 준 가장 값진 거름이 되었습니다.

마치며: 개발기는 끝났지만, 운영은 이제부터 시작입니다

장장 15편에 걸친 저의 [웹사이트 개발기] 연재는 여기서 마침표를 찍습니다.

아무것도 모르던 코딩 문외한이 나만의 인스타그램형 커뮤니티 웹사이트를 맨땅에 헤딩하며 구축해 낸 이 생생한 기록이, 저와 비슷한 꿈을 꾸는 많은 예비 독학 개발자분들에게 작은 용기와 이정표가 되기를 진심으로 바랍니다.

건물을 짓는 공사는 끝났지만, 이 공간에 어떤 유저들이 찾아오고 어떤 이야기들이 채워질지, 진짜 가슴 뛰는 **'운영'**은 바로 오늘부터 시작입니다. 그동안 길고 부족했던 저의 삽질기를 흥미롭게 읽어주신 모든 분들께 진심으로 감사드립니다. 앞으로 저의 웹사이트에서 만나요!

감사합니다!!!

모든편 다시보기 :

1. 아무것도 모르고 코딩 독학으로 시작하는 웹사이트 제작: 도메인과 호스팅의 늪

2. 코딩 문외한의 워드프레스 정복기: VS Code와 FTP의 습격

3. 접속 불가 사태 발생! 초보 개발자의 눈물겨운 서버 복구 성공기

4. Copilot과 함께하는 행복 개발, 그리고 찾아온 워드프레스의 한계

5. 프로젝트 초심 찾기: 매월 나가는 호스팅 비용, 과연 필수일까? (부제: 방구석 구형 노트북의 부활)

6. 프로그래밍 개발의 현실을 맛보다: 윈도우 토박이의 우분투(Ubuntu) 설치 고군분투기

7. 우분투(Ubuntu) 노트북 서버 구축과 완벽한 원격 개발 환경 만들기

8. 새로운 시작, 압도적인 개발의 자유로움 (부제: AI 바이브 코딩의 함정에 빠지다)

9. 기본부터 다시 하기: 마음을 비우고 FastAPI 서버와 Cloudflare 터널을 뚫다

10. 방구석 서버의 한계를 넘다: Render 백업부터 웹진형 게시판 개발까지