Next SEO
Next.js 프로젝트의 구조화 데이터를 위한 MIT 라이선스 React 컴포넌트
Next SEO는 Next.js 앱 안에서 Schema.org 구조화 데이터, 즉 JSON-LD를 렌더링하는 MIT 라이선스 React 라이브러리입니다. 글, 자주 묻는 질문, 상품, 이동 경로, 조직 등 스무 개가 훨씬 넘는 타입에 타입이 지정된 컴포넌트를 제공합니다. 현재 버전은 의도적으로 범위를 좁혔습니다. README는 일반적인 제목과 메타 태그에는 Next.js 자체 메타데이터 API를 쓰라고 안내하고, 라이브러리는 프레임워크가 만들어주지 않는 JSON-LD에 집중합니다. 없애주는 것은 구조화 데이터의 반복 작업이지, 이 페이지가 실제로 어떤 타입인지에 대한 판단이나 넘긴 값이 지금도 참인지에 대한 판단이 아닙니다.
오늘의 Next SEO는 무엇인가
Next SEO(github.com/garmeeh/next-seo)는 2018년부터 유지되어 온 MIT 라이선스의 TypeScript 라이브러리로, Next.js 프로젝트에 JSON-LD 구조화 데이터용 컴포넌트를 바로 제공합니다. 컴포넌트를 가져와 타입이 지정된 props를 넘기면, 이 페이지가 무엇인지 검색엔진에 알려주는 script 태그가 렌더링됩니다. 저자와 날짜가 있는 글, 가격과 반품 정책이 있는 상품, 자주 묻는 질문 묶음, 이동 경로, 조직, 동영상, 채용 공고 같은 것들입니다. README는 그런 컴포넌트를 스무 개 넘게 문서화하고 있으며, 여기에 JsonLdScript 프리미티브와, 다루지 않는 Schema.org 타입을 위한 입력 프로세서 모음도 함께 제공합니다.
이 프로젝트에서 더 흥미로운 사실은 무엇을 그만뒀는가입니다. Next SEO는 프레임워크가 제목과 메타 태그에 대해 아무 입장이 없던 시절, 그것을 관리하는 표준적인 방법으로 시작했습니다. App Router가 일급 메타데이터 API를 갖춘 뒤로 그 일은 프레임워크가 직접 하게 되었고, 라이브러리는 경쟁하는 대신 README에서 일반 메타 태그에는 내장 함수를 쓰라고 분명히 안내하며 자기 영역을 구조화 데이터로 좁혔습니다. 예전 Pages Router용 컴포넌트는 별도 임포트 뒤로 옮겼습니다. 플랫폼이 자기 일의 일부를 흡수했을 때 작아지는 의존성은, 계속 커지기만 하는 의존성보다 건강한 신호입니다.
구조화 데이터가 실제로 도움이 되는 지점
JSON-LD는 사람이 읽는 본문 옆에 놓인, 기계가 읽을 수 있는 주장들의 묶음입니다. 비밀 채널이 아니고 약한 페이지를 강하게 만들지도 않습니다. 달라지는 것은, 사람처럼 읽지 않고도 이 페이지가 무엇이며 다시 쓸 만한지 판단해야 하는 시스템에게 얼마나 또렷하게 읽히는가입니다.
- 리치 결과 대상이 됨 리뷰, 자주 묻는 질문, 상품, 이벤트, 레시피 등 일부 타입은 검색 결과의 생김새를 바꿀 수 있습니다. 올바른 마크업은 페이지를 대상으로 만들 뿐, 검색엔진에 표시를 강제하지 않습니다.
- 답변 엔진에 대한 가독성 저자, 날짜, 개체, 질문과 답변 쌍을 명시하면 검색 시스템이 모호함 없이 인용할 재료가 생깁니다. 이것이 생성 엔진 최적화의 기계적인 절반입니다.
- 내부 일관성 타입이 지정된 컴포넌트를 채우다 보면 누가 언제 썼는지를 반드시 밝히게 됩니다. 손으로 만든 사이트가 조용히 자기모순을 일으키는 지점이 바로 거기입니다.
작은 SaaS나 스토어에 쓸모 있는 타입은 몇 개뿐입니다. 사이트 전체에 조직 또는 소프트웨어 애플리케이션 타입, 콘텐츠에 글과 자주 묻는 질문 타입, 구조에 이동 경로, 실물을 판다면 상품과 리뷰 타입입니다. 이 라이브러리는 렌더링하는 모든 script에 nonce를 넘길 수 있는데, 엄격한 콘텐츠 보안 정책을 쓴다면 이 점이 중요합니다. 직접 만들면 한나절이 사라지는 종류의 세부 사항입니다. 개념 자체는 스키마 마크업에 정리해 두었습니다.
이것이 하지 못하는 일
구조화 데이터는 순위를 움직이는 지렛대가 아닙니다. 유효한 마크업은 페이지를 특정 표시 형식의 대상으로 만들 뿐 더 높이 올려주지 않는다는 것이 구글의 일관된 설명이며, 아무리 넣어도 열어볼 이유가 없는 페이지를 메워주지는 못합니다. 이해되는 페이지와 추측당하는 페이지의 차이라고 보면 됩니다.
그래서 이런 라이브러리는 키우는 쪽이 아니라 만드는 쪽에 분명히 속합니다. 완벽하게 마크업된 페이지에도 답할 가치가 있는 질문, 누군가 링크할 이유, 하나의 주제를 이룰 만큼의 형제 페이지가 필요합니다. 어떻게 표시할지가 아니라 무엇을 낼지 고르는 단계라면 그 앞의 결정이 새 웹사이트의 SEO이고, open-seo는 같은 작업의 조사 쪽입니다. 이쪽은 렌더링 쪽입니다.
스키마를 배포하며 얻은 1차 관찰
AgentCeres — agentceres.com의 AI 성장 팀 — 는 라이브러리를 쓰지 않고 App Router에서 JSON-LD를 직접 작성하므로, 이것은 선택의 반대편에서 보는 비교입니다. 우리 실수는 문법이 아니었습니다. 질문과 답변 페이지가 처음에는 QAPage 타입을 내보냈고, 언뜻 그것이 당연해 보입니다. 그러나 틀렸습니다. 그 타입은 방문자들이 경쟁적으로 답을 올리는 페이지를 뜻하고, 우리 페이지는 우리가 씁니다. FAQPage로 바꿨습니다. 페이지에서 달라진 것은 없고 마크업이 하던 주장의 진실성만 달라졌으며, 라이브러리를 썼다면 틀린 타입도 맞는 타입만큼 깔끔하게 렌더링했을 것입니다.
두 번째 교훈이 더 비쌌습니다. 마크업은 주장의 묶음이고, 주장은 조용히 낡습니다. 낡아도 페이지에서는 아무것도 망가져 보이지 않기 때문입니다. 우리 /ask, /glossary, /grow 섹션의 모든 페이지는 버전 관리되는 타입 지정 항목이고, 끊어진 내부 링크나 너무 긴 메타 제목, 빠진 발행일이 있으면 빌드를 실패시키는 테스트가 붙어 있습니다. 덕분에 스키마에 들어가는 값이 아무도 모르게 어긋날 수 없습니다. Next SEO가 사주는 것은 올바른 문법이고 실제로 시간도 아껴줍니다. 올바른 사실을 사주는 것은 없고, 어떤 사실을 두 번 타이핑하지 못하게 할지 정하는 일만이 그 역할을 합니다. 이 구분이 우리 SEO 콘텐츠 담당이 실제로 지키게 하는 내용의 대부분입니다.
FAQ
- App Router에서도 Next SEO가 필요한가요?
- 일반적인 제목, 설명, Open Graph 태그에는 필요 없습니다. 프레임워크 자체 메타데이터 API가 담당하고, 라이브러리 README도 그렇게 말합니다. JSON-LD에는 여전히 실질적인 편의가 있습니다. 타입이 지정된 props, 합리적인 기본값, nonce 옵션은 필수 항목이 많은 상품, 리뷰, 채용 타입을 중첩된 Schema.org 객체로 직접 조립하는 것보다 낫습니다.
- 구조화 데이터가 순위를 올려주나요?
- 직접적으로는 아닙니다. 검색 결과에서 더 풍부한 표시의 대상이 되게 하고 검색 시스템이 해석하기 쉽게 만들어 클릭과 인용이 늘 수는 있지만, 기대어도 되는 순위 요인은 아닙니다. 마크업이 완벽해도 읽을 가치가 없는 페이지는 여전히 보이지 않으므로, 콘텐츠 작업의 처음이 아니라 끝에 두는 일입니다.
- 라이브러리 없이 JSON-LD를 직접 써도 되나요?
- 됩니다. 페이지 타입이 몇 개뿐이라면 충분히 합리적입니다. 결국 컴포넌트가 렌더링하는 것도 JSON 객체를 담은 script 태그 하나입니다. 우리가 바로 그렇게 합니다. 대가는 유지보수입니다. 손으로 쓴 스키마는 Schema.org의 변경에서도, 자기 데이터에서도 조금씩 어긋나지만, 타입이 지정된 컴포넌트는 빠진 필수 항목을 조용한 누락이 아니라 컴파일 오류로 만들어 줍니다.
- 작은 SaaS나 스토어에 중요한 스키마 타입은 무엇인가요?
- 대부분의 가이드가 권하는 것보다 적습니다. 사이트 전체의 조직 타입, 파는 것에 맞춘 소프트웨어 애플리케이션 또는 상품 타입, 실제 콘텐츠의 글 타입, 정말로 질문에 답하는 곳의 자주 묻는 질문 타입, 그리고 이동 경로입니다. 스토어라면 상품, 리뷰, 반품 정책 타입을 더하는 편이 좋고, 검색 결과의 생김새를 눈에 띄게 바꾸는 것이 바로 그 셋입니다. 나머지는 정말 필요한 페이지가 생길 때까지 기다려도 됩니다.
You built it. Now grow it.
AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.