AEO WEB TOOL
JSON-LD 검사기
구조화 데이터는 쉼표 하나만 틀려도 블록 전체가 조용히 무시됩니다. 오류 메시지도 나오지 않습니다. 코드를 붙여넣으면 문법 오류 위치, 빠진 필수 속성, 잘못된 날짜·URL 형식을 즉시 찾아 줍니다.
무료 · 가입 불필요브라우저에서 처리유형 20종 점검
코드 붙여넣기
브라우저에서 Ctrl+U(페이지 소스 보기) → 전체 선택 → 복사 → 여기 붙여넣기.
점검 결과
왜 조용히 실패하는 것이 문제인가요?
JSON-LD 의 가장 곤란한 성질은 틀려도 아무 일이 일어나지 않는다는 점입니다. 페이지는 정상적으로 뜨고, 화면에도 변화가 없고, 콘솔에 오류도 찍히지 않습니다. 그저 검색엔진과 AI 가 그 블록을 없는 것으로 취급할 뿐입니다. 그래서 몇 달 동안 구조화 데이터가 하나도 인식되지 않고 있었다는 사실을 나중에야 발견하는 일이 흔합니다.
실무에서 가장 자주 나오는 원인은 다음 네 가지입니다.
- 마지막 항목 뒤의 쉼표 - JavaScript 객체에서는 허용되지만 JSON 에서는 문법 오류입니다.
- 템플릿 변수가 그대로 출력 -
{{title}}같은 값이 치환되지 않은 채 남아 있는 경우입니다. - 따옴표 종류 - 워드나 한글 문서에서 복사하면 곧은 따옴표가 둥근 따옴표로 바뀌어 있습니다.
- 줄바꿈이 포함된 문자열 - 설명문을 여러 줄로 넣으면 이스케이프 없이는 오류가 납니다.
이 도구가 점검하는 항목
| 점검 | 판정 | 근거 |
|---|---|---|
| JSON 문법 | 오류 시 몇 행 몇 열 부근인지 표시 | JSON 파서의 오류 위치 |
| @context 선언 | 없으면 오류 | schema.org 어휘로 해석되려면 필요 |
| @type 선언 | 없으면 오류 | 무엇을 설명하는지 알 수 없음 |
| 필수 속성 | 없으면 오류 | Google 구조화 데이터 문서의 리치 결과 자격 요건 |
| 권장 속성 | 없으면 주의 | 있으면 이해도가 올라가는 항목 |
| 날짜 형식 | ISO 8601 아니면 오류 | schema.org 날짜 표기 규정 · 존재하지 않는 날짜도 오류 |
| URL 형식 | 상대 경로면 주의 | 절대 주소여야 다른 맥락에서도 해석됨 |
| 중첩 구조 | FAQPage·BreadcrumbList·Product offers 내부 확인 | 유형별 필수 하위 속성 |
점검하는 유형은 다음 20가지입니다. 목록에 없는 유형은 문법만 확인하고 "속성 목록 없음"으로 표시합니다 - 모르는 것을 아는 척하지 않기 위해서입니다.
Article, NewsArticle, BlogPosting, FAQPage, QAPage, HowTo, Product, Organization, LocalBusiness, BreadcrumbList, WebSite, WebPage, CollectionPage, Person, Event, Recipe, VideoObject, SoftwareApplication, JobPosting, ItemList
오류를 고친 다음에는
- 문법 오류부터 해결문법이 깨지면 그 블록의 나머지 점검이 의미가 없습니다. 표시된 행·열 부근을 먼저 봅니다.
- 필수 속성 채우기빨간색 "개선" 항목이 리치 결과 자격을 막는 요인입니다. 없는 정보를 지어내지 말고, 페이지에 실제로 있는 값을 넣으세요.
- 페이지에 반영고친 코드를 해당 페이지 <head> 에 넣고 배포합니다.
- 실제 URL 로 재확인Google 리치 결과 테스트와 Search Console 의 구조화 데이터 보고서로 크롤링된 실제 상태를 확인합니다.
- AEO 검사로 전체 확인구조화 데이터 15점이 실제로 어떻게 매겨지는지 확인합니다.
자주 묻는 질문
- Google 리치 결과 테스트와 무엇이 다른가요?
- 보는 범위가 다릅니다. Google 도구는 실제 URL 을 크롤링해 자사 리치 결과 자격을 판정하고, 이 도구는 붙여넣은 코드만 즉시 점검합니다. 아직 배포하지 않은 코드를 미리 확인하거나, 크롤링이 막힌 개발 서버의 마크업을 검사할 때 이 도구가 쓸모 있습니다. 배포 후 최종 확인은 Google 도구로 하는 편을 권합니다.
- “필수 속성”은 누가 정한 기준인가요?
- Google 이 구조화 데이터 문서에서 각 리치 결과의 자격 요건으로 요구하는 항목입니다. schema.org 규격 자체는 대부분의 속성을 강제하지 않으므로, 여기서 "필수"로 표시된 것이 없다고 해서 schema.org 문법 오류는 아닙니다. 다만 그 상태로는 검색 결과에서 리치 결과로 표시될 자격을 얻지 못합니다.
- 날짜 형식이 왜 오류로 잡히나요?
- schema.org 는 날짜 속성에 ISO 8601 표기를 요구합니다.
2026년 9월 24일이나09/24/2026은 기계가 해석할 수 없습니다. 또2026-02-31처럼 형식은 맞지만 존재하지 않는 날짜도 오류로 잡습니다. AEO 검사기 본체가 v4.3.1에서 같은 판정을 적용하도록 고쳤고, 이 도구도 같은 규칙을 씁니다. - HTML 을 통째로 붙여넣어도 되나요?
- 됩니다. 입력에 <script> 태그가 있으면 application/ld+json 타입의 블록만 골라내 각각 검사합니다. 페이지 소스 보기(Ctrl+U)에서 전체를 복사해 붙여넣는 것이 가장 편한 사용법입니다. 블록이 여러 개면 블록별로 결과가 나옵니다.
- @graph 를 써도 인식되나요?
- 인식합니다. @graph 배열 안의 노드를 모두 펼쳐 각각 점검합니다. 배열 형태의 최상위 JSON 도 같은 방식으로 처리합니다. 다만 @context 는 최상위에 한 번 선언돼 있어야 하며, 없으면 schema.org 어휘로 해석되지 않으므로 오류로 표시합니다.