agenticfeed

Agenticfeed Standard

AI ショッピングエージェントが読み取れるように、eコマースの商品カタログを整備するためのオープンな仕様です。

ChatGPT、Claude、Perplexity、Gemini などの AI アシスタントは、すでに何百万人もの買い物客に商品をおすすめしています。こうした AI アシスタントは、カテゴリーのページを閲覧したり、バナー広告を読んだりするわけではありません。構造化データを取り込み、購入者の意図に最も合う商品について推論します。ほとんどの販売業者のウェブサイトは、こうした AI アシスタントから認識されません。

この標準では、AI エージェントが必要とする情報を正確に提供する、軽量で発見しやすい形式を定義します。

---

クイックスタート

ウェブサイトのすべてのページの <head> に、次の1行を追加します。

<link rel="agenticfeed" type="application/json" href="https://yourdomain.com/feed.json">

このタグにより、あらゆる AI エージェントやクローラーに、構造化された商品フィードの場所を知らせることができます。このドキュメントの以降の部分では、そのフィードに含める内容を説明します。

---

目次

• エージェント向けフィードとは何ですか？
• この標準が必要な理由は何ですか？
• Google Merchant Center のフィードとは何が違いますか？
• AI エージェントはどのようにしてフィードを見つけますか？
• ウェブサイトに追加するにはどうすればよいですか？
• 仕様
  • 1. 発見用タグ
  • 2. フィードインデックス
  • 3. 意図エンドポイント
  • 4. 商品詳細
  • 5. UTM アトリビューション
  • 6. リンク検証
• エージェントクエリ API
  • 認証
  • リクエスト
  • レスポンス
  • エージェントカード
• 例
• リファレンス実装
• コントリビューション
• ライセンス

---

エージェント向けフィードとは何ですか？

エージェント向けフィードとは、検索エンジンのクローラーや人間の閲覧者ではなく、AI エージェント向けに構築された構造化商品データフィードです。

従来の商品ページは、人が表示して読むことを想定して設計されています。Google Merchant Center のフィードは、価格比較エンジンによる解析を想定して設計されています。エージェント向けフィードは、AI による推論を想定して設計されています。

重要な違いは、意図に関するデータです。販売業者のフィードがエージェントに「これはコードレスドリルで、価格は £29.99、在庫があります」と伝えるのに対して、エージェント向けフィードは「これは、『組み立て式家具を組み立てるにはどんなドリルが必要か』という質問に答え、『古いドリルではネジ山をつぶしてしまう』という問題を解決し、『初めて持ち家を購入した人の自宅での DIY』という用途に合うコードレスドリルです」と伝えます。

これは、AI エージェントが特定の購入者に自信を持って商品をおすすめするために必要なコンテキストの層です。

---

この標準が必要な理由は何ですか？

AI によるショッピングはすでに始まっています。それに適切に対応するためのツールは、オープンで移植可能な標準としてまだ存在していません。

検索エンジンは、サイトマップ、robots.txt、canonical タグを通じて、ウェブコンテンツの発見方法を標準化しました。RSS は、単一の自動検出タグを通じてコンテンツの配信を標準化しました。しかし、どちらも、AI エージェントが何をおすすめするか決める際に行う構造化推論を想定して設計されたものではありません。

この仕様は、そのギャップを埋めるものです。以下を定義します。

• 構造化商品フィードの存在を、ウェブサイトが AI エージェントに知らせる方法
• そのフィードの形式
• 意図データ（質問、問題、用途）を標準的な商品データとともに構造化する方法
• AI エージェントが購入者の問い合わせから特定の商品のお勧めへと移動する方法

この形式は、意図的に最小限にしています。クローラーがすでに理解している schema.org の型を基盤とし、AI によるおすすめを可能にする意図の層を追加します。

---

Google Merchant Center のフィードとの違いは何ですか？

	Google Merchant Center のフィード	Agenticfeed
形式	XML（RSS に類似）	JSON-LD
スキーマ	Google 独自の仕様	schema.org + agenticfeed 名前空間
主な利用者	価格比較、ショッピング広告	AI エージェント、LLM、ショッピングアシスタント
検出方法	URL を手動で送信	<link rel="agenticfeed"> による自動検出
インテントデータ	なし	商品ごとの質問、問題、ユースケース
商品コンテキスト	価格、タイトル、画像、在庫状況	価格、タイトル、画像 + 購入者のインテント層
アトリビューション	標準ではなし	すべての商品 URL に UTM パラメーターを付与

Google Merchant Center のフィードは、商品が「何であるか」を機械に伝えます。Agenticfeed は、「なぜ特定の購入者がその商品を選ぶべきか」を伝えます。

この 2 つは相互補完的です。多くの販売者は、Agenticfeed を生成するためのデータソースとして GMC フィードを使用しています。

---

AI エージェントはどのように検出しますか？

検出の仕組みには、ウェブで何十年も使われてきた自動検出パターンを採用しています。

rel="stylesheet"   tells browsers where to find CSS
rel="icon"         tells browsers where to find the favicon
rel="alternate"    tells crawlers where to find RSS feeds
rel="agenticfeed"  tells AI agents where to find structured product data

AI エージェントやクローラーが販売者のウェブサイトにアクセスすると、ページの <head> を読み取ります。rel="agenticfeed" タグが見つかると、事前に URL を知らされていなくても、構造化された商品データを取得する場所を正確に把握できます。

つまり、次のことが可能です。

1. 各 AI プラットフォームへの手動登録が不要
2. API キーやアクセス契約が不要
3. この標準を実装している AI エージェントなら、どれでもフィードを自動的に検出可能
4. 販売者が自身の URL 上でデータを管理

---

ウェブサイトに追加するにはどうすればよいですか？

手順 1. すべてのページの <head> に検出タグを追加します。

<link rel="agenticfeed" type="application/json" href="https://yourdomain.com/feed.json">

手順 2. その URL で JSON-LD フィードインデックスを配信します（examples/feed.json を参照）。

{
  "@context": "https://schema.org",
  "@type": "DataFeed",
  "name": "Your Store Name",
  "url": "https://yourdomain.com/feed.json",
  "provider": {
    "@type": "Organization",
    "name": "Agenticfeed",
    "url": "https://agenticfeed.ai"
  },
  "dataFeedElement": [
    {
      "@type": "DataFeedItem",
      "name": "Questions",
      "url": "https://yourdomain.com/questions.json"
    },
    {
      "@type": "DataFeedItem",
      "name": "Problems",
      "url": "https://yourdomain.com/problems.json"
    },
    {
      "@type": "DataFeedItem",
      "name": "Use Cases",
      "url": "https://yourdomain.com/use-cases.json"
    }
  ]
}

手順 3. 各カテゴリーのインテントエンドポイントを配信します（examples/questions.json を参照）。

手順 4. 各商品の商品詳細ドキュメントを配信します（examples/product.json を参照）。

Shopify の販売者は、agenticfeed.ai を利用すると、テーマへの検出タグの挿入を含め、これらすべてを自動的に処理できます。

---

仕様

1. 検出タグ

<link rel="agenticfeed" type="application/json" href="{absolute-url-to-feed-index}">

属性	値
rel	agenticfeed
type	application/json
href	フィードインデックスドキュメントの絶対 URL

このタグをすべてのページの <head> に配置します。クローラーがスクリプトを実行しなくても検出できるように、JavaScript で挿入するのではなく、サーバーがレンダリングした HTML に含める必要があります。

---

2. フィードインデックス

Content-Type: application/ld+json Schema.org type: DataFeed

フィードインデックスは、フィードを読み取るエージェントのエントリーポイントです。販売者を識別し、インテントエンドポイントを一覧表示し、個々の商品を解決するための URL テンプレートを提供します。

完全な例は examples/feed.json を参照してください。

エージェントのワークフロー：

1. ページの <head> で検出タグを見つける
2. フィードインデックスを取得する
3. dataFeedElement を読み取り、インテントエンドポイントを見つける
4. 購入者のクエリの種類に応じた関連エンドポイントを取得する
5. インテントエントリーを購入者のニーズに照らして照合し、商品 ID を抽出する
6. agenticfeed.resolution.product.url テンプレートを使用して各商品 ID を解決する
7. 商品詳細ドキュメントを取得する

---

3. インテントエンドポイント

インテントエンドポイントは、商品カテゴリーごとにまとめられた JSON-LD ItemList ドキュメントです。インテントの種類は 3 つあります。

質問 — 購入前に購入者が尋ねる自然言語の質問です。 Schema.org type: 商品 URL を指す suggestedAnswer を持つ Question。 examples/questions.json を参照してください。

問題 — 商品が解決する問題点やニーズです。 Schema.org type: 問題を表す name と商品を表す url を持つ ListItem。 examples/problems.json を参照してください。

ユースケース — 商品が適する具体的なシナリオや目標です。 Schema.org type: ユースケースを表す name と商品を表す url を持つ ListItem。 examples/use-cases.json を参照してください。

---

4. 商品の詳細

Content-Type: application/ld+json Schema.org type: Product

各商品には、固定 URL に独自のドキュメントがあります。標準の schema.org Product データと、agenticfeed 名前空間のインテント情報を組み合わせています。

完全な例については、examples/product.json を参照してください。

フィールド	型	説明
@context	string	https://schema.org
@type	string	Product
name	string	商品名
url	string	販売者の商品ページの URL（UTM タグ付き）
image	string	商品のメイン画像の URL
category	string	商品カテゴリ
offers	Object	schema.org Offer — 価格、通貨、在庫状況
agenticfeed.questions	Array	この商品が答える質問
agenticfeed.problems	Array	この商品が解決する問題
agenticfeed.use_cases	Array	この商品が適したユースケース

---

5. UTM アトリビューション

エージェント向けフィード内のすべての商品 URL には、販売者が分析ツールで AI エージェントからのトラフィックを測定できるよう、UTM パラメーターを付ける必要があります。

utm_source=agenticfeed&utm_medium=ai-agent

これにより、販売者は Google Analytics、Shopify Analytics、または UTM パラメーターを読み取るあらゆるプラットフォームで、AI エージェントの推奨から発生したセッションや注文を絞り込み、レポートを作成できます。

---

6. リンクの検証

販売者の <head> にあるディスカバリータグは、フィードが公開される前にドメイン所有権を証明する役割を果たします。バリデーターは販売者のホームページを取得して <head> を解析し、次の点を確認します。

• rel="agenticfeed" タグが存在すること
• その href が販売者に対応する想定フィード URL と一致すること

これにより、ある販売者がフィード内で別の販売者のドメインを名乗ることを防ぎます。

---

エージェントクエリ API

パッシブフィードのエンドポイントを使うと、AI エージェントは自分のペースで商品データをクロールできます。エージェントクエリ API はアクティブなレイヤーです。AI エージェントまたはアプリケーションが自然言語で購入者の意図を送信し、理由とともに、条件に合致した商品をランキング順で受け取れます。

これはエージェント間の通信です。人間が検索ボックスに入力する代わりに、ある AI が別の AI に最適な商品を探すよう依頼します。

エンドポイント

POST https://agenticfeed.ai/agent/query
Content-Type: application/json
Authorization: Bearer af_your_api_key

---

認証

API キーが 1 つ必要です。

Agenticfeed API key — Authorization ヘッダーで Bearer トークンとして渡します。これはリクエストの送信者を識別し、フィードデータへのアクセスを制御します。有料プラン（Growth 以上）であれば、Dashboard › API Keys から生成できます。承認は不要です。キーはすぐに利用できます。

---

リクエスト

{
  "query": "ergonomic chair for someone with lower back pain, works from home 10 hours a day, small home office, budget under £300",
  "customer_guid": "a9a8378c94",
  "limit": 5
}

フィールド	型	必須	説明
query	string	はい	購入者が必要としているものを自然言語で記述した内容
customer_guid	string	いいえ	クエリ対象の販売者フィード。デフォルトでは API キーにリンクされたフィード
limit	integer	いいえ	返す結果の最大数（1～10、デフォルトは 5）

---

レスポンス

一致した Product エントリーの schema.org ItemList を返します。各エントリーには、その商品が購入者のニーズに合う理由を説明する match_reason が含まれます。

Content-Type: application/ld+json

{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "query": "ergonomic chair for back pain...",
  "numberOfItems": 3,
  "itemListElement": [
    {
      "@type": "Product",
      "position": 1,
      "name": "HM Seating Contessa Chair",
      "url": "https://merchant.com/contessa?utm_source=agenticfeed&utm_medium=ai-agent",
      "image": "https://merchant.com/images/contessa.jpg",
      "category": "office chairs",
      "offers": {
        "@type": "Offer",
        "price": "249.00",
        "priceCurrency": "GBP",
        "availability": "https://schema.org/InStock"
      },
      "agenticfeed": {
        "product_id": "b3f1e29a4c",
        "match_reason": "Matches adjustable lumbar support, compact footprint for small spaces, and falls within the stated budget."
      }
    }
  ]
}

match_reason フィールドは、呼び出し元のエージェントが最終購入者にそのまま渡せるように設計されています。エージェントが追加の推論を行わなくても、推奨理由を平易な言葉で説明します。

---

エージェントカード

リファレンス実装では、A2A 互換のエージェントカードを次の場所で公開しています。

GET https://agenticfeed.ai/.well-known/agent.json

このファイルには、エージェントの機能、受け付ける入力、出力形式、認証要件が機械可読形式で記述されています。Google の Agent-to-Agent（A2A）プロトコルを実装する AI プラットフォームは、このカードを使ってクエリエンドポイントを自動的に検出し、呼び出すことができます。

---

例

すべての例はexamples/ディレクトリにあります。

ファイル	説明
examples/feed.json	フィードの完全なインデックス
examples/product.json	インテントデータを含む製品詳細
examples/questions.json	質問エンドポイント
examples/problems.json	課題エンドポイント
examples/use-cases.json	ユースケースエンドポイント
examples/link-tag.html	検出タグのスニペット

---

リファレンス実装

agenticfeed.aiは、この標準のホスト型リファレンス実装です。

次の機能を提供します。

• Shopify、WooCommerce、Google Merchant Center、およびウェブサイトのクロールによる製品カタログの自動インポート
• 製品ごとのAI生成インテントデータ（質問、課題、ユースケース）
• 毎日の在庫と価格の同期
• OAuthを介したShopifyテーマへの検出タグの自動挿入
• アトリビューション追跡用のUTMタグ付き製品URL
• フィードとサブスクリプションを管理するためのマーチャントダッシュボード
• 自然言語による製品マッチングのための/agent/queryのAgent Query API（有料プランに含まれます）
• /.well-known/agent.jsonのA2A互換Agent Card

agenticfeed.aiを利用するマーチャントは、コードを一切書かずに標準に完全準拠したエージェンティックフィードを利用できます。AIエージェントを構築する開発者は、すべての有料マーチャントプランに含まれるAgent Query APIを使って、購入者のインテントに基づき製品データを照会できます。

---

コントリビューション

github.com/bluestratus/agenticfeedで、イシューやプルリクエストを歓迎します。

この標準の目標は、最小限で安定したものにすることです。AIエージェントやマーチャントに明確なメリットをもたらさず、複雑さを増す提案はマージされません。最も有益なコントリビューションは、実環境での実装経験、エッジケース、および修正です。

---

ライセンス

MIT Licenceの下で公開されています。誰でも制限なく、この標準を使用して互換性のあるエージェンティックフィードを実装できます。