🏆 Discourse Rich JSON-LD 마이크로데이터 플러그인

kaktak · 11월 11, 2025, 6:56오후

Discourse Rich JSON-LD Microdata


	요약	Discourse의 표준 메타 태그를 포괄적이고 조율된 Open Graph, Twitter Cards, Schema.org JSON-LD 마크업 세트로 강화하여 우수한 SEO 성능, 더 풍부한 소셜 미디어 공유 경험, 그리고 개선된 AI/LLM 검색 가능성을 제공합니다
	저장소 링크	GitHub - kaktaknet/discourse-rich-json-ld-microdata: 🏆 Discourse Rich JSON-LD Microdata Plugin. Comprehensive, coordinated Open Graph and Schema.org JSON-LD microdata for 200% SEO and LLM coverage · GitHub
	설치 가이드	Discourse에서 플러그인 설치 방법

제공되는 기능

포럼이 검색 결과, 소셜 미디어, AI 기반 어시스턴트에서 어떻게 보이는지 변형하세요. 이 플러그인은 Google, Yandex, 소셜 플랫폼, 그리고 대규모 언어 모델(LLM)이 완벽하게 이해할 수 있는 전문 등급의 구조화 데이터를 생성합니다.

상세한 문서는 README.md를 참조하세요.

기술적 세부 사항 및 개발은 CONTRIBUTING.md를 참조하세요.

사용 예시 및 문제 해결은 USAGE.md를 참조하세요.

풍부한 검색 결과 예시

이전: Google의 일반 텍스트 스니펫
이후: 평점, 답변 수, 작성자, 게시 날짜가 포함된 풍부한 스니펫

이전: 소셜 미디어의 일반 링크 미리보기
이후: 이미지, 설명, 브랜딩이 포함된 눈길을 끄는 카드

Google Search Central의 풍부한 결과에 대해 자세히 알아보기

주요 기능

1. 완전한 Schema.org 커버리지

전체 Q&A 계층 구조를 갖춘 토픽용 QAPage 스키마
답변 평점 및 해결 상태 지원
하위 카테고리를 갖춘 카테고리용 CollectionPage
전문성 지표를 갖춘 사용자 프로필용 ProfilePage
내비게이션 경로를 위한 BreadcrumbList
검색 동작을 갖춘 WebSite 글로벌 스키마

2. 조율된 소셜 미디어 태그

Open Graph (Facebook, LinkedIn, Discord)
Twitter Cards (summary_large_image)
**단일 진실 소스(Single Source of Truth)**에서 모두 생성 - 충돌 없음
Discourse의 기본 태그 자동 정리

3. AI 및 LLM 최적화

Schema.org @id 참조를 사용한 완전한 엔터티 관계
전체 컨텍스트 이해 (토픽 → 카테고리 → 답변 → 댓글)
작성자 전문성 메타데이터
ChatGPT, Claude 및 기타 AI 어시스턴트가 완벽한 컨텍스트를 얻습니다

4. 완전한 국제화

영어 및 러시아어 번역 100% 포함
자동 언어 감지 (사용자 → 사이트 → 브라우저 → 폴백)
모든 Schema.org 설명 현지화
추가 언어 추가 용이

5. 스마트 성능

1시간 TTL(구성 가능)을 갖춘 Redis 캐싱
콘텐츠 변경 시 자동 캐시 무효화
캐시된 페이지는 5ms 미만
새로 생성하는 경우 약 50ms

6. 제로 유지보수

브라우저 및 크롤러 뷰 모두에 대한 자동 주입
토픽, 카테고리, 사용자 프로필에서 작동
우아한 오류 처리 - 사이트가 절대 깨지지 않음
디버깅을 위한 포괄적인 로깅

포럼에 대한 이점

더 나은 검색 순위

Google의 풍부한 스니펫은 클릭률(CTR)을 30-50% 증가시킵니다
전문가 사용자를 위한 지식 그래프 패널
“사람들이 또한 묻는 것” 섹션에 특징적으로 노출
검색 결과의 브레드크럼은 내비게이션을 개선합니다

전문적인 소셜 공유

Facebook, Twitter, LinkedIn에서 공유 시 눈길을 끄는 카드
로고와 설명을 통한 적절한 브랜딩
증가된 참여도 및 클릭률
40개 이상의 소셜 플랫폼에서 작동

AI 어시스턴트 준비 완료

콘텐츠가 ChatGPT와 Claude 응답에 정확하게 표시됩니다
포럼으로의 링크를 통한 적절한 출처 표시
완전한 컨텍스트는 AI 환각(Hallucination)을 방지합니다
생성형 엔진 최적화(GEO)를 위한 미래 대비

국제적 독자층

자동 언어 감지
더 나은 관련성을 위한 현지화된 설명
URL 인코딩은 키릴 문자 및 특수 문자를 처리합니다
더 많은 언어로 확장하기 쉬움

설치

단계 1: 설치

위 저장소 링크를 사용하여 Install plugins on a self-hosted site 을 따르세요

단계 2: 관리자에서 활성화

관리자 → 설정 → 플러그인 → Rich Microdata 로 이동하세요

rich_microdata_enabled를 true(기본값)로 설정하세요

단계 3: 구성 (선택 사항)

모든 설정은 기본적으로 잘 작동하지만, 다음과 같이 사용자 정의할 수 있습니다:

캐시 지속 시간 (기본값: 1시간)
포함할 최대 답변 수 (기본값: 10)
사이트의 Twitter @핸들
기본 Open Graph 이미지 URL
특정 스키마 활성화/비활성화

단계 4: 검증

마크업을 테스트하세요:

구성

설정	기본값	설명
`rich_microdata_enabled`	`true`	플러그인의 마스터 스위치
`rich_microdata_cache_ttl`	`3600`	캐시 지속 시간 (초)
`rich_microdata_max_answers`	`10`	QAPage 스키마의 최대 답변 수
`rich_microdata_include_user_stats`	`true`	사용자 통계 포함
`rich_microdata_enable_breadcrumbs`	`true`	BreadcrumbList 스키마 추가
`rich_microdata_enable_website_schema`	`true`	WebSite 스키마 포함
`rich_microdata_twitter_site`	`""`	Twitter @사용자 이름
`rich_microdata_og_image_default`	`""`	폴백 OG 이미지 URL
`rich_microdata_debug_mode`	`false`	디버그 로깅 활성화

기술적 세부 사항

아키텍처:

3층 패턴: DataExtractor → Builders → Coordinator
단일 진실 소스는 데이터 충돌을 방지합니다
<head> 태그와 <body> 콘텐츠에 대한 별도 렌더링
application.html.erb 및 crawler.html.erb 레이아웃 모두와 작동

표준 준수:

Schema.org JSON-LD 사양
Open Graph Protocol
Twitter Cards 마크업
RFC 3986 (국제 문자를 위한 URL 인코딩)

보안:

Guardian 권한 확인
비공개 콘텐츠 자동 제외
SQL 수준 보안 필터링
누락된 데이터에 대한 안전한 폴백

호환성:

Discourse 2.7.0+
Ruby 2.7+
Discourse 3.6.0.beta3에서 테스트됨

실제 사용 예시

토픽 페이지 마크업:

{
  "@context": "https://schema.org",
  "@type": "QAPage",
  "name": "How to optimize database queries?",
  "mainEntity": {
    "@type": "Question",
    "name": "How to optimize database queries?",
    "text": "I'm experiencing slow queries...",
    "answerCount": 5,
    "upvoteCount": 12,
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "You should add indexes on...",
      "upvoteCount": 8,
      "author": {
        "@type": "Person",
        "name": "John Doe",
        "url": "https://forum.example.com/u/john"
      }
    }
  }
}

카테고리 페이지 마크업:

{
  "@context": "https://schema.org",
  "@type": "CollectionPage",
  "name": "Database Optimization",
  "description": "Tips and tricks for faster queries",
  "numberOfItems": 245,
  "hasPart": [...]
}

완전한 예시는 USAGE.md를 참조하세요.

사용 사례

기술 포럼:
개발자들은 Google의 특징 스니펫과 AI 코딩 어시스턴트를 통해 솔루션을 찾으며, 적절한 코드 컨텍스트가 유지됩니다.

지원 커뮤니티:
검색 엔진은 평점과 해결 상태가 포함된 답변을 표시하여 가장 좋은 콘텐츠로 유입되는 트래픽을 유도합니다.

토론 포럼:
커스텀 카드를 통한 소셜 미디어 공유가 전문적으로 보이며, 참여도를 높이고 이탈률을 줄입니다.

국제 커뮤니티:
자동 언어 감지는 사용자가 선호하는 언어로 콘텐츠를 볼 수 있도록 하여 접근성을 개선합니다.

유지보수

제로 유지보수 운영:

콘텐츠 업데이트 시 자동 캐시 새로 고침
오류 시 자가 치유 (사이트가 절대 깨지지 않음)
모니터링을 위한 포괄적인 로깅
문제 해결을 위한 선택적 디버그 모드

캐시 관리 (선택 사항):

# Rails console
MetaGeneratorService.clear_all_cache
MetaGeneratorService.cache_stats

문제 해결

메타 태그가 표시되지 않는 경우:

관리자 → 플러그인에서 플러그인이 활성화되었는지 확인
로그 확인: ./launcher logs app | grep RichMicrodata
캐시 정리: MetaGeneratorService.clear_all_cache

Google에서 풍부한 스니펫이 표시되지 않는 경우:

Google은 재크롤링 및 업데이트에 2-4주가 걸립니다
Rich Results Test로 테스트
Search Console에서 검증 오류 확인

상세한 문제 해결은 USAGE.md를 참조하세요.

성능 지표

캐시 히트율: 일반 포럼의 경우 95% 이상
응답 시간: 캐시된 경우 5ms 미만, 새로 생성하는 경우 약 50ms
메모리 오버헤드: 최소 (Redis 사용)
데이터베이스 부하: 무시할 수준 (1시간 캐시)

로드맵

현재 버전: 2.0.0

완전한 Open Graph 및 Twitter Cards
완전한 Schema.org JSON-LD 지원
EN/RU 현지화
국제 문자를 위한 URL 인코딩

계획:

추가 언어 팩 (ES, DE, FR)
비디오 스키마 지원
공지 사항을 위한 이벤트 스키마
마켓플레이스 카테고리를 위한 제품 스키마

지원

이슈: GitHub Issues
문서: README.md
기여: CONTRIBUTING.md

라이선스

MIT License - 무료 및 오픈 소스 소프트웨어

크레딧

표준: Schema.org, Open Graph Protocol, Twitter Cards
플랫폼: Discourse
커뮤니티: 모든 기여자 및 사용자

선택 사항: Telegram Instant View

저장소에는 TELEGRAM_IV_RULES.txt에 예제 템플릿 규칙이 포함되어 있어 아름다운 Telegram Instant View 템플릿을 만들 수 있습니다. 포럼 콘텐츠를 Telegram에서 공유하는 사용자에게 빠르고 방해 없는 읽기 경험을 제공하려면 instantview.telegram.org에서 이 규칙을 사용하세요.

오늘 바로 포럼의 가시성을 변형하세요. 5분 이내에 설치하고, 2-4주 이내에 Google에서 결과를 확인하세요.

patrickemin · 11월 11, 2025, 8:29오후

안녕하세요, 프랑스어 언어 팩이 아직 준비되지 않았지만, 프랑스어 Discourse 사이트에서 이 플러그인을 사용하는 것을 권장하시나요? 감사합니다.

kaktak · 11월 11, 2025, 8:41오후

안녕하세요. 이 플러그인은 사용자 경험에 어떤 영향도 미치지 않습니다. 주요 언어 설정은 Discourse 설정에서 가져옵니다. 포럼이 다국어인 경우, 관리자 섹션에서 대안 언어를 지정할 수도 있습니다. 네, 자유롭게 사용하셔도 됩니다. 문제가 발생하지 않습니다. 번역은 관리자 섹션에서 플러그인을 관리하는 데만 사용됩니다. 영어나 러시아어를 이해하신다면 관리할 수 있습니다.

patrickemin · 11월 17, 2025, 9:44오후

여러분 안녕하세요, 이 플러그인을 아무 문제 없이 설치했습니다. 설정이 매우 간단해서 바로 작동했습니다. 마이크로데이터에서 어떤 결과가 나오는지를 확인하기 위해 테스트를 해봤는데, 제 생각에는 모든 것이 정상적으로 작동하는 것 같습니다.

Ivan_Rapekas · 11월 17, 2025, 10:58오후

와, 정말 흥미롭네요!

저자는 https://github.com/kaktaknet/discourse-rich-json-ld-microdata/blob/main/USAGE.md에서 모범 사례를 제공합니다.

모범 사례

주제(토픽)에는 항상 고품질 이미지(1200x630px)를 사용하세요

상세한 주제 제목을 작성하세요 (Schema.org의 name 필드에 도움이 됩니다)

더 나은 acceptedAnswer 감지를 위해 Solved 플러그인을 활성화하세요

설명적인 카테고리 설명을 사용하세요

사용자들이 자기소개를 작성하도록 장려하세요 (Person 스키마 개선에 도움이 됩니다)

캐시 히트율을 모니터링하세요 (95% 이상을 목표로 하세요)

배포 후 캐시를 미리 채워두세요 (Warm up)

주요 릴리스 전에 검증기를 사용하여 마크업을 테스트하세요

Readme

https://github.com/kaktaknet/discourse-rich-json-ld-microdata/blob/main/README.md

Discourse 커뮤니티를 위해 와 함께 제작되었습니다

사실입니다. 제가 본 것 중 가장 아름다운 마크다운 문서입니다 !

kaktak · 11월 17, 2025, 11:17오후

감사합니다. 이 플러그인은 일반 사용자들에게 눈에 띄는 효과가 없고, 검색 엔진에서 더 많은 방문자를 유치하고 음성 어시스턴트를 지원하는 데만 사용되지만, 구현하는 과정은 그리 간단하지 않았습니다. 그래도 결국 해냈습니다.

David_Ghost · 11월 22, 2025, 8:01오전

좋은 플러그인이네요! 수고 많으셨습니다. 설치하려고 하는데 "data-rich-microdata"를 가져올 수 없어요.

이미 "MetaGeneratorService.clear_all_cache"를 테스트해 보았어요:
discourse(prod)> MetaGeneratorService.clear_all_cache => []
그리고 "tail -f log/production.log | grep RichMicrodata"를 실행하면 다음과 같은 결과가 나옵니다:

[RichMicrodata] Generated for topic 14092, crawler: true, head size: 5855
[RichMicrodata] Returning HTML (5855 chars), crawler: true
[RichMicrodata] HTML builder (server:before-head-close-crawler) started for TopicsController
[RichMicrodata] Generating for topic 22861
[RichMicrodata::Coordinator] ERROR in TwitterCardBuilder: undefined local variable or method `twitter_image’ for an instance of DiscourseRichMicrodata::Builders::TwitterCardBuilder
[RichMicrodata] Generated for topic 22861, crawler: true, head size: 6815
[RichMicrodata] Returning HTML (6815 chars), crawler: true
[RichMicrodata] HTML builder (server:before-head-close-crawler) started for TopicsController

kaktak · 11월 22, 2025, 8:38오전

게시판 게시물에 대한 링크를 제공해 주십시오 https://search.google.com/test/rich-results

David_Ghost · 11월 22, 2025, 11:44오전

좋네요. 하지만 트위터 이미지와 관련된 이 모든 오류를 수정할 방법이 있을까요?

kaktak · 11월 22, 2025, 11:48오전

확인해 보겠습니다.Apparently, 이미지 플러그인이 필요합니다. 그 점을 놓치고 있었네요. 수정하겠습니다.

kaktak · 11월 23, 2025, 7:15오후

업데이트했으니 확인해 보세요

DevTeVe · 12월 4, 2025, 8:37오전

안녕하세요! 좀 특이한 사례를 공유하고 싶어서요. 저희 포럼에서는 사용자의 “이름” 설정을 의무적으로 강제하지 않기 때문에, 구글이 인덱싱을 시도할 때 다음과 같은 오류가 발생합니다:

필드 “name” 누락 (“author” 내)

이 문제가 있는 항목은 유효하지 않습니다. 유효하지 않은 항목은 Google Search의 풍부한 결과(Rich Results) 대상에서 제외됩니다

사용자 이름을 이름으로 지정할 수 있는 방법이 있는지 잘 모르겠습니다.

kaktak · 12월 4, 2025, 8:44오전

표준 게시판 및 테마 설정에는 해당 문제가 없습니다. 사용자 정의 게시판이나 테마 설정을 사용 중이시라면, 해당 설정을 직접 확인해 주세요.

DevTeVe · 12월 4, 2025, 8:49오전

질문해도 괜찮다면, "standard forum"이란 무엇인가요? 테마 설정은 문제가 되지 않을 것 같습니다. horizon에서도 테스트해 봤는데, 문제는 생성된 "name"이 채워지지 않는다는 점입니다(우리는 이를 필수로 요구하지 않으므로).

다만 현재 “discussion” 모드로 설정되어 있으니, 다른 모드도 시도해 보겠습니다.

수정:

일부 주제에서는 "name"이 채워져 있고, 일부는 그렇지 않습니다. 특정 "name"을 설정하지 않은 동일한 사용자의 경우에도 그렇습니다.

이 게시글에서는 작성자의 "names"가 표시됩니다: Text for 2FA on Comma - #3 by Devtekve - sunnypilot - sunnypilot Community
이 주제에서는 그렇지 않습니다: Changelog: sunnypilot - Announcements - sunnypilot Community

또한, 아마도 관련이 없을 수 있지만 microdata와 로케일 ZN에 대한 몇 가지 오류를 확인했습니다.

toanvoc · 1월 27, 2026, 3:17오전

안녕하세요, 이 플러그인을 설치했습니다. 첨부된 이미지( Screenshot by Lightshot )의 빨간색 하이라이팅을 비활성화하고 싶습니다. 플러그인을 어떻게 설정해야 할까요? 감사합니다!

글		댓글	조회수
🤖 Discourse llms.txt Generator Plugin Plugin ai	4	688	4월 11, 2026
Discourse AI Plugin official , included-in-core , ai	83	44394	1월 21, 2026
Google Structured Data -- Invalid Article Schema Support	39	9177	7월 31, 2018
Discourse AI Topic Summary :robot: Plugin ai	161	11108	7월 18, 2025
Discussion Forum Schema improvements Support	34	4226	1월 23, 2025