Google Search Console에 사이트 등록하기 — Astro.js + Cloudflare Pages

Google Search Console이 뭔가

구글이 내 사이트를 얼마나 잘 수집(크롤링)하는지 확인하고 관리하는 도구입니다.

등록하지 않으면:

• 구글이 내 사이트를 발견했는지 모름
• 어떤 페이지가 색인됐는지 모름
• 검색 노출 키워드를 모름

---

사전 조건

• 도메인 소유 확인 가능 (DNS 접근 또는 HTML 파일 업로드)
• Google 계정

---

등록 과정

1단계: Search Console 접속

search.google.com/search-console 접속 → 로그인 → 속성 추가.

두 가지 방법 중 선택:

• 도메인 속성: example.com (서브도메인 전체 포함)
• URL 접두어 속성: https://example.com (정확한 URL)

Cloudflare Pages + 커스텀 도메인이면 도메인 속성으로 등록하는 게 깔끔합니다.

---

2단계: 소유권 확인

방법 A: DNS TXT 레코드 (권장)

구글이 TXT 레코드 값을 줍니다.

Cloudflare DNS 설정:

유형: TXT
이름: @
값: google-site-verification=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TTL: Auto

Cloudflare에서 저장 → Search Console에서 확인 클릭.

DNS 전파에 몇 분 걸립니다. 바로 안 되면 5분 후 재시도.

방법 B: HTML 파일

구글이 주는 파일 (googlexxxxxxxx.html)을 사이트 루트에 업로드.

Astro.js의 경우 public/ 폴더에 넣으면 됩니다:

public/
  googlexxxxxxxx.html   ← 여기
  favicon.ico

빌드하고 GitHub push → Cloudflare Pages 배포 완료 후 확인.

---

3단계: 사이트맵 제출

Astro.js는 @astrojs/sitemap 패키지로 자동 생성합니다.

설치:

npm install @astrojs/sitemap

astro.config.mjs:

import { defineConfig } from 'astro/config';
import sitemap from '@astrojs/sitemap';

export default defineConfig({
  site: 'https://issue.namane.info',  // 실제 URL 입력
  integrations: [sitemap()],
});

빌드하면 dist/sitemap-index.xml이 생깁니다.

Search Console → Sitemaps → sitemap-index.xml 입력 → 제출.

---

4단계: 개별 URL 색인 요청

빨리 색인 원하는 페이지는 수동으로 요청합니다.

Search Console 상단 검색창에 URL 입력 → “색인 생성 요청”.

요청 후 실제 색인까지 며칠~몇 주 걸립니다.

---

자주 묻는 것들

Q: 등록하면 바로 검색에 나오나?

아닙니다. 색인 생성 → 순위 평가 → 검색 노출 순서입니다. 신규 사이트는 초기에 순위가 낮습니다.

Q: noindex 페이지도 등록해야 하나?

noindex 페이지는 구글이 색인하지 않습니다. 등록 자체는 가능하지만 의미 없습니다. 숨기고 싶은 페이지는 noindex 처리로 충분합니다.

Q: 여러 도메인이 있으면?

도메인마다 별도 속성으로 등록합니다. issue.namane.info와 namane.info는 별개.

---

확인 방법

등록 후 며칠 지나면:

• 실적: 검색 노출, 클릭 수, CTR
• 색인 생성 상태: 몇 개 페이지가 색인됐는지
• 페이지 경험: Core Web Vitals 점수

색인 상태에서 “크롤링됨 - 현재 색인이 생성되지 않음”이 많으면 콘텐츠 품질 문제일 가능성이 높습니다.

---

주의사항

• 사이트맵 URL은 실제 도메인과 일치해야 합니다 (astro.config.mjs의 site 값)
• Cloudflare Pages 프리뷰 URL(.pages.dev)은 별도 속성으로 등록하거나 무시
• 색인 요청은 하루 할당량이 있음 (한 번에 너무 많이 보내지 말 것)