본문으로 건너뛰기

바이브 코딩 홈페이지 제목 태그(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/ (이용호님): 제목 구조 본보기

2

함께 이야기해요 2

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

AngieYoo_앤지 프로필 이미지
AngieYoo_앤지2026.10.18

제 사이트도 수정해야하는데 너무 상세하게 사례글 써주셔서 넘 감사합니다 🥹👍

체크check 프로필 이미지
체크check2026.10.16

사이트 들어가보니 실제로 반영하신게 보이네요. 글씨 크기·색·간격·디자인 바꾸지 않고 크기 변경 성공하셨군요ㅎㅎ

사진(이미지) 관련 개선하실때 "이미지 용량과 크기, 로딩 우선순위를 고려해서 초기 응답속도를 개선"해보세요. 측정은 pagespeed.web.dev/ 에서 하실수 있고 이 내용을 AI 에게 질문해보면 좀더 자세히 파악해줄것 같습니다! 고생하셨습니다.

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

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

이런 사례도 있어요

사례 전체 보기