반복되는 JSON-LD 실수를 보고 무료 FAQ 스키마 생성기를 만들었습니다

AI 요약

오래된 WordPress 게시물을 점검하면서 작성자는 쉼표 누락, 잘못된 필드를 복사한 템플릿, 페이지에 보이는 내용과 다른 FAQ 마크업, 실제 FAQ가 아닌 콘텐츠에 붙인 유효한 JSON-LD를 반복해서 발견했습니다. 문제는 코드보다 작업 흐름에 있다고 보고, 질문과 답변을 입력해 FAQPage JSON-LD를 만들고 WordPress나 정적 사이트에 복사할 수 있는 무료 생성기를 만들었습니다. 모든 스키마 유형을 넣는 대신 FAQ에만 범위를 좁혔습니다.

검증보다 중요한 일치 여부

JSON-LD 문법이 유효해도 페이지 내용과 맞지 않으면 오해를 부를 수 있습니다. 화면에 보이는 FAQ와 구조화 데이터가 같은 내용을 담아야 하며, 숨기거나 지어낸 내용을 생성기가 부추겨서는 안 된다고 설명합니다. 검색 순위를 올리는 장치로도 제시하지 않습니다. Google이 FAQ 리치 결과를 선택적으로 보여주므로, 생성기의 목적은 기계가 읽을 수 있는 콘텐츠를 명확히 만들고 검색 결과 기능을 사용할 자격을 갖추는 데 있다고 설명합니다.

작성자는 빈 질문과 잘못된 출력을 막는 보호 장치가 설정을 많이 추가하는 것보다 실용적이라고 말합니다. FAQPage 마크업이 적절한 경우와 그렇지 않은 경우를 안내하고, 생성 결과를 Google Rich Results Test와 Schema.org Validator에서 확인하도록 권합니다.

Indie Hackers 반응

• @Ismail Khan — 잘했어요, Kamran.
• @jesse + jamie — 질문에 직접 답하자면, 작업 흐름에 자리 잡게 해줄 기능은 내보내기가 아니라 변경 사항 감지입니다. 저희는 실제 FAQ 페이지를 운영하고 가격 단계와 기능이 바뀔 때마다 내용을 수정합니다. JSON-LD는 그 변경을 알지 못합니다. 누군가 Search Console에서 알아차릴 때까지 조용히 오래된 상태로 남습니다. 마크업을 더 깔끔하게 생성하는 것보다 실시간 페이지의 표시 문구와 다시 대조해 서로 달라졌을 때 알려주는 기능이 필요합니다. 페이지와 마크업이 맞지 않는다는 작성자가 언급한 실수를 감사 과정이 아니라 자동으로 잡아내는 방식입니다.
• @alxmrgn — 좋은 아이디어네요. 먼저 이 도구를 쓸 사람을 누구라고 생각하는지 묻고 싶습니다. 그걸 적어두면 많은 것이 달라질 수 있습니다.
• @James Cummings — 범위를 좁히고 무료로 만드는 방향이 맞습니다. FAQ가 아닌 콘텐츠에 유효한 JSON-LD를 붙이는 실수도 저도 자주 봅니다. 도구에 쉬운 말로 안내할 내용이 하나 있습니다. 제가 알기로 Google은 대부분 사이트에서 펼쳐지는 FAQ 결과 표시를 중단했고, 일부 공식 보건 및 정부 사이트에만 남겼습니다. 그러니 지금 마크업을 넣는 주된 이유는 검색 결과를 더 크게 만드는 게 아니라 검색 엔진과 AI 어시스턴트가 내용을 명확히 이해하도록 돕는 것입니다. 이를 미리 알리면 나타나지 않을 결과를 기대하지 않게 됩니다. 또 마크업 속 질문이 페이지에 보이는 질문과 같은지도 확인해야 합니다. 둘이 다를 때 경고만 해도 대부분의 문제를 잡을 수 있습니다. 저는 SEO 도구 UtilitySEO를 만들고 있습니다. 생성기는 이 두 가지 중 하나라도 경고하나요?
• @MarkBuilder Marketplace — 정말 유용한 도구네요! 랜딩 페이지를 만들 때 Google Rich Results Test에서 JSON-LD 문법을 직접 확인하는 일은 늘 번거롭습니다. 중첩된 Question/Answer 엔티티도 지원하나요? 잘 만들었네요!

원문: Indie Hackers / 번역·요약: Trawling