JSON-LDをraw HTMLに直接記述するか、JavaScriptで注入するか?爬蟲が読み取れる信頼構造は、あなたの
# JSON-LDをraw HTMLに直接記述するか、JavaScriptで注入するか?爬蟲が読み取れる信頼構造は、あなたの書き方にある
生成式検索に向けた実務支援の中で、最もよく見られる誤解の一つは、JSON-LDを記述し、schema.orgの規範に従うことで、AIエンジンがコンテンツを読み取れるという認識です。しかし実際には、JSON-LDがJavaScriptで読み込まれている場合、非JS爬虫はその情報を読み取ることができません。これは技術の陳腐化ではなく、信頼構造の基礎となる点:構造化データは、raw HTMLの段階で読み取れなければならないという点に起因しています。AIエンジンは、あなたが信頼できるコンテンツの出典であると認めるため、この条件が満たされる必要があります。
非JS爬虫がJSON-LDを読み取れない理由:「レンダリングタイミング」の違いを理解する
すべての爬虫がJavaScriptを実行するわけではありません。これはよく知られている話ですが、現実のシナリオにおいて、非JS爬虫(特に生成式エンジンの背後にあるエンジン)の動作パターンは、あなたのコンテンツが「信頼できる出典」として認識されるかに直接影響を与えます。
| 種類 | JavaScriptを実行するか | JSON-LDを読み取れるか | 一般的なエンジン/爬虫 | 爬虫の動作が対応する現実のシナリオ |
|---|---|---|---|---|
| 非JS爬虫 | ❌ | ❌ | Google AI Overviews、一部の垂直AIエンジン | raw HTMLのみを解析し、JavaScriptで読み込まれたデータは読み取れない |
| JS爬虫 | ✅ | ✅ | Googlebot(一部のケース) | JavaScriptスクリプトを読み込み、ページの内容を完全に解析する |
核心的な問題は、JSON-LDが正しく記述されているかではなく、raw HTMLの段階で存在しているかです。 これは、家を建てる際、基礎がコンクリートか紙パックかという違いに似ています。構造データがAIエンジンに認められるためには、原始的なHTMLで可視化されていることが必須であり、ブラウザ上でJavaScriptによって「後から表示される」ものではなりません。
JSON-LDの正しい記述方法:HTMLから分離し、SSR段階で読み取れるようにする
JSON-LDは現在、Googleが公式に推奨する構造化データの形式です。検索エンジンやAIエンジンが機械的にページの内容を理解できるようにします。しかし、このすべての前提条件は——サーバーサイドレンダリング(SSR)段階でHTMLに埋め込まれていることであり、クライアントサイドのJavaScriptによってブラウザで動的に読み込まれているものではなりません。
なぜJSON-LDはraw HTMLに書くべきなのか?
1. 非JS爬虫はraw HTMLのみを読み取る:AIエンジンがコンテンツを解析する際、HTML内の静的な構造のみを読み取り、動的なスクリプトを実行しない場合があります。もしJSON-LDがJavaScriptによって読み込まれている場合、それは「エンジンの視点では存在しない」情報になります。 2. SEOは基礎、GEOが目標:従来のSEOは検索エンジンのロボットがコンテンツを読み取れるかに注目しますが、GEO(生成式検索最適化)はさらに進んで、AIエンジンが答えを生成する際にあなたのコンテンツを引用できるかに注目します。構造化データがJSで後から読み込まれている場合、AIエンジンはあなたの実体とコンテンツの関連性を正しく確立できません。
TrueLinkの実装戦略:JSON-LDをSSRで直接HTMLに注入する
TrueLink Blogでは、JSON-LドをSSRによってHTMLに注入する方法を採用し、従来のSEOおよびGEOの爬虫がページを取得する際に構造化データを即座に読み取れるようにしています。これは、私たちの技術実装functions/routes/publicBlogPage.jsおよびテストpublic-blog-section-visuals.test.js内の検証ロジックと一致しており、爬虫性と構造化データの可視性を確保しています。
AIエンジンが引用する価値のある構造化データとは?
AIエンジンがあなたのコンテンツを引用する理由は、JSON-LDを使用しているからではなく、あなたのコンテンツが「検証可能な独自性」と「トレース可能な構造」を持っているからです。これは、私たちが企業にGEOを支援する際の実務観察にも一致しています:AIエンジンは、構造が整っており、出典が明確で、著者と組織が明確に関連しているコンテンツをより好む傾向があります。
Article、Person、Organizationを使って「検証可能な実体関係」を構築する
schema.org/Articleは構造化データの中で最も重要なタイプの一つですが、孤立した存在ではありません。AIエンジンがあなたを本当に「信頼できる出典」として認めるためには、記事と著者、組織を明確にリンクする必要があります。これは以下の意味を持ちます:
authorタグを使ってschema.org/Personを指す;publisherタグを使ってschema.org/Organizationを指す;sameAsを使ってこれらの実体をあなたの本物のウェブサイトやソーシャルアカウントとリンクする。
このような構造は、エンジンに「この記事は誰が書いたのか、出典はどこにあるのか」を知らせると同時に、エンジンがあなたの出典の信頼性を検証する能力を提供します。これは、GoogleがE-E-A-Tにおいて「信頼性」と「真実性」を強調する実務的なやり方と一致しています。
構造化データがJSによって隔絶されるのをどう避けるか?実戦テクニックとチェックリスト
あなたの構造化データがJavaScriptで動的に読み込まれている場合、AIエンジンがそれを無視する可能性があります。これはあなたの構造化データが間違っているわけではなく、「可視性」が不足しているためです。以下に、構造化データがraw HTML段階で読み取れるようにするための実戦テクニックとチェックリストを紹介します。
✅ チェックリスト:構造化データがraw HTMLで可視か?
1. JSON-LDが<script type="application/ld+json">ブロック内に記述されているか? 2. これらのJSON-LDがSSR段階でHTMLに書き込まれているか、ブラウザでJavaScriptによって読み込まれているか? 3. JSON-LD内で@type、@id、author、publisherが正しく記述されているか? 4. sameAsを使って組織や著者を本物のウェブサイトとリンクしているか? 5. JSで動的に読み込まれるコンテンツに過度に依存していないか?
推奨されるJSON-LDの記述例:Article + Person + Organization
これは、Article、Person、Organizationを組み合わせ、sameAsを使って実体関係を構築する典型的な構造化データの例です:
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "JSON-LDをraw HTMLに記述するか、JavaScriptで注入するか?非JS爬虫があなたのschemaを読み取れない理由",
"author": {
"@type": "Person",
"name": "林士華",
"sameAs": ["https://www.linkedin.com/in/shih-hua-lin"]
},
"publisher": {
"@type": "Organization",
"name": "TrueLink(誠通數位)",
"sameAs": ["https://truelink-group.com"]
},
"datePublished": "2026-04-05",
"description": "AIエンジンがあなたのコンテンツを認めるためには、JavaScriptで動的に読み込まれるのではなく、JSON-LDをraw HTMLに記述することが必要です。"
}
なぜTrueLinkにとってはこれは核心なのか?信頼の基礎は、JSの中ではなくHTMLの中に
TrueLinkは別のSEOツールではありません。私たちの使命は、「AI信頼時代のデジタル信頼インフラ」を構築することです。私たちの核心的なコミットメントは、ChatGPTがあなたのブランドを引用することです。これを実現するためには、あなたの構造化データがraw HTMLで読み取れることを保証しなければなりません。なぜなら、AIエンジンは動的なJavaScriptを実行しないからです。
TrueLink BlogのJSON-LD実装プロセスでは、サーバーサイドレンダリング(SSR)段階でデータをHTMLに注入し、functions/routes/publicBlogPage.jsで検証しています。実測においてraw HTMLと比較すると、JavaScriptで注入されたschemaが頻繁に欠落していることが確認され、これにより「可視性」の必要性がさらに強調されました。
これは私たちの実務経験とも一致しています:企業にGEOを支援する過程で、構造化データがどれほど精巧に書かれていても、それがraw HTMLで可視でなければ、AIエンジンがそれを無視する可能性があります。信頼の基礎は、JSの中ではなく、HTMLの中にあります。


