AI Rendering: AI エージェントが読めるページのコピー

AI エージェントはサーバーが送る HTML を読みます。スクリプトを実行しないため、スクリプトが描く価格、レビュー、仕様は届かず、画像の中の文字は alt テキストからしか読みません。AI Rendering は公開したページを人が見るとおりにレンダリングし、スクリプトを外し、画像ごとに文字を alt テキストに書き込みます。サイトの CDN はこのコピーをダウンロードして保管し、AI エージェントに返します。人、検索エンジン、その他のリクエストはこれまでどおりサイトに届き、querying.ai はサイトへのリクエストの経路に入りません。 GEO Score がこの差を測ります。rendering.score はコピーが含むページの割合です。CDN がコピーを送れば、受け取るエージェントはその分を読みます。

仕組み

サイトを接続します。 サイトキーは一度だけ表示されます。このキーはサイトのコピーを読むことしかできません。
ページを公開します。 ページの URL を送ると、querying.ai がサイトの国からレンダリングしてコピーを保管し、refreshDays 日ごと (既定 28 日)に再レンダリングします。
コピーを同期します。 CDN が 10 分ごとにサイトキーでコピー一覧を読み、新しいコピーをダウンロードし、一覧から消えたコピーを削除します。
AI エージェントに返します。 AI エージェントが GET を送ると、CDN は保管したコピーで応答します。コピーのないページ、期限切れのコピー、エラーはオリジンに送ります。

サイトの接続

curl -X POST https://api.querying.ai/v1/ai-rendering/sites \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "host": "www.example.com" }'

{
  "success": true,
  "site": {
    "id": "5b0e9f52-6a3c-4f0e-8d0b-2c7e4a1f9d33",
    "host": "www.example.com",
    "refreshDays": 28,
    "country": "US",
    "keyPrefix": "rs_8f2c4a1b",
    "pages": 0,
    "createdAt": "2026-10-23T01:00:00.000Z",
    "updatedAt": "2026-10-23T01:00:00.000Z"
  },
  "key": "rs_8f2c4a1b…"
}

key を保管してください。このレスポンスにしかなく、CDN が送ります。POST /v1/ai-rendering/sites/{id}/key は新しいキーを返し、古いキーをすぐに止めます。

フィールド	必須	説明
`host`	はい	CDN が配信する公開ホスト名です(例: `www.example.com`)。ホストごとに一度接続し、アカウントあたり 20 件までです。
`refreshDays`	いいえ	公開したページを再レンダリングする間隔(日)で `1`–`28`、既定は `28` です。コピーのファイルは 30 日で期限切れになります。
`country`	いいえ	ページをレンダリングする国で、`US`(既定)または `KR` です。GEO Score の読者の国と同じです。顧客がアクセスする国を選んでください。

あとから PATCH /v1/ai-rendering/sites/{id} で変更できます。

ページの公開

curl -X POST https://api.querying.ai/v1/ai-rendering/sites/5b0e9f52-6a3c-4f0e-8d0b-2c7e4a1f9d33/pages \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.example.com/products/sunscreen" }'

ページをレンダリングしています:

{
  "success": true,
  "page": {
    "id": "a3d1c9e0-7b52-4e1f-9c84-0f6b2d5e7a10",
    "url": "https://www.example.com/products/sunscreen",
    "path": "/products/sunscreen",
    "status": "rendering",
    "copy": null,
    "taskId": null,
    "renderedAt": null,
    "expiresAt": null,
    "publishedAt": "2026-10-23T01:00:00.000Z",
    "refreshAt": "2026-10-23T07:00:00.000Z",
    "refreshTaskId": "7c4e2a90-1d3b-4f6a-8e25-9b0c1f3d4e57"
  },
  "taskId": "7c4e2a90-1d3b-4f6a-8e25-9b0c1f3d4e57"
}

レンダリングには 30 秒ほどかかります。GET /v1/async/task/{taskId} で追うか、GET /v1/ai-rendering/sites/{id} でページの status を読みます:

ready: コピーがコピー一覧にあります。copy がその HTML ファイルです。
rendering: 最初のコピーを作っています。
failed: 最初のレンダリングが失敗しました。refreshAt に再レンダリングします。
expired: コピーが期限切れになり、次のレンダリングまで一覧から外れました。

サイトあたり 1,000 ページまでです。公開済みのページをもう一度送ると、今すぐ再レンダリングします。ページはパスとクエリで区別し、 utm_* や gclid などの計測パラメータは除きます。DELETE /v1/ai-rendering/sites/{id}/pages/{pageId} でページを取り下げます。 GEO Score が作ったコピーを再レンダリングせずに公開するには、その task id を送ります: { "taskId": "0b6c1f7e-…" }。アカウントの完了した GEO Score で、サイトの国から測ったものである必要があります。

CDN の設定

次を CDN のコードの隣に ai-rendering.mjs として保存します。syncCopies はストアをコピー一覧に合わせ、copyFor は AI エージェントの GET にストアのコピーで応答します:

export const COPIES_URL = "https://api.querying.ai/v1/ai-rendering/copies";

export const AGENTS = [
	"chatgpt-user",
	"codex",
	"claude-user",
	"claude-code",
	"perplexity-user",
	"gemini-deep-research",
	"duckassistbot",
	"amzn-user",
	"mistralai-user",
	"oai-searchbot",
];

export const DOWNLOADS_PER_SYNC = 40;

const EXPIRY_MARGIN_MS = 10 * 60_000;

const TRACKING_PARAM =
	/^(?:utm_[a-z0-9_]+|gclid|gbraid|wbraid|dclid|fbclid|msclkid|twclid|ttclid|srsltid|mc_cid|mc_eid|_ga|_gl)$/i;

export function pagePath(url) {
	const kept = [...url.searchParams].filter(([name]) => !TRACKING_PARAM.test(name));
	return (url.pathname || "/") + (kept.length ? "?" + new URLSearchParams(kept).toString() : "");
}

export async function copyKey(host, path) {
	const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(host.toLowerCase() + path));
	return "copy:" + [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
}

export function agentRequest(request, agents = AGENTS) {
	if (request.method !== "GET") return false;
	const userAgent = (request.headers.get("user-agent") ?? "").toLowerCase();
	return agents.some((token) => userAgent.includes(token));
}

export async function syncCopies(options) {
	const {
		siteKey,
		store,
		copiesUrl = COPIES_URL,
		downloads = DOWNLOADS_PER_SYNC,
		fetch: send = fetch,
		now = Date.now,
	} = options;
	if (!siteKey) throw new Error("AI Rendering: no site key");
	const answer = await send(copiesUrl, { headers: { "X-Querying-Site-Key": siteKey } });
	if (!answer.ok) throw new Error(`AI Rendering: the copy list answered ${answer.status}`);
	const { host, copies } = await answer.json();
	const stored = await store.list();
	const listed = new Set();
	const result = { listed: copies.length, downloaded: 0, failed: 0, waiting: 0, removed: 0 };
	for (const copy of copies) {
		const key = await copyKey(host, copy.path);
		listed.add(key);
		if (stored.get(key) === copy.renderedAt || Date.parse(copy.expiresAt) - now() < EXPIRY_MARGIN_MS) continue;
		if (result.downloaded + result.failed >= downloads) {
			result.waiting++;
			continue;
		}
		try {
			const file = await send(copy.copy);
			if (!file.ok) throw new Error(String(file.status));
			await store.put(key, await file.arrayBuffer(), { renderedAt: copy.renderedAt, expiresAt: copy.expiresAt });
			result.downloaded++;
		} catch {
			result.failed++;
		}
	}
	for (const key of stored.keys())
		if (!listed.has(key)) {
			await store.delete(key);
			result.removed++;
		}
	return result;
}

export async function copyFor(request, store, agents = AGENTS) {
	if (!agentRequest(request, agents)) return null;
	try {
		const url = new URL(request.url);
		const copy = await store.get(await copyKey(url.hostname, pagePath(url)));
		if (!copy || !(Date.parse(copy.expiresAt) > Date.now())) return null;
		return new Response(copy.body, {
			status: 200,
			headers: {
				"Content-Type": "text/html; charset=utf-8",
				"Cache-Control": "private, no-store",
				Vary: "User-Agent",
				"X-Querying-Rendering": "HIT",
				"X-Querying-Rendered-At": copy.renderedAt,
			},
		});
	} catch {
		return null;
	}
}

Cloudflare Worker
ほかの CDN とサーバー

Worker はコピーを Workers KV に置き、cron で 10 分ごとに同期します。コピーは KV でコピーのファイルと同時に期限切れになります。

npx wrangler kv namespace create AI_RENDERING
npx wrangler secret put QUERYING_SITE_KEY

wrangler.toml:

name = "ai-rendering"
main = "cloudflare-worker.mjs"
compatibility_date = "2026-10-01"
routes = [{ pattern = "www.example.com/*", zone_name = "example.com" }]
kv_namespaces = [{ binding = "AI_RENDERING", id = "<namespace id>" }]

[triggers]
crons = ["*/10 * * * *"]

cloudflare-worker.mjs:

import { copyFor, syncCopies } from "./ai-rendering.mjs";

export function kvStore(kv) {
	return {
		async get(key) {
			const { value, metadata } = await kv.getWithMetadata(key, "arrayBuffer");
			return value && metadata ? { body: value, ...metadata } : null;
		},
		async list() {
			const stored = new Map();
			let cursor;
			do {
				const page = await kv.list({ prefix: "copy:", cursor });
				for (const key of page.keys) stored.set(key.name, key.metadata?.renderedAt);
				cursor = page.list_complete ? undefined : page.cursor;
			} while (cursor);
			return stored;
		},
		put: (key, body, meta) =>
			kv.put(key, body, { expiration: Math.floor(Date.parse(meta.expiresAt) / 1000), metadata: meta }),
		delete: (key) => kv.delete(key),
	};
}

export default {
	async fetch(request, env) {
		return (await copyFor(request, kvStore(env.AI_RENDERING))) ?? fetch(request);
	},
	async scheduled(_controller, env, ctx) {
		ctx.waitUntil(syncCopies({ siteKey: env.QUERYING_SITE_KEY, store: kvStore(env.AI_RENDERING) }));
	},
};

Workers Free プランでは KV の書き込みが 1 日 1,000 回のため、大きなサイトは最初の同期に 1 日以上かかることがあります。

同じモジュールに、そのプラットフォームのストアをつなぎます。ストアは get(key)、list()、put(key, body, meta)、 delete(key) を持つオブジェクトです。list() は保存したキーごとに保存時の renderedAt を返します。syncCopies は定期的に、 copyFor はページへのリクエストごとに実行します。URL だけでキャッシュする CDN では、エージェントをキャッシュキーに加えて、人にコピーが届かないようにしてください。

次の同期が終わったあと、公開したページを ChatGPT が開くように確認します。コピーには X-Querying-Rendering: HIT が付きます:

curl -sI -A "Mozilla/5.0 (compatible; ChatGPT-User/1.0; +https://openai.com/bot)" https://www.example.com/products/sunscreen

コピー一覧

CDN は X-Querying-Site-Key にサイトキーを入れて GET https://api.querying.ai/v1/ai-rendering/copies を読みます:

{
  "success": true,
  "host": "www.example.com",
  "copies": [
    {
      "path": "/products/sunscreen",
      "url": "https://www.example.com/products/sunscreen",
      "copy": "https://api.querying.ai/v1/evidence/1792717200-9f3c2a7d1e4b.html",
      "renderedAt": "2026-10-23T01:00:31.000Z",
      "expiresAt": "2026-11-22T01:00:00.000Z"
    }
  ]
}

コピーが期限切れでない公開ページをすべて含みます。copy はキーなしでダウンロードできます。ページを再レンダリングすると renderedAt が変わるので、renderedAt が新しいときだけダウンロードしてください。一覧にないページのコピーは削除します。一覧とダウンロードは無料です。

エージェント

モジュールの AGENTS がコピーを受け取る相手を決めます。User-Agent のどこにあっても、大文字と小文字を区別せずトークンで照合します。

既定: 人が質問しながらページに送るエージェント(chatgpt-user、codex、claude-user、claude-code、perplexity-user、 gemini-deep-research、duckassistbot、amzn-user、mistralai-user)と、ChatGPT 検索のクローラー oai-searchbot です。 ChatGPT 検索はこのクローラーが取得したページから答え、GEO Score の score がそのページを測ります。検索インデックスは OpenAI が再クロールしたあとに変わります。
必要なら追加: claude-searchbot、perplexitybot。
入れない: 学習用クローラー(GPTBot、ClaudeBot)と Web 検索のクローラー(Googlebot、Bingbot)。Googlebot はスクリプトを自分で実行します。

検索エンジンのルールを守る

ボットに人と違う内容を送るとクローキングです。Google は、ボット向けにレンダリングしたページでも内容が近ければクローキングとみなしません (Dynamic rendering)。OpenAI はクローキングの方針を公開していないため、コピーを Google の基準に合わせます:

コピーは人のブラウザが描いたページです。querying.ai はスクリプトを外し、画像の中の文字だけをその画像の alt テキストに加えます。alt は画像の文字が入る場所です。
コピーはそのページの URL でだけ送ります。
コピーは最新に保たれます。querying.ai が refreshDays ごとに再レンダリングし、モジュールは期限切れのコピーを送りません。
コピーを編集するなら、削除か修正だけにしてください。読み違えた文字の修正やポップアップの削除は問題ありません。人に見えない主張、価格、リンクを加えないでください。

コピーの中身

コピーは、人のブラウザがページを最後までスクロールしたあとに描いた HTML です。スクリプトが読み込んだ文字、元の位置に入ったフレームのページがあり、構造化データ(JSON-LD)を除くスクリプトはすべて外され、大きな画像ごとに文字が alt テキストに入ります。リンクと画像のアドレスは絶対アドレスのまま残り、ページと同じように読めます。コピーは最後のレンダリング時点のページです。価格や在庫の変更は、次のレンダリング(最大 refreshDays 日後)に CDN の同期時間を足した分だけ遅れてエージェントに届きます。画像の文字は読んだとおりに入るため、読み違えた文字もそのまま送られます。

課金

レンダリング 1 回で 5 クレジット、文字を読んだ画像ごとに 5 クレジット、アカウントが過去 90 日に読んだ画像(同じファイル、同じ読み方)は 1 枚 2 クレジットで、最大 12 枚です。送信時に 65 クレジットを確保し、完了時に使った分だけ差し引きます。失敗したレンダリングは課金しません。更新も同じ規則でサイトのアカウントに課金し、クレジットが足りないアカウントは 1 時間後に再試行します。サイトの接続、 GEO Score のコピーの公開、コピー一覧、コピーのダウンロードは無料です。コピーは CDN が送るため、エージェントのトラフィックに querying.ai の費用はかかりません。クレジットと上限を参照してください。

エラー

ステータス	コード	原因
`401`	`UNAUTHORIZED`	コピー一覧のリクエストにサイトキーがない、置き換えたキー、または削除したサイトのキーです。
`402`	`INSUFFICIENT_CREDITS`	残高がレンダリングの 65 クレジットの確保に足りません。
`403`	`KEY_SCOPE_DENIED`	API キーがエンジンを制限しており、`GEO_SCORE` が含まれていません。
`404`	`NOT_FOUND`	その id のサイト、ページ、GEO Score がアカウントにありません。
`409`	`SITE_EXISTS`、`SITE_LIMIT`、`PAGE_LIMIT`、`TASK_NOT_COMPLETED`	接続済みのホスト、アカウントのサイト 20 件、サイトのページ 1,000 件、完了していない GEO Score です。
`410`	`COPY_EXPIRED`	GEO Score のコピーが期限切れです。URL で公開してください。
`422`	`VALIDATION_ERROR`、`NO_RENDERED_COPY`	フィールドが不正、別ホストの URL、別の国で測った GEO Score、またはコピーを作れなかった GEO Score です。
`429`、`503`		プランの同時実行数かレンダリングのキューがいっぱいです。`Retry-After` のあとに再送してください。

エンドポイントは API reference にあります。

はじめに

基本概念

回答エンジン

検索とウェブデータ

リクエストオプション

リサーチ

GEOモニタリング

アカウントとデータ

AI Rendering: AI エージェントが読めるページのコピー

仕組み

サイトの接続

ページの公開

CDN の設定

コピー一覧

エージェント

検索エンジンのルールを守る

コピーの中身

課金

エラー

​仕組み

​サイトの接続

​ページの公開

​CDN の設定

​コピー一覧

​エージェント

​検索エンジンのルールを守る

​コピーの中身

​課金

​エラー

仕組み

サイトの接続

ページの公開

CDN の設定

コピー一覧

エージェント

検索エンジンのルールを守る

コピーの中身

課金

エラー