🏆 Discourse Rich JSON-LD Microdata プラグイン

kaktak · 2025 年 11 月 11 日午後 6:56

Discourse 強化版 JSON-LD マイクロデータ


	概要	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 をご覧ください。

リッチ検索結果の例

Before: Google 内のプレーンテキストスニペット
After: 評価、回答数、著者、公開日が含まれるリッチスニペット

Before: ソーシャルメディア上の一般的なリンクプレビュー
After: 画像、説明、ブランディングを備えた目を引くカード

Google 検索セントラルのリッチ結果について詳しく学ぶ

主な機能

1. 完全な Schema.org カバレッジ

完全な Q&A 階層を持つトピック用の QAPage スキーマ
回答の評価と解決済みステータスのサポート
サブカテゴリを持つカテゴリ用の CollectionPage
専門性インジケーター付きユーザープロフィール用の ProfilePage
ナビゲーションパス用の BreadcrumbList
検索アクション付きのグローバルスキーマ WebSite

2. 連携したソーシャルメディアタグ

Open Graph（Facebook、LinkedIn、Discord）
Twitter Cards（summary_large_image）
すべて 単一の真実源から生成され、競合なし
Discourse のデフォルトタグの自動クリーンアップ

3. AI および LLM 最適化

Schema.org の @id 参照を使用した完全なエンティティ関係
完全なコンテキスト理解（トピック → カテゴリ → 回答 → コメント）
著者の専門性メタデータ
ChatGPT、Claude、その他の AI アシスタントが完璧なコンテキストを取得

4. 完全な国際化

英語とロシア語の 100% 翻訳が含まれています
自動言語検出（ユーザー → サイト → ブラウザ → フォールバック）
すべてローカライズされた Schema.org 説明
言語の追加が容易

5. スマートなパフォーマンス

1 時間の TTL（設定可能）を備えた Redis キャッシュ
コンテンツ変更時の自動キャッシュ無効化
キャッシュ済みページの場合 < 5ms
新規生成の場合 ~50ms

6. メンテナンスフリー

ブラウザとクローラービューの両方への自動注入
トピック、カテゴリ、ユーザープロフィールで動作
優雅なエラーハンドリング - サイトを破損させることはありません
デバッグのための包括的なログ記録

フォーラムへのメリット

検索ランキングの向上

Google のリッチスニペットにより、クリック率が 30〜50% 向上
専門家ユーザー向けのナレッジグラフパネル
「人々も尋ねる」セクションへの掲載
検索結果内のパンくずリストによりナビゲーションが改善

プロフェッショナルなソーシャル共有

Facebook、Twitter、LinkedIn で共有された際の目を引くカード
ロゴと説明による適切なブランディング
エンゲージメントとクリック率の向上
40 以上のソーシャルプラットフォームで動作

AI アシスタント対応

ChatGPT や Claude の回答に正確にコンテンツが表示
フォーラムへのリンク付きの適切な帰属表示
完全なコンテキストにより AI の幻覚を防止
生成エンジン最適化（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 プロトコル
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": "データベースクエリの最適化方法は？",
  "mainEntity": {
    "@type": "Question",
    "name": "データベースクエリの最適化方法は？",
    "text": "クエリが遅いと感じています...",
    "answerCount": 5,
    "upvoteCount": 12,
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "インデックスを追加すべきです...",
      "upvoteCount": 8,
      "author": {
        "@type": "Person",
        "name": "John Doe",
        "url": "https://forum.example.com/u/john"
      }
    }
  }
}

カテゴリページマークアップ:

{
  "@context": "https://schema.org",
  "@type": "CollectionPage",
  "name": "データベース最適化",
  "description": "高速なクエリのためのヒントとコツ",
  "numberOfItems": 245,
  "hasPart": [...]
}

完全な例については、USAGE.md をご覧ください。

使用ケース

技術フォーラム:
開発者が Google の featured スニペットや AI コーディングアシスタントを通じてあなたの解決策を見つけ、適切なコードコンテキストが保持されます。

サポートコミュニティ:
検索エンジンが評価と解決済みステータス付きの回答を表示し、質の高いトラフィックを最高のコンテンツへ誘導します。

ディスカッションフォーラム:
カスタムカードによりソーシャルメディア共有がプロフェッショナルに見え、エンゲージメントの向上と離脱率の低下につながります。

国際コミュニティ:
自動言語検出により、ユーザーが好みの言語でコンテンツを表示でき、アクセシビリティが向上します。

メンテナンス

メンテナンスフリーの運用:

コンテンツ更新時の自動キャッシュ更新
エラー時の自己修復（サイトを破損させることはありません）
監視のための包括的なログ記録
トラブルシューティングのためのオプションのデバッグモード

キャッシュ管理（オプション）:

# Rails console
MetaGeneratorService.clear_all_cache
MetaGeneratorService.cache_stats

トラブルシューティング

メタタグが表示されない場合:

管理 → プラグインでプラグインが有効であることを確認
ログを確認：./launcher logs app | grep RichMicrodata
キャッシュをクリア：MetaGeneratorService.clear_all_cache

Google でリッチスニペットが表示されない場合:

Google が再クロールして更新するには 2〜4 週間かかることがあります
リッチ結果テストでテスト
検索コンソールで検証エラーを確認

詳細なトラブルシューティングについては、USAGE.md をご覧ください。

パフォーマンス指標

キャッシュヒット率: 一般的なフォーラムで 95% 以上
応答時間: キャッシュ済み < 5ms、新規 ~50ms
メモリオーバーヘッド: 最小限（Redis を使用）
データベース負荷: 無視できるレベル（1 時間キャッシュ）

ロードマップ

現在のバージョン：2.0.0

完全な Open Graph と Twitter Cards
完全な Schema.org JSON-LD サポート
英語/ロシア語のローカライゼーション
国際文字の URL エンコーディング

予定:

追加言語パック（スペイン語、ドイツ語、フランス語）
ビデオスキーマサポート
告知用のイベントスキーマ
マーケットプレイスコテゴリ用のプロダクトスキーマ

サポート

課題: GitHub Issues
ドキュメント: README.md
貢献: CONTRIBUTING.md

ライセンス

MIT ライセンス - 無料のオープンソースソフトウェア

クレジット

標準: Schema.org、Open Graph プロトコル、Twitter Cards
プラットフォーム: Discourse
コミュニティ: すべての貢献者とユーザー

オプション：Telegram インスタントビュー

リポジトリには、美しい Telegram インスタントビューテンプレートを作成するためのサンプルテンプレートルールが TELEGRAM_IV_RULES.txt に含まれています。これらのルールを instantview.telegram.org で使用すると、Telegram でフォーラムのコンテンツを共有するユーザーのために、高速読み込みで気が散らない読書体験を提供できます。

**今日、フォーラムの可視性を革新しましょう。**5 分未満でインストールし、2〜4 週間以内に Google で結果を確認できます。

patrickemin · 2025 年 11 月 11 日午後 8:29

こんにちは。フランス語の言語パックがまだ準備できていない状況でも、フランス語のDiscourseサイトでこのプラグインを使用することを勧めますか？ありがとうございます。

kaktak · 2025 年 11 月 11 日午後 8:41

こんにちは。このプラグインはユーザーエクスペリエンスに影響を与えません。メインの言語設定はDiscourseの設定から取得されます。フォーラムが多言語の場合は、管理セクションで代替言語を指定することもできます。はい、問題なくお使いいただけます。翻訳は管理セクションでプラグインを管理するためにのみ使用されます。英語またはロシア語が分かれば管理できます。

patrickemin · 2025 年 11 月 17 日午後 9:44

皆さん、こんにちは。このプラグインは問題なくインストールできました。セットアップは非常に簡単で、すぐに動作しました。マイクロデータから何が出てくるかテストしたところ、すべて問題ないようです。

Ivan_Rapekas · 2025 年 11 月 17 日午後 10:58

すごい、とても興味深いですね！

著者は、\u003chttps://github.com/kaktaknet/discourse-rich-json-ld-microdata/blob/main/USAGE.md\u003e でベストプラクティスを提供しています。

ベストプラクティス

トピックには常に高品質な画像（1200x630px）を使用する

詳細なトピックタイトルを作成する（Schema.orgのnameフィールドに役立ちます）

Solvedプラグインを有効にして、より良いacceptedAnswer検出を実現する

説明的なカテゴリ説明を使用する

ユーザーにプロフィールを記入するように促す（Personスキーマを改善します）

キャッシュヒット率を監視する（95%以上を目指す）

デプロイ後にキャッシュをウォームアップする

主要なリリース前にバリデーターでマークアップをテストする

Readme

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

Discourseコミュニティのために❤️で作られました

本当です。私が今まで見た中で最も美しいMarkdownドキュメントです！

kaktak · 2025 年 11 月 17 日午後 11:17

ありがとうございます。このプラグインは、一般ユーザーにはフォーラムへの目に見える影響はありませんが、検索エンジンからの訪問者を増やしたり、音声アシスタントを支援したりするのに役立ちますが、実装は簡単な作業ではありませんでした。しかし、なんとか完了しました。

David_Ghost · 2025 年 11 月 22 日午前 8:01

素晴らしいプラグインです！あなたの仕事に感謝します。インストールしようとしていますが、「data-rich-microdata」を取得できません。

すでに「MetaGeneratorService.clear_all_cache」を試しました。
discourse(prod) > MetaGeneratorService.clear_all_cache => []
そして、「tail -f log/production.log | grep RichMicrodata」は以下を返します。

[RichMicrodata] トピック 14092 のために生成されました、クローラー: true、head サイズ: 5855
[RichMicrodata] HTML を返しています (5855 文字)、クローラー: true
[RichMicrodata] TopicsController のために HTML ビルダー (server:before-head-close-crawler) が開始されました
[RichMicrodata] トピック 22861 のために生成中
[RichMicrodata::Coordinator] TwitterCardBuilder でエラー: DiscourseRichMicrodata::Builders::TwitterCardBuilder のインスタンスに対して undefined local variable or method `twitter_image’
[RichMicrodata] トピック 22861 のために生成されました、クローラー: true、head サイズ: 6815
[RichMicrodata] HTML を返しています (6815 文字)、クローラー: true
[RichMicrodata] TopicsController のために HTML ビルダー (server:before-head-close-crawler) が開始されました

kaktak · 2025 年 11 月 22 日午前 8:38

フォーラム投稿へのリンクをこちらに提供してください https://search.google.com/test/rich-results

David_Ghost · 2025 年 11 月 22 日午前 11:44

素晴らしい。しかし、このTwitterの画像に関連するすべてのエラーを修正する方法はありますか？

Screenshot_20251122_124238_Brave

kaktak · 2025 年 11 月 22 日午前 11:48

確認してみます。どうやら画像プラグインが必要なようです。その点を見落としていました。修正します。

kaktak · 2025 年 11 月 23 日午後 7:15

更新されました、チェックしてください

DevTeVe · 2025 年 12 月 4 日午前 8:37

こんにちは！奇妙なケースを共有したいだけです。私たちのフォーラムでは、ユーザーの「名前」を設定することを実際には強制していないため、Googleがインデックスを作成しようとすると、次のように不満を述べます。

フィールド「name」（「author」内）がありません

この問題のあるアイテムは無効です。無効なアイテムはGoogle検索のリッチリザルトの対象外です

ユーザー名を名前として伝える方法はありますか？

kaktak · 2025 年 12 月 4 日午前 8:44

標準のフォーラムおよびテーマ設定にはそのような問題はありません。カスタムのフォーラムまたはテーマ設定がある場合は、ご自身でご確認ください。

DevTeVe · 2025 年 12 月 4 日午前 8:49

差し支えなければお伺いしますが、「標準フォーラム」とは何でしょうか？テーマ設定は問題ないはずです。Horizonでもテストしましたが、問題は生成された「名前」が入力されないことでした（なぜなら、私たちはそれを入力することを必須としていないためです）。

ただし、これは「ディスカッション」モードに設定されています。他のモードも試してみます。

編集:

一部のトピックでは「名前」が入力されていますが、他のトピックでは入力されていません。特定の「名前」を設定していない同じユーザーであってもです。

この投稿では、投稿者の「名前」が表示されています: Text for 2FA on Comma - #3 by Devtekve - sunnypilot - sunnypilot Community
このトピックでは表示されていません: Changelog: sunnypilot - Announcements - sunnypilot Community

また、おそらく無関係ですが、microdataとロケールZNに関するエラーがいくつか見られます。

toanvoc · 2026 年 1 月 27 日午前 3:17

こんにちは、このプラグインをインストールしました。添付の画像（Screenshot by Lightshot

トピック		返信	表示
Discourse AI Plugin included-in-core , ai , official	93	41350	2026 年 1 月 21 日
🤖 Discourse llms.txt Generator Plugin Plugin ai	4	453	2026 年 4 月 11 日
Google Structured Data -- Invalid Article Schema Support	44	8892	2018 年 11 月 9 日
Discourse AI Topic Summary :robot: Plugin ai	161	9246	2025 年 7 月 18 日
Discussion Forum Schema improvements Support	34	3690	2025 年 1 月 23 日