FIELD MANUAL · UNIT 03 · 2026. 7. 3.

JSON-LD 입문 — 사이트에 신분증 달기

AI에게 사이트는 긴 텍스트 덩어리다

사람은 로고와 디자인으로 "아, 치과구나"를 0.5초 만에 압니다. AI는 그 판단을 텍스트와 구조에서 해야 합니다. JSON-LD(JavaScript Object Notation for Linked Data)는 그 판단을 추측이 아닌 선언으로 바꿔주는 표준입니다.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Dentist",
  "name": "OO치과의원",
  "telephone": "02-123-4567",
  "address": {
    "@type": "PostalAddress",
    "addressLocality": "서울 강남구",
    "streetAddress": "테헤란로 123"
  }
}
</script>

이 코드 한 블록으로 AI는 이 사이트가 누구고, 어디 있고, 어떻게 연락하는지를 확신하게 됩니다.

어떤 @type을 써야 하나

일반 기업·단체 → Organization
지역 기반 사업장(매장·식당) → LocalBusiness
병원·의원 → MedicalClinic, 치과는 Dentist
콘텐츠 페이지 → Article, FAQ는 FAQPage
사이트 전체 → WebSite

한 단계 위: @graph 패턴

페이지마다 낱개 스키마를 흩뿌리는 것보다, @graph로 연결된 그래프를 선언하는 것이 상위 레벨입니다. 조직·웹사이트·페이지가 서로를 참조하면 AI가 사이트 전체의 관계도를 그릴 수 있습니다.

{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", "@id": "https://example.com/#organization", "name": "..." },
    { "@type": "WebSite", "@id": "https://example.com/#website",
      "publisher": { "@id": "https://example.com/#organization" } },
    { "@type": "WebPage", "@id": "https://example.com/#webpage",
      "isPartOf": { "@id": "https://example.com/#website" } }
  ]
}

핵심은 @id로 노드끼리 참조를 거는 것입니다. "이 페이지는 이 사이트의 일부고, 이 사이트는 이 조직이 발행한다"는 관계가 명시됩니다.

직접 만들 필요는 없습니다

SchemaWorks 진단을 돌리면 JSON-LD 생성기 탭에서 사이트 정보(상호·전화·주소)가 미리 채워진 @graph 코드를 발급해 드립니다. 복사해서 <head>에 붙여넣고, 재진단으로 적용을 확인하세요.

APPLY & VERIFY

이 유닛의 조치를 적용했다면, 재진단으로 점수 변화를 확인하세요.