바이브 코딩 홈페이지 제목 태그(h1·h2·h3) 메타 체커로 점검하고 고치기
2026.10.15
소개
왜 홈페이지 제목 태그를 고쳤나요?
가평 독채 펜션 모아채 홈페이지의 제목 태그(h1·h2·h3) 구조를 고쳐, 검색 봇과 AI가 제목만 보고 각 페이지에 무엇이 어디 있는지 알 수 있게 했습니다.
오프 모임에서 스터디장님이 메타 체커로 모아채를 보시고 "정보는 많은데 뭐가 어디에 있는지 찾기 어렵다"고 짚어 주셨습니다. 봇과 AI는 본문을 다 읽기 전에 h 태그만 보고 이 페이지에 답이 있을지 판단한다고 하셨습니다.
개선 전 모아채의 제목 구조는 어땠나요?
메타 체커 콘텐츠 탭으로 보니 홈은 h1이 2개, 본문 섹션 제목은 하나도 제목 태그가 아니었고, 객실·소개·문의 페이지는 h1이 없었습니다.
진행 방법
사용한 도구
크롬 확장 프로그램 Meta Checker(콘텐츠 탭 > 제목 구조)
Claude Code 두 개: 옵시디언 노트에서 근거를 모으고 지시문을 만드는 쪽, 홈페이지 코드를 고치는 개발 터미널 쪽
본보기 사이트: 호연지재 https://hovision.co.kr/
1단계 메타 체커로 지금 제목 구조 확인하기
홈 제목 구조 4개, h1 2개, h2는 푸터의 "둘러보기"·"예약"뿐이었습니다.
모아채 제목 구조 개선 전 2026-10-15.png
2단계 제목 구조가 잘된 사이트와 비교하기
h1 하나 아래 h2(섹션), 그 아래 h3(항목). h2 일부는 "머신비전 검사는 현장에서 어떤 문제를 해결하나요?"처럼 고객 질문 문장입니다.
호연지재 제목 구조 2026-10-15.png
3단계 화면 글은 그대로 두고 태그만 바꾸는 구조안 만들기
옵시디언 쪽 Claude Code에게 강의 노트(오프 모임 녹음 정리)에서 관련 피드백을 모으게 하고, 화면에 이미 있는 글만으로 페이지별 제목 구조안과 개발 터미널 지시문을 만들게 했습니다.
원칙: 화면 글씨·디자인은 그대로 두고 태그만 바꾼다. 화면과 다른 메타데이터는 AI가 일관성 없는 걸 알아보기 쉬워 추천하지 않는다는 피드백을 따랐습니다.
지시문에 넣은 것: 페이지별 h1·h2·h3 목록, 내가 고를 결정은 먼저 제안받기, 한 번으로 끝나지 않게 하는 장치(제목 글 한 곳 관리, 검사 명령, 규칙 파일), 완료 확인 기준
4단계 개발 터미널에 붙여 넣은 프롬프트 전문
모아채 홈페이지의 제목 태그(h1·h2·h3) 구조를 고치려고 해. 화면에 보이는 글씨 크기·색·간격·디자인은 하나도 바꾸지 말고, 지금 있는 글의 태그만 바꿔 줘.
목표
- 검색 봇과 AI가 제목 태그만 보고 각 페이지에 무엇이 어디 있는지 알 수 있게 한다.
- 페이지마다 h1은 하나, 섹션 제목은 h2, 섹션 안 항목은 h3.
지금 상태 (서버 HTML 기준)
- 홈: h1이 2개(모바일용·데스크톱용 본문이 HTML에 둘 다 있어서). 본문 섹션 제목은 제목 태그가 아니다.
- 객실·소개·문의: h1이 없다. h2는 푸터의 "둘러보기"·"예약"뿐이다.
바꿀 구조
[홈 /]
h1 자연 속, 한 팀만의 하루
h2 머무는 동안, 온전히 우리만의 공간
h2 독채 한 채, 두 개의 층 > h3 1층 / h3 2층 / h3 한 채 통째 예약
h2 청결, 후기로 증명합니다
h2 누구와 와도 좋은 하루 > h3 가족 / h3 커플 / h3 골프 / h3 워케이션
h2 공간의 순간들
h2 오시는 길
h2 지금, 모아채의 하루를 예약하세요
[객실 /rooms]
h1 온전한 독채, 두 개의 층
h2 집 안을 미리 둘러보기 > h3 1층 / h3 2층 / h3 다이닝 룸
h2 머무시는 데 준비된 것들
h2 청결로 증명된 하루
h2 머무시기 전에 > h3 금연 / 반려동물 불가 / 인원 / 야간 소음 / 바비큐·모닥불 / 고가 수목 / 손해배상
h2 지금, 모아채의 하루를 예약하세요
[소개 /about]
h1 숲이 지은 집, 모아채
h2 도시의 소란을 내려놓는 하나의 집
h2 곁을 지키는 사람
h2 머무는 동안 둘러보기 > h3 맛집 / 카페 / 볼거리 / 레저
h2 요금 안내 > h3 주중 / 주말 / 성수기
h2 오시는 길
h2 자주 묻는 질문 > h3 질문 8개 각각
h2 모아채에서의 하루를 예약하세요
[문의 /contact]
h1 문의하기
h2 카카오 채널로 문의해 주세요 / h2 연락처 / h2 응대 안내
[모든 페이지 푸터]
"둘러보기"·"예약"은 제목 태그를 빼고 일반 글씨로.
규칙
- 영문 눈썹 글씨(ROOMS · 객실 같은 작은 영문)는 제목 태그에 넣지 않는다.
- 모바일·데스크톱 본문이 HTML에 두 벌 들어 있으면, 페이지 전체에서 h1이 하나만 남게 할 방법을 2가지 이내로 먼저 제안하고 내가 고른 뒤 진행해.
- 같이 고칠 것: 소개 OUR STORY 첫 문장이 모바일("이 집을 짓고 살면서")과 데스크톱("이 집을 처음 보았을 때")에서 다르다. 모바일 문장("숲으로 둘러싸인 이 집을 짓고 살면서, 도시의 소란에서 저절로 멀어졌습니다.")으로 맞춰.
- 주차 문구는 docs/운영 정책서.md의 주차 항목을 따른다. 지금 "마당 2~6대 무료"(home/location, home/mobile/location, about/location)를 정책 문구(부지 안 2대 무료, 더 오시면 예약 시 미리 알려 달라는 안내)로 맞춰. 6대는 손님 문구에 쓰지 않는다.
- 시작 전에 지금 상태를 커밋해 되돌릴 수 있게 해.
계속 유지하기 (이번 한 번으로 끝내지 않기)
- 데스크톱·모바일 컴포넌트가 따로 있어 같은 제목을 두 번 적고 있다. 섹션 제목 글은 한 곳에만 두고 두 화면이 같이 쓰게 해 줘. 화면 모양은 그대로.
- 4페이지의 h1 개수와 h2·h3 목록을 출력하고, h1이 1개가 아니면 실패하는 검사 명령을 package.json scripts에 하나 만들어 줘(새 라이브러리 설치 없이).
- CLAUDE.md에 "제목 구조" 규칙을 짧게 더해 줘: 페이지당 h1 하나 / 섹션 제목 h2 / 섹션 안 항목 h3 / 영문 눈썹 글씨는 제목 아님 / 제목 글은 한 곳 / 화면 글을 고친 뒤 검사 명령을 돌린다.
- 이 작업 순서: 제안(h1 하나 남기는 방법 2가지 이내 + 제목 글을 모을 위치) → 내 선택 → 구현 → 검사 명령 → 전후 캡처.
완료 확인
- 4페이지 각각 서버 HTML에서 h1이 정확히 1개, 위 h2·h3 목록이 순서대로 나오는지 페이지별 목록으로 보여 줘.
- 화면 캡처 전후가 같게 보이는지 확인해 줘.
- 막히면 멈추고 무엇이 막혔는지 한 줄로 알려 줘.
5단계 데스크톱·모바일 화면이 두 벌일 때 h1 하나 남기기
개발 터미널이 물어본 결정에 답했습니다.
h1을 하나만 남기는 방법: "한 벌만 진짜 태그". 진짜 h1·h2·h3는 모바일 본문에, 데스크톱 본문은 role="heading"만. 구글이 모바일 화면 기준으로 색인하기 때문입니다.
제목 글 위치: src/lib/headings.ts 한 파일에 모아 두 화면이 같이 쓰게.
6단계 메타 체커로 개선 결과 확인하기
홈 제목 구조 15개, h1 1개 아래 h2·h3로 정리됐습니다.
모아채 제목 구조 개선 후 2026-10-15.png
결과와 배운 점
결과: 4페이지 모두 h1 1개, 화면은 그대로
4페이지 모두 h1 1개. h2는 홈 7·객실 5·소개 7·문의 3개.
전후 화면 캡처를 픽셀 단위로 비교해 화면은 그대로인 것을 확인했습니다. 바뀐 곳은 의도한 주차 문구와 소개 첫 문장뿐입니다.
배운 점: 크게 보이는 글도 태그가 아니면 제목이 아니다
화면에서 크게 보이는 글도 태그가 아니면 봇에게는 제목이 아닙니다. 메타 체커 콘텐츠 탭으로 바로 보입니다.
바이브 코딩으로 만든 사이트는 디자인은 잘 나와도 제목 태그가 비어 있을 수 있습니다. 만들고 나서 한 번은 꼭 메타 체커로 확인하는 게 좋겠습니다.
꿀팁: AI에게 제목 태그 수정을 맡길 때 지시문에 넣을 3가지
지시문에 "글씨 크기·색·디자인은 바꾸지 말고 태그만"을 넣으면 화면이 그대로 유지됩니다.
결정할 일은 "2가지 이내로 먼저 제안하고 내가 고른 뒤 진행"으로 넣어 두면 AI가 혼자 정하지 않습니다.
h1 개수를 세는 검사 명령을 만들어 두면 다음에 글을 고칠 때도 구조가 깨졌는지 바로 압니다.
시행착오: 화면 두 벌, 전역 글꼴, FAQ 버튼
데스크톱용·모바일용 화면이 HTML에 두 벌 들어 있어서 h1이 2개였습니다. 같은 문장이 두 벌에서 다르게 적혀 있는 곳, 주차 대수가 페이지마다 다른 곳도 이때 발견했습니다.
전역 CSS가 h1~h3에 제목용 글꼴을 입히고 있어서 그대로 h2로 바꾸면 글꼴이 달라질 뻔했습니다. 개발 쪽에서 그 규칙을 정리했습니다.
FAQ 질문은 펼치는 버튼 안에 있어 제목 태그를 넣을 수 없어서, 버튼 바깥을 h3로 감쌌습니다.
도움이 필요한 부분
데스크톱 쪽처럼 role="heading"으로만 둔 제목을 네이버·Bing이 어떻게 읽는지 궁금합니다.
"공간의 순간들"처럼 감성 문장 제목을 정보형 제목으로 바꾸는 게 나을지 의견을 듣고 싶습니다.
앞으로의 계획
구글 서치 콘솔 URL 검사와 네이버 수집 요청을 4페이지에 하기
사진이 버튼 배경으로 들어가 이미지로 안 잡히는 문제 고치기
다음에 만드는 사이트는 처음부터 HTML 한 벌(반응형)로 만들고, 제목 구조를 디자인 단계에서 먼저 정하기
도움 받은 글 (옵션)
GEO 실험실 오프 모임(용산) 스터디장 정성훈님 피드백: 메타 체커 사용법, 제목 태그 구조, 모아채 페이지 구조 피드백
호연지재 https://hovision.co.kr/ (이용호님): 제목 구조 본보기
로그인하고 댓글을 남겨 주세요
제 사이트도 수정해야하는데 너무 상세하게 사례글 써주셔서 넘 감사합니다 🥹👍




사이트 들어가보니 실제로 반영하신게 보이네요. 글씨 크기·색·간격·디자인 바꾸지 않고 크기 변경 성공하셨군요ㅎㅎ
사진(이미지) 관련 개선하실때 "이미지 용량과 크기, 로딩 우선순위를 고려해서 초기 응답속도를 개선"해보세요. 측정은 pagespeed.web.dev/ 에서 하실수 있고 이 내용을 AI 에게 질문해보면 좀더 자세히 파악해줄것 같습니다! 고생하셨습니다.