<iframe width="100%" height="400" src="https://www.youtube.com/embed/Ei_mbRbHzys" frameborder="0" allowfullscreen></iframe>
바이브코딩으로 만든 사이트가 검색에 안 뜬다면? 먼저 '페이지 소스'부터 열어보세요
멋진 사이트를 뚝딱 만들었습니다. 화면도 잘 나오고, 버튼도 잘 눌리고, 디자인도 깔끔합니다. 그런데 이상합니다. 네이버나 구글에 검색해도 내 사이트가 도무지 보이지 않습니다.
"내가 만든 페이지가 멀쩡히 떠 있는데 왜 검색엔진은 못 찾을까?"
바이브코딩으로 빠르게 사이트를 찍어낼 수 있게 되면서, 이 질문으로 막히는 분들이 정말 많아졌습니다. 그리고 그 원인의 상당수는 "브라우저가 보는 화면"과 "검색로봇이 읽는 문서"가 서로 다르다는 데 있습니다. 오늘은 그 차이를 '페이지 소스'라는 아주 간단한 도구로 확인하는 법을 이야기해보겠습니다.
브라우저 화면 ≠ 검색로봇이 받는 문서
우리는 보통 사이트를 '눈에 보이는 화면'으로 이해합니다. 하지만 웹사이트는 두 단계로 존재합니다.
1. 서버가 처음 내려주는 HTML 문서 — 가장 먼저 도착하는 '원본'
2. 브라우저가 자바스크립트를 실행한 뒤 완성된 화면 — 우리가 실제로 보는 것
문제는 여기서 발생합니다. 요즘 많은 프레임워크(React, Vue, Next.js의 일부 설정 등)는 처음에 거의 텅 빈 HTML을 내려보냅니다. 그리고 브라우저가 자바스크립트를 실행하면서 그제서야 내용을 채워 넣죠. 이걸 클라이언트 사이드 렌더링(CSR) 이라고 합니다.
사람 눈에는 아무 문제가 없습니다. 자바스크립트가 순식간에 실행되니까요. 하지만 검색로봇 중 상당수는 처음 받은 '원본 HTML'을 기준으로 내용을 판단합니다. 그 원본이 비어 있다면?
> 검색엔진 입장에서 당신의 사이트는 "내용 없는 빈 페이지" 입니다.
직접 확인하는 법: 페이지 소스 보기
말로만 들으면 와닿지 않으니 직접 확인해봅시다. 방법은 아주 간단합니다.
- Windows: 페이지에서
Ctrl + U - Mac:
Cmd + Option + U - 또는 마우스 우클릭 → "페이지 소스 보기(View Page Source)"
- 텍스트가 그대로 보인다 → 검색로봇도 읽을 수 있습니다. 👍
<div id="root"></div>같은 빈 껍데기만 있고 내용이 없다 → 로봇에겐 빈 페이지입니다. 🚨- 검색에 안 뜨는 사이트는 광고비를 내야만 사람이 들어옵니다. 공짜 유입(검색)이 막히면, 수익 구조 전체가 흔들립니다.
- 반대로 검색 유입이 잘 잡히는 사이트는 잠자는 동안에도 방문자가 쌓입니다. 이게 콘텐츠·제휴·광고로 돈을 버는 사이트의 기본 엔진입니다.
Ctrl + U한 번이면 배포 전에 미리 이 문제를 잡을 수 있습니다. 출시한 뒤 "왜 아무도 안 들어오지?" 하며 몇 주를 날리는 것과는 비교할 수 없는 차이입니다.- 브라우저 화면과 검색로봇이 읽는 문서는 다를 수 있다.
Ctrl + U(페이지 소스 보기)로 원본 HTML을 확인하라. 개발자 도구 말고.- 소스에 내 콘텐츠 텍스트가 없다면 → SSR/SSG로 전환을 검토하라.
- 배포 전 1분 점검이 검색 유입, 즉 수익의 출발점을 지킨다.
여기서 중요한 포인트가 있습니다. "검사(Inspect / 개발자 도구)"가 아니라 "페이지 소스 보기"를 눌러야 한다는 것입니다.
| 메뉴 | 보여주는 것 | 검색로봇 관점 |
|------|------------|--------------|
| 페이지 소스 보기 (Ctrl+U) | 서버가 처음 내려준 원본 HTML | ✅ 이게 진짜 기준 |
| 검사 / 개발자 도구 | 자바스크립트 실행 후 완성된 화면 | ❌ 로봇이 보는 게 아님 |
개발자 도구(Elements 탭)는 이미 자바스크립트가 다 실행된 '결과물'을 보여주기 때문에, 여기선 내용이 멀쩡히 보입니다. 그래서 "소스에 다 있는데?"라고 착각하기 쉽습니다. 반드시 페이지 소스 보기로 원본을 확인하세요.
소스 창이 뜨면 Ctrl + F로 내 글의 제목이나 본문 핵심 문장을 검색해보세요.
그래서 어떻게 고치나요?
원인을 알았으니 해결책도 명확합니다. 핵심은 "로봇이 처음 받는 HTML에 내용을 담아주는 것" 입니다.
1. 서버 사이드 렌더링(SSR) 또는 정적 생성(SSG) 사용 Next.js, Nuxt, Astro 같은 도구는 서버에서 미리 HTML을 완성해 내려줍니다. 바이브코딩으로 시작하더라도, SEO가 중요한 프로젝트라면 처음부터 이런 프레임워크를 선택하는 게 가장 깔끔합니다.
2. 메타 태그와 핵심 콘텐츠는 HTML에 직접
<title>, <meta name="description">, 대표 이미지(OG 태그) 같은 요소는 자바스크립트로 나중에 채우지 말고 원본 HTML에 들어가 있도록 하세요.
3. 정적으로 만들 수 있는 페이지는 정적으로 소개 페이지, 블로그 글, 상품 상세처럼 내용이 자주 바뀌지 않는 페이지는 굳이 CSR로 만들 이유가 없습니다.
'돈 버는 코딩' 관점에서의 진짜 교훈
여기서 멈추면 그냥 기술 팁입니다. 하지만 수익이라는 관점에서 보면 이야기가 완전히 달라집니다.
바이브코딩의 진짜 강점은 빠른 속도입니다. 아이디어를 하루 만에 사이트로 만들 수 있죠. 그런데 많은 분들이 여기서 치명적인 실수를 합니다. "만드는 것"에만 집중하고 "발견되는 것"을 놓치는 것입니다.
빠르게 만드는 능력에 "검색로봇의 눈으로 내 사이트를 검증하는 습관" 하나만 더하면, 당신의 결과물은 '그냥 만든 사이트'에서 '돈이 들어오는 자산'으로 바뀝니다. 기술은 1분이면 배우지만, 그 1분이 만드는 결과의 차이는 수개월입니다.
오늘의 정리
이 주제에 대해 더 배우고 싶다면 TTJ 코딩클래스를 확인해보세요.