エージェント向けMarkdownの導入

エージェント向けMarkdownの導入

セルソ・マルティーノ

ウィル・アレン

オンラインでコンテンツやビジネスが発見される方法は急速に変化しています。かつては、トラフィックは従来の検索エンジンから発生し、SEOが誰が最初に見つかるかを決定していました。現在では、トラフィックはますますAIクローラーやエージェントから来るようになっており、それらは人間向けに構築された、しばしば非構造化されたWeb内の構造化データを要求します。

ビジネスとして、今後も先を行き続けるためには、今こそ人間の訪問者やSEO最適化のための従来の知恵だけでなく、エージェントを第一級市民として扱い始める時です。

Markdownが重要な理由

生のHTMLをAIに与えることは、中の手紙ではなく、包装を読むために単語数で支払うようなものです。単純な ## About Us

About Us

このブログ記事は、HTMLでは16,180トークン、Markdownに変換すると3,150トークンになります。これはトークン使用量の80%削減です。

Markdownは、エージェントやAIシステム全体にとっての共通言語として急速に普及しました。この形式の明示的な構造はAI処理に理想的であり、最終的にはより良い結果をもたらしながらトークンの無駄を最小限に抑えます。

問題は、WebがMarkdownではなくHTMLで構成されており、ページの容量は年々着実に増加し続け、ページの解析を困難にしていることです。エージェントにとって、その目標はすべての非本質的な要素をフィルタリングし、関連するコンテンツをスキャンすることです。

HTMLからMarkdownへの変換は、今やあらゆるAIパイプラインにおける一般的なステップです。それでも、このプロセスは理想的とは程遠いものです：計算を浪費し、コストと処理の複雑さを増し、何よりも、コンテンツ作成者が最初に意図した使用方法ではない可能性があります。

もしAIエージェントが、意図分析やドキュメント変換の複雑さを迂回し、代わりにソースから直接構造化されたMarkdownを受け取ることができたらどうでしょうか？

HTMLを自動的にMarkdownに変換

Cloudflareのネットワークは現在、コンテンツネゴシエーションヘッダーを使用する有効なゾーンに対して、ソースでのリアルタイムコンテンツ変換をサポートします。これにより、Cloudflareを使用し、かつ「エージェント向けMarkdown」が有効になっている任意のウェブサイトからAIシステムがページをリクエストする際、リクエスト内で text/markdown を優先する旨を表明できます。当社のネットワークは、可能な場合、その場でHTMLを自動的かつ効率的にMarkdownに変換します。

仕組みは以下の通りです。「エージェント向けMarkdown」が有効なゾーンから任意のページのMarkdownバージョンを取得するには、クライアントは Accept ネゴシエーションヘッダーに text/markdown を追加する必要があります。

以下は、当社の開発者向けドキュメントからページをリクエストする Accept ネゴシエーションヘッダーを使用したcurlの例です：

curl https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/ \ -H "Accept: text/markdown"

または、Workersを使用してAIエージェントを構築している場合は、TypeScriptを使用できます：

const r = await fetch( https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/, { headers: { Accept: "text/markdown, text/html", }, }, ); const tokenCount = r.headers.get("x-markdown-tokens"); const markdown = await r.text();

今日、Claude CodeやOpenCodeのような最も人気のあるコーディングエージェントの一部が、コンテンツリクエストと共にこれらのacceptヘッダーを送信しているのをすでに見ています。さて、このリクエストへの応答はMarkdownでフォーマットされています。それだけ簡単です。

HTTP/2 200 date: Wed, 11 Feb 2026 11:44:48 GMT content-type: text/markdown; charset=utf-8 content-length: 2899 vary: accept x-markdown-tokens: 725 content-signal: ai-train=yes, search=yes, ai-input=yes --- title: Markdown for Agents · Cloudflare Agents docs --- ## What is Markdown for Agents The ability to parse and convert HTML to Markdown has become foundational for AI. ...

x-markdown-tokens ヘッダーを含めていることに注意してください。

仕組みの図は以下の通りです：

コンテンツシグナルポリシー

前回のバースデーウィーク中、Cloudflareはコンテンツシグナルを発表しました。これは、誰もが自分のコンテンツがアクセスされた後にどのように使用されるかについての選好を表明できるフレームワークです。

Markdownを返すときは、自分のコンテンツがエージェントやAIクローラーによって使用されていることを確認したいでしょう。そのため、「エージェント向けMarkdown」による変換済みのレスポンスには Content-Signal: ai-train=yes, search=yes, ai-input=yes が含まれます。

このフレームワークの詳細については、専用のコンテンツシグナルページをご確認ください。

Cloudflareブログと開発者向けドキュメントで試す

当社の開発者向けドキュメントとブログでこの機能を有効にし、すべてのAIクローラーとエージェントがHTMLの代わりにMarkdownを使用して当社のコンテンツを消費することを招待しています。

Accept: text/markdown を付けてこのブログをリクエストすることで、今すぐ試してください。

curl https://blog.cloudflare.com/markdown-for-agents/ \ -H "Accept: text/markdown"

--- description: オンラインでのコンテンツ発見の方法は、従来の検索エンジンから、人間向けに構築されたWebから構造化データを必要とするAIエージェントへと移行しています。人間の訪問者だけでなく、エージェントを第一級市民として扱い始める時です。エージェント向けMarkdownは、当社のネットワークからリクエストされた任意のHTMLページを自動的にMarkdownに変換します。 title: エージェント向けMarkdownの導入 image: https://blog.cloudflare.com/images/markdown-for-agents.png --- # エージェント向けMarkdownの導入 オンラインでコンテンツやビジネスが発見される方法は急速に変化しています。かつては、トラフィックは従来の検索エンジンから発生し、SEOが誰が最初に見つかるかを決定していました。現在では、トラフィックはますますAIクローラーやエージェントから来るようになっており、それらは人間向けに構築された、しばしば非構造化されたWeb内の構造化データを要求します。 ...

Markdownに変換する他の方法

Cloudflare外部からの任意のドキュメント変換を必要とするAIシステムを構築している場合、またはコンテンツソースから「エージェント向けMarkdown」が利用できない場合は、アプリケーション用にドキュメントをMarkdownに変換する他の方法を提供しています：

Workers AI AI.toMarkdown() は、HTMLだけでなく複数のドキュメントタイプと要約をサポートします。

ブラウザレンダリング /markdown REST API は、動的なページやアプリケーションを変換前に実際のブラウザでレンダリングする必要がある場合に、Markdown変換をサポートします。

Markdown使用状況の追跡

AIシステムがWebを閲覧する方法の変化を見越して、Cloudflare Radarには現在、AIボットとクローラートラフィックのコンテンツタイプに関する洞察が含まれており、AIインサイトページのグローバルなデータと、個々のボット情報ページの両方で確認できます。

新しい content_type ディメンションは、AIボットとクローラーによってリクエストされたコンテンツの種類（HTML、Markdown、JSONなど）を表示します。これは、AIボットがどのようにWebを閲覧しているかを理解するのに役立ちます。

特定のエージェントやクローラーでフィルタリングされたMarkdownへのリクエストも確認できます。以下は、ChatGPTの検索を強化するためにOpenAIが使用するクローラー、OAI-Searchbotに対してMarkdownを返すリクエストです：

この新しいデータにより、AIボット、クローラー、エージェントが時間の経過とともにどのようにWebコンテンツを消費しているかの進化を追跡できるようになります。いつものように、Radar上のすべては公開APIとデータエクスプローラーを通じて自由にアクセスできます。

今日から使い始める

ゾーンで「エージェント向けMarkdown」を有効にするには、Cloudflareダッシュボードにログインし、アカウントを選択、ゾーンを選択し、クイックアクションを探して「エージェント向けMarkdown」ボタンを切り替えて有効にします。この機能は本日ベータ版として、Pro、Business、Enterpriseプラン、およびSSL for SaaSのお客様に無料で利用可能です。

「エージェント向けMarkdown」の詳細については、開発者向けドキュメントでご覧いただけます。この機能を改良し強化し続けるにあたり、皆様のフィードバックをお待ちしています。Webの非構造化された性質が進化する中で、AIクローラーやエージェントがどのようにナビゲートし適応していくのか、興味深く見守っています。