가이드

구조화된 데이터란? 스키마 마크업을 쉽게 설명해요

구조화된 데이터는 웹 페이지에 있는 작은 코드 블록으로, 페이지가 무엇에 관한 것인지 검색엔진이 이해할 수 있는 표준 형식으로 표시합니다. 예를 들어 “이 페이지는 Lavender Candle이라는 제품이고, 가격은 $24이며, 재고가 있습니다”와 같습니다. Google은 이를 페이지에 대한 정보를 제공하고 콘텐츠를 분류하는 표준화된 형식이라고 설명합니다. 올바르게 적용하면 검색엔진이 페이지를 더 잘 이해하고, 검색 결과 목록에 가격, 별점, 이벤트 날짜처럼 바로 보이는 정보가 담긴 더 풍부한 검색 결과에 노출될 자격을 얻을 수 있습니다.

AI로 만들 때 중요한 이유

검색엔진은 페이지를 잘 읽지만, 여전히 추측해야 합니다. “24”가 가격인지, 수량인지, 날짜인지? “Riverside Hall”이 장소인지 사람 이름인지? 구조화된 데이터는 이런 추측을 없애줍니다.

AI로 만든 사이트에서는 실용적으로 두 가지를 기억하세요:

  • 콘텐츠가 아니라 코드이므로 쉽게 잊힙니다. AI 빌더는 요청하지 않으면 보통 추가하지 않으며, 추가하더라도 실제 페이지 내용과 일치해야 합니다.
  • 겉보기에는 맞아 보여도 잘못되기 쉽습니다. AI가 없는 별점 5개를 만들거나, 보이지 않는 콘텐츠에 대한 마크업을 추가하거나, Google이 더 이상 보여주지 않는 타입을 쓸 수 있습니다. Google의 가이드라인은 정확성에 엄격하며, 잘못된 마크업은 무시되거나 불이익을 받을 수 있습니다.

정확하고 실제 콘텐츠에 맞는 구조화된 데이터는 조금이라도 있으면 가치가 있습니다. 지어낸 마크업이 많은 것은 아예 없는 것보다 나쁩니다.

일상 속 비유

슈퍼마켓에 있는 제품을 생각해보세요. 포장에는 화려한 디자인과 마케팅 문구가 있습니다. 이것이 사람들이 보는 웹 페이지입니다. 하지만 뒷면에는 표준화된 영양성분표도 있습니다. 모든 제품에서 같은 항목이 같은 순서로 적혀 있어서, 누구나 빠르게 읽고 제품을 비교할 수 있습니다.

구조화된 데이터는 페이지의 영양성분표입니다. 디자인은 원하는 대로 할 수 있지만, 라벨은 기계가 안정적으로 읽을 수 있도록 표준화되어 있습니다. 영양성분표처럼 내용물에 대해 정직해야 합니다.

구조화된 데이터의 작동 방식

구조화된 데이터는 두 부분으로 이루어집니다:

  1. 어휘(vocabulary) — 사물을 설명하는 단어입니다. 가장 흔한 것은 schema.org로, Product, LocalBusiness, Event, Article, Recipe, Organization 같은 타입과 name, price, address, startDate 같은 속성을 제공하는 공용 어휘입니다.
  2. 형식(format) — 라벨을 페이지에 기록하는 방법입니다. Google은 세 가지를 지원합니다: JSON-LD, Microdata, RDFa. Google이 권장하는 것은 JSON-LD로, 보이는 HTML과 분리된 <script> 태그 안의 JSON 블록입니다.

검색엔진은 이 블록을 읽고 페이지의 개체를 이해하며, 페이지가 조건을 충족하면 리치 결과, 즉 추가 정보가 담긴 검색 목록을 표시할 수 있습니다.

실제 예시: 캔들 쇼핑몰 상품 페이지

온라인 상점을 만들었고, 한 페이지에서 라벤더 캔들을 판매한다고 가정해봅시다. 보이는 페이지에는 이름, 사진, 설명, 가격($24.00), “재고 있음”이 표시됩니다.

이 페이지의 JSON-LD는 다음과 같을 수 있습니다:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Lavender Soy Candle",
  "image": "https://www.examplecandles.com/images/lavender.jpg",
  "description": "Hand-poured soy candle with lavender essential oil. Burns for about 40 hours.",
  "sku": "CAN-LAV-01",
  "brand": { "@type": "Brand", "name": "Example Candles" },
  "offers": {
    "@type": "Offer",
    "url": "https://www.examplecandles.com/candles/lavender",
    "price": "24.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}

이 코드는 페이지 HTML 안의 <script type="application/ld+json">…</script> 안에 들어갑니다.

여기에 없는 것을 주목하세요. aggregateRating이 없습니다. 상점이 페이지에 리뷰를 보여주지 않기 때문입니다. 방문자가 볼 수 없는 별점을 추가하면 Google 규칙을 위반하게 됩니다.

같은 상점의 연락처 페이지는 사업체 자체를 이렇게 설명할 수 있습니다:

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Example Candles",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "12 Market Street",
    "addressLocality": "Bristol",
    "postalCode": "BS1 1AA",
    "addressCountry": "GB"
  },
  "telephone": "+44 117 000 0000",
  "openingHours": "Mo-Sa 10:00-17:00"
}

다시 말하지만, 모든 값은 페이지에 보이는 내용과 일치합니다.

확인하기. 라이브 URL을 Google의 **리치 결과 테스트(Rich Results Test)**에 붙여넣어 페이지가 Google 리치 결과 대상인지, 필수 항목이 빠진 것은 없는지 확인하세요. 일반적인 schema.org 검사에는 **스키마 마크업 유효성 검사기(Schema Markup Validator)**를 사용하세요. 출시 후에는 Search Console에서 사이트 전반의 오류를 확인할 수 있습니다.

알아두면 좋은 규칙

Google의 구조화된 데이터 문서에 따르면:

  • 사용자에게 보이는 내용만 마크업하세요. 정확하더라도 페이지에서 보이지 않는 정보에 대한 구조화된 데이터를 추가하지 마세요.
  • 필수 속성을 포함하세요. 각 리치 결과 타입은 필수 항목을 나열하며, 누락되면 페이지가 대상에서 제외됩니다.
  • 자격 충족이 보장은 아닙니다. 올바른 마크업은 페이지를 리치 결과 대상으로 만들 뿐, 반드시 리치 결과가 표시된다는 뜻은 아닙니다.
  • 리치 결과 유형은 바뀝니다. Google은 시간이 지나면서 일부 기능을 중단합니다. 예를 들어 FAQ 리치 결과는 잘 알려진 정부 및 건강 사이트로 제한되었고, Google은 2026년 5월부터 검색에 더 이상 표시되지 않을 것이라고 발표했습니다. 특정 리치 결과를 목표로 하기 전에 Google의 현재 검색 갤러리를 확인하세요.
  • 마크업만을 위해 페이지를 만들지 마세요.

주요 용어 설명

용어의미
구조화된 데이터페이지에 있는 내용을 설명하는 표준화된 라벨입니다.
스키마 마크업schema.org 어휘를 사용하는 구조화된 데이터로, 같은 의미로 자주 쓰입니다.
Schema.org주요 검색엔진이 인식하는 타입과 속성의 공용 어휘입니다.
JSON-LDGoogle이 권장하는 형식으로, script 태그 안의 JSON 블록입니다.
Microdata / RDFaHTML 요소에 속성을 직접 추가하는 이전 형식입니다.
타입(Type)사물이 무엇인지 나타내며, 예를 들어 Product, Event, LocalBusiness입니다.
속성(Property)사물의 세부 정보로, 예를 들어 price, startDate, address입니다.
리치 결과(Rich result)가격이나 별점처럼 추가 시각 정보가 담긴 검색 목록입니다.
리치 결과 테스트(Rich Results Test)페이지가 Google 리치 결과 대상인지 확인하는 Google 도구입니다.
스키마 마크업 유효성 검사기(Schema Markup Validator)schema.org 마크업을 검사하는 일반 검증 도구입니다.

흔한 실수와 오해

  • “구조화된 데이터는 순위를 올린다.” 주된 가치는 이해와 리치 결과 자격이며, 순위를 빠르게 올리는 지름길이 아닙니다.
  • 리뷰나 별점을 지어내기. 가짜이거나 근거 없는 별점은 Google 규칙을 위반하고 사람들을 오도합니다.
  • 페이지와 맞지 않는 마크업. JSON-LD에는 $24, 페이지에는 $29로 되어 있다면 문제입니다.
  • 숨겨진 콘텐츠. 방문자가 볼 수 없는 텍스트를 마크업하는 것은 가이드라인 위반입니다.
  • 모든 페이지에 마크업 복사. Product 블록은 상품 페이지에 있어야 하며, 홈페이지나 블로그에는 필요 없습니다.
  • 폐지된 기능을 대상으로 만들기. 원하는 리치 결과가 아직 존재하는지 확인하세요.
  • 브라우저에서만 마크업 추가. 사이트가 JavaScript로 모든 것을 렌더링하면 Google이 찾을 수도 있지만, 서버가 보내는 HTML에 JSON-LD를 넣는 것이 더 안정적입니다.
  • 테스트하지 않기. 쉼표 하나만 빠져도 블록 전체를 읽을 수 없게 됩니다.

AI 빌더에 요청할 내용

  • “각 페이지에 맞는 schema.org 타입으로 JSON-LD 구조화된 데이터를 추가해줘. 상품 페이지에는 Product, 연락처 페이지에는 LocalBusiness, 블로그 글에는 Article을 사용해줘.”
  • “페이지에 표시되는 것과 같은 데이터에서 값을 생성해서 항상 일치하도록 해줘.”
  • “리뷰, 평점, 또는 페이지에 보이지 않는 속성은 추가하지 마.”
  • “JSON-LD를 서버에서 렌더링되거나 미리 렌더링된 HTML에 넣어줘.”
  • “해당 타입의 Google 리치 결과에 필요한 모든 속성을 포함하고, 사용한 속성을 알려줘.”
  • “리치 결과 테스트에서 확인할 URL 목록을 줘.”

이것이 전체 그림에서 어디에 속하는지는 SEO란 무엇인가, 사이트맵이란 무엇인가, 그리고 AI로 만든 웹사이트를 위한 SEO의 기술 가이드에서 확인할 수 있습니다.

Mythex의 구조화된 데이터

Mythex는 구조화된 데이터를 자동으로 추가하지 않습니다. 채팅에서 요청하면 에이전트가 앱 코드에 작성합니다. 어떤 페이지가 제품, 이벤트 또는 비즈니스를 나타내는지 알려주고, 페이지에 표시된 것과 같은 데이터에서 JSON-LD를 생성해달라고 요청하세요. 게시된 앱의 SEO 문서에는 “가짜 리뷰 스키마를 만들지 마세요(Do not invent fake review schema)”라는 문구가 포함되어 있는데, 어떤 프롬프트에든 넣어둘 좋은 조언입니다. 기본 설정은 클라이언트에서 렌더링되는 단일 페이지 앱이므로, 검색이 중요하다면 미리 렌더링되거나 정적 구조를 친화적으로 요청한 뒤 게시하고 라이브 URL을 테스트하세요.

자주 묻는 질문

구조화된 데이터란 간단히 무엇인가요?

구조화된 데이터는 웹 페이지에 있는 작은 코드 블록으로, “이것은 제품이고, 가격은 24달러이며, 재고가 있다”처럼 페이지가 무엇에 관한 것인지 표준 형식으로 표시합니다. 검색엔진이 페이지를 이해하도록 돕고, 더 풍부한 검색 결과에 노출될 자격을 얻게 해줄 수 있습니다.

구조화된 데이터가 순위를 올려주나요?

Google은 구조화된 데이터를 무엇이든 보장하는 수단이 아니라, 페이지를 이해하고 리치 결과에 노출될 자격을 갖추게 하는 방법이라고 설명합니다. 실제 가치는 자격을 갖춘 페이지가 검색 결과에 가격이나 별점 같은 추가 정보를 보여줄 수 있다는 점입니다.

JSON-LD란 무엇인가요?

JSON-LD는 페이지 안의 script 태그에 JSON 블록으로 구조화된 데이터를 작성하는 형식입니다. 보이는 HTML과 분리되어 있고 생성하고 관리하기 쉬워서 Google이 권장합니다.

schema.org란 무엇인가요?

schema.org는 Product, Event, LocalBusiness, name, price 같은 타입과 속성의 공용 어휘집으로, 검색엔진이 이해합니다. 구조화된 데이터는 schema.org 용어를 사용해 사물을 설명합니다.

구조화된 데이터는 어떻게 테스트하나요?

Google의 리치 결과 테스트(Rich Results Test)로 페이지가 Google 리치 결과 대상인지 확인하고, 스키마 마크업 유효성 검사기(Schema Markup Validator)로 일반적인 schema.org 기준에 맞는지 점검하세요. 출시 후에는 Search Console 보고서에서 실제 페이지의 오류를 확인할 수 있습니다.

Mythex · Pricing · AI로 무엇이든 만들기 · 웹사이트 및 앱 템플릿 · Mythex 비교 · AI 앱 개발 용어집 · 무료 AI 앱 개발 도구 · English

English አማርኛ العربية Български বাংলা Bosanski Català Čeština Dansk Deutsch Ελληνικά Español Español (España) Eesti فارسی Suomi Français Français (Canada) ગુજરાતી हिन्दी Hrvatski Magyar Հայերեն Bahasa Indonesia Íslenska Italiano 日本語 ქართული Қазақ тілі ಕನ್ನಡ Lietuvių Latviešu Македонски മലയാളം Монгол मराठी Bahasa Melayu မြန်မာ Norsk bokmål Nederlands ਪੰਜਾਬੀ Polski Português (Brasil) Português (Portugal) Română Русский Slovenčina Slovenščina Soomaali Shqip Srpski Svenska Kiswahili தமிழ் తెలుగు ไทย Tagalog Türkçe Українська اردو Tiếng Việt 简体中文 繁體中文(香港) 繁體中文(台灣)