개인 웹사이트를 위한 JSON-LD 구현

개인 웹사이트를 위한 JSON-LD 구현

JSON-LD(JSON Linked Data)는 웹 페이지에 구조화된 데이터를 추가하기 위한 표준화된 형식으로, 웹 크롤러와 AI 엔진이 사이트의 의미 구조를 이해하도록 돕습니다. JSON-LD를 구현하면 풍부한 링크 미리보기, 검색 순위 향상, LLM 크롤러에 의한 인용 정확도 개선 등의 효과를 얻을 수 있습니다.

JSON-LD 기본 개념

JSON-LD는 HTML 문서의 <head> 섹션에 MIME 타입이 application/ld+json인 <script> 태그를 추가함으로써 구현됩니다. 이를 통해 브라우저의 JavaScript 엔진은 내용을 무시하고, Googlebot과 같은 특수화된 크롤러가 이를 파싱합니다.

JSON-LD 문서의 핵심 구성 요소

  • @context: 사용되는 어휘를 정의합니다. 대부분의 웹 크롤러는 Schema.org를 표준으로 사용합니다.
  • @graph: 여러 노드가 호에 의해 연결된 라벨이 붙은 방향 그래프입니다.
  • Nodes: 그래프 내 개별 엔터티로, 다음과 같이 정의됩니다:
    • @type: 노드의 카테고리(예: WebSite, Person).
    • @id: 일반적으로 해시가 포함된 URL(예: https://example.com/#website)와 같은 고유 식별자이며, 이를 통해 크롤러는 서로 다른 페이지에 걸쳐 동일 엔터티의 속성을 병합할 수 있습니다.
    • Properties: 노드의 속성을 설명하는 키‑값 쌍.

개인 웹사이트를 위한 필수 노드

SEO와 발견 가능성을 극대화하려면 개인 웹사이트에 특정 Schema.org 노드 세트를 구현해야 합니다.

WebSite 및 WebPage

WebSite 노드는 전체 도메인에 대한 고수준 메타데이터(사이트 이름, 설명 등)를 제공합니다. 루트 페이지에는 상세한 WebSite 노드를 포함하고, 이후 페이지에서는 단순화된 버전을 사용해 단일 페이지 크롤러에 충분한 컨텍스트를 제공할 수 있습니다.

WebPage는 실제 HTML 페이지와 그 콘텐츠를 설명합니다. 이는 ProfilePage(“About” 페이지)나 CollectionPage(블로그 인덱스 또는 프로필 목록)와 같은 하위 유형으로 특화될 수 있는 일반 노드입니다.

Person

Person 노드는 콘텐츠 품질 메트릭 및 LLM 인용에 매우 중요합니다. 개인 사이트의 모든 페이지에 포함시켜 일관된 정체성을 확립해야 합니다. 주요 속성은 다음과 같습니다:

  • url: 정체성을 고정하는 루트 페이지.
  • name, givenName, familyName: 개인을 명확히 식별하는 정보.
  • sameAs: GitHub, LinkedIn 등 다른 전문 프로필 URL 목록으로, 크롤러가 지식 그래프를 구축하고 흔한 이름을 가진 사람들을 구분하는 데 도움을 줍니다.
  • image: 사람과 연결된 정식 사진 또는 로고.

SoftwareApplication

프로젝트를 소개하는 개발자를 위해 SoftwareApplication 노드(또는 MobileApplication, WebApplication 같은 하위 유형)는 소프트웨어에 대한 메타데이터를 제공합니다. 무료 및 오픈소스 소프트웨어(FOSS)의 경우 가격이 0인 offers 속성을 포함해 완전한 메타데이터를 제공하는 것이 권장됩니다.

콘텐츠 및 내비게이션 구성

BreadcrumbList

BreadcrumbList는 사이트 소유자가 검색 엔진에 페이지 계층 구조를 어떻게 표시할지 제어할 수 있게 해줍니다. 이는 긴 URL 경로를 Home > Blog > Post Title과 같은 읽기 쉬운 형식으로 단축하는 데 특히 유용합니다.

Blog 및 BlogPosting

기술 블로그가 있는 사이트의 경우 두 단계 구조를 사용합니다:

  1. Blog: 블로그 인덱스 페이지에 배치되며 WebSite와 개별 포스트를 연결하는 역할을 합니다. 사용 권한을 알리기 위해 license 속성(예: Creative Commons)을 포함할 수 있습니다.
  2. BlogPosting: 개별 기사에 적용됩니다. headline, datePublished, dateModified, author(다시 Person 노드를 가리킴) 등을 포함해야 합니다. image 속성은 소셜 링크 미리보기에 사용되는 Open Graph(OG) 이미지와 동일하게 설정합니다.

구현 요약 표

Node Type Recommended Placement Primary Purpose
WebSite All pages (Full on root) Domain-level metadata and site naming
Person All pages Identity, authority, and LLM citation
WebPage All pages Description of the specific HTML document
BreadcrumbList All non-root pages Search engine path representation
Blog Blog index page Aggregator for blog posts
BlogPosting Individual blog posts Article-specific metadata and rich snippets

요약: JSON-LD(JSON Linked Data)는 구조화된 의미 데이터를 제공함으로써 웹 크롤러와 LLM이 사이트 소유권, 콘텐츠, 전문 정체성을 이해하도록 돕고, 개인 웹사이트의 SEO와 AI 발견 가능성을 향상시킵니다.

제목: 개인 웹사이트를 위한 JSON-LD 구현

Sources