サーバーサイド連携ガイド

なぜ「サーバー側」でないとダメか

これを理解しないと、入れても効きません。

AIクローラー（GPTBot / ClaudeBot / PerplexityBot 等）は JavaScriptを実行しません。ブラウザで後から挿入するタグ（<script src="…/tag.js"> や GTM経由）で入れた構造化データは、AIからは見えません。

そこで本キットは、サーバーがHTMLを生成する時点で JSON-LD を埋め込みます。ブラウザの「ページのソースを表示（view-source）」に application/ld+json が出る＝AIが読める状態になります。

仕組み — 常に最新になる理由

店のサーバー ──(描画のたび / 10分キャッシュ)──▶  Nurevo  /api/tag/config?k=サイトキー
      │                                                 │
      │   ◀────────── ruleset反映済みの JSON-LD ─────────┘
      ▼
生HTMLの <head> に <script type="application/ld+json"> を埋めて返す

Nurevo中央の「脳（ruleset）」が更新されると、各サイトは次回取得時（最大10分）に自動で最新化。API障害時は直近キャッシュを使うので、店のページは絶対に壊れません（フェイルオープン）。

導入手順

1. サイトキーを用意
   Nurevoダッシュボードでサイトを登録し、発行された nrv_xxxxxxxx を控える。
2. 環境に合わせて組み込む（下記）
3. robots.txt を置く（AIクローラー許可）
4. 検証する（view-source に application/ld+json が出るか確認）

PHP 素のPHP / 多くのCMS

同梱の php/nurevo-aeo.php をサーバーに置き、各ページの <head> 内・</head> の直前で呼ぶ：

<?php require __DIR__ . '/nurevo-aeo.php'; nurevo_render_jsonld('nrv_xxxxxxxx'); ?>

Node.js Express 等

同梱の node/nurevo-aeo.js を置き：

const { nurevoJsonLdTag } = require('./nurevo-aeo');
app.get('/', async (req, res) => {
  const ld = await nurevoJsonLdTag('nrv_xxxxxxxx');
  res.send(`<!doctype html><html><head>${ld}</head><body>...</body></html>`);
});

テンプレートエンジン派は nurevoMiddleware('nrv_xxxxxxxx') を使い、ビューで res.locals.nurevoJsonLd を <head> に出力。

Next.js App Router

同梱の nextjs/nurevo.ts を lib/ 等に置き、app/layout.tsx（Server Component）で：

import { getNurevoJsonLd } from '@/lib/nurevo';
const ld = await getNurevoJsonLd('nrv_xxxxxxxx');
// <head> 内で:
{ld && <script type="application/ld+json"
   dangerouslySetInnerHTML={{__html: JSON.stringify(ld).replace(/</g,'\\u003c')}} />}

robots.txt 全環境共通

同梱の static/robots.txt をドメイン直下に配置（既存があれば User-agent ブロックを追記）。

検証 — 組み込み後、必ず確認

これが通れば「AIに読まれる状態」になっています。

① ソースに出ているか（最重要）

ブラウザで店のページを開き「ページのソースを表示」→ application/ld+json を検索。JSON-LDが生HTMLに出ていればOK（DevToolsのElementsで見えるだけ＝JS注入はNG）。

② コマンドで確認

# 生HTMLにJSON-LDが含まれるか
curl -s https://あなたの店.jp/ | grep -o 'application/ld+json' | head

# AIボットのふりをしても返るか（エッジブロックの検出）
curl -s -A "GPTBot" https://あなたの店.jp/ | grep -o 'application/ld+json' | head

どちらも1行返れば合格。①で出て②で出ない場合はCDNがAIボットを弾いています。

方式の比較

よくある質問