개발 slecs

네이버 검색 어드바이저 소유권 인증을 상수 파일로 중앙 관리

목차

Naver 사이트 소유권 인증 코드를 상수 파일에 추가한 작업.

작업 자체는 한 줄짜리 값 추가지만, 이걸 어디에 어떻게 넣느냐는 꽤 의미 있는 판단이었다.

배경: 검색 노출은 "배포 후 작업"이 아니다

서비스 오픈 준비 중 SEO 체크리스트를 돌리다 보면 빠뜨리기 쉬운 게 바로 Naver Search Advisor 연동이다. Google Search Console은 챙기면서 Naver는 후순위로 밀리는 경우가 많은데, 국내 트래픽 비중을 생각하면 절대 그렇게 둬선 안 된다.

사이트 소유권 인증을 하지 않으면 Naver 쪽에서 색인 현황 확인도, 사이트맵 제출도, 검색 최적화 피드백도 전부 막힌다. 인증은 크게 HTML 파일 업로드 방식과 <meta> 태그 삽입 방식 두 가지인데, 이번엔 메타 태그 방식을 선택했다.

작업 내용: 왜 consts.ts에 넣었는가

변경 파일은 src/consts.ts 하나. 변경 통계도 따로 기재하지 않을 만큼 핀포인트 수정이다.

// src/consts.ts
export const NAVER_SITE_VERIFICATION = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";

이 값을 <head> 안에 직접 하드코딩하거나 환경변수로 빼는 방법도 있었다. 선택지를 정리하면 이렇다.

방법 장점 단점
<head>에 직접 인라인 빠름 값 위치 파악 어려움, 재사용 불가
.env 환경변수 환경별 분리 가능 이 값은 환경별 차이가 없음, 오버엔지니어링
consts.ts 상수 중앙 관리, 타입 안전, 추적 쉬움 없음

consts.ts는 이미 사이트 메타데이터, OG 태그 관련 값들이 모여 있는 파일이었다. 검색 엔진 인증 키는 "환경에 따라 달라지는 비밀 값"이 아니라 "사이트 자체에 귀속된 정적 식별자"이므로 상수 파일이 자연스러운 위치였다.

코드베이스 전체에서 이 값이 어디 있는지 찾아야 할 때, 환경변수로 박아두면 .env 파일을 열거나 CI 설정을 뒤져야 한다. 상수 파일에 두면 IDE에서 바로 추적된다. 팀원 입장에서도 "이게 뭔 값이지?"라는 질문이 줄어든다.

회고: 작은 변경일수록 네이밍과 위치가 전부다

stat이 작은 커밋일수록 코드리뷰에서 지나치기 쉽다. "한 줄 추가인데 뭘"이라는 분위기가 생기기 쉬운데, 오히려 이런 설정성 값들이 나중에 "이 값 어디서 왔어요?"로 돌아오는 경우가 많다.

상수 네이밍도 신경 썼다. NAVER_VERIFICATION보다 NAVER_SITE_VERIFICATION이 Search Advisor의 사이트 인증 용도임을 더 명확히 드러낸다. 이런 값이 늘어날 때를 대비해 GOOGLE_SITE_VERIFICATION도 같은 패턴으로 관리할 수 있다.

  • Naver Search Advisor 등록 → 메타 태그 방식 인증 코드 발급
  • consts.ts에 상수로 추가
  • <head> 컴포넌트에서 import해서 <meta name="naver-site-verification" content={NAVER_SITE_VERIFICATION} /> 렌더링
  • Search Advisor에서 소유권 인증 확인

이 흐름이 파일 하나에 응집되지 않고 여기저기 흩어지면 나중에 키를 교체하거나 다른 검색엔진 인증을 추가할 때 작업 범위가 불필요하게 커진다. 작은 작업일수록 "이다음에 누가 건드릴 때 어떻게 보일까"를 먼저 생각하는 버릇이 있는데, 이번 작업도 그 연장선이었다.

끝.

🛒 이 글과 어울리는 추천 상품

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.

이어보기

댓글 0

첫 댓글 달아줘.