複数の検索プロバイダー
1つのproviderパラメータでCeramic.ai、Exa、またはLinkupを選択できます。各プロバイダーは共通の結果形式を返すため、統合の他の部分を変更せずにプロバイダーを切り替えられます。
Cloudflare Web Search API
Cloudflare Web Search APIは、AIエージェントやアプリケーションにライブWeb検索へのアクセスを提供するオープンベータAPIです。検索をAI Gateway経由でルーティングし、タイトル、URL、説明を含む構造化された結果を返すため、アプリケーションはモデルのトレーニングデータや推測したURLだけに頼らず、現在のWeb情報に基づいてモデルの回答を生成できます。
このサービスは、共通のリクエストインターフェースを通じてCeramic.ai、Exa、Linkupに対応しており、REST APIを使って任意のバックエンドから、またはWorkers AI bindingを通じてCloudflare Workerから利用できます。検索リクエストはAI Gatewayのログと分析に含まれ、課金にはAI Gatewayクレジットまたはゲートウェイに保存されたプロバイダーキーを使用できます。
Web Search APIの機能
ゲートウェイの可観測性
検索はAI Gatewayを経由し、ゲートウェイのログと分析でモデル推論リクエストとともに確認できます。AI Gatewayのアクセス制御と運用状況の可視性も利用できます。
柔軟な課金方法
AI Gatewayクレジットを使用する場合、検索には選択したプロバイダーの公開API価格が適用され、追加のマークアップはありません。代わりに、既存のプロバイダーアカウントを保存済みのゲートウェイキーで使用することもできます。
構造化された出典付き結果
結果には、モデルのコンテキストに渡せるソースURL、タイトル、説明が含まれます。プロバイダー固有の説明は、長いページ説明、ハイライト、または検索結果の生スニペットの場合があります。
エージェントとアプリケーションのワークフロー
APIはRESTを通じてバックエンドアプリケーションから、またはAI bindingを使用してWorkersから呼び出せます。モデルがweb_searchツールを呼び出して検索を実行し、後続の補完処理に結果を返すこともできます。
プロバイダー固有のデータおよびクロール条件
プロバイダー比較では、Ceramic.aiとLinkupはZero Data Retentionあり、ExaはZero Data Retentionなしと記載されています。3つのプロバイダーはいずれも、Cloudflareの検証済みボット要件に準拠しています。
Web Search APIのユースケース
エージェントの回答のグラウンディング
モデル用のweb_searchツールを定義し、Web Search APIを通じて要求された検索を実行して、構造化された結果を後続のモデル補完処理に渡します。
最新情報を扱うアプリケーション
現在のWeb検索結果を使用して、イベント、場所、製品、その他、モデルのトレーニングデータ収集後に情報が変わっている可能性のある विषयについて質問に回答します。
プロバイダーに合わせた検索
エージェントのワークフローから検索を繰り返し実行し、長い説明、クエリに関連するハイライト、高速な生スニペットなど、必要な結果形式に基づいてプロバイダーを選択します。
出典付きアプリケーション結果
返されたURL、タイトル、説明を、生成された回答の背後にあるWebページへのリンクを表示または保持する必要があるアプリケーション向けの、出典を考慮した検索レイヤーとして使用します。
Pros and Cons
Pros
- 1つのAPIインターフェースで3つの検索プロバイダーと共通の結果形式に対応できます。
- RESTとWorkers AI bindingによるアクセスにより、一般的なバックエンドアプリケーションとCloudflare Workerデプロイの両方をサポートします。
- AI Gatewayのログと分析により、モデル推論トラフィックと並べて検索リクエストを可視化できます。
- レスポンスにはソースリンクと説明が含まれ、グラウンディングのためにAIモデルへ直接渡せます。
Cons
- この製品はオープンベータとして文書化されているため、現在のベータ版ドキュメントと運用要件に照らして本番環境への適合性を評価する必要があります。
- プロバイダーによって動作とデータ条件が異なります。たとえば、ExaはZero Data Retentionなし、Ceramic.aiとLinkupはありと記載されています。
- 検索結果は1リクエストあたり10件に制限され、APIの利用にはAI Gatewayに加えて、クレジットまたは設定済みのプロバイダー認証情報が必要です。
FAQ
Web Search APIの利用を開始するには何が必要ですか？
Cloudflareアカウント、AI Gateway、そしてAI Gatewayクレジットまたはゲートウェイに保存したプロバイダーAPIキーのいずれかが必要です。REST APIリクエストには、Account > Workers AI > ReadおよびAccount > AI Gateway > Read権限を持つCloudflare APIトークンが必要です。
Web Search APIはどのように呼び出せますか？
任意のバックエンドから/ai/websearch/エンドポイントにPOSTリクエストを送信するか、WorkerからWorkers AI bindingを通じてwebsearch()を呼び出せます。どちらの方法でもAI Gatewayを使用します。
Web Search APIは何を返しますか？
リクエストは標準のResponseオブジェクトを返します。response.json()で解析すると、レスポンスにはURL、タイトル、説明を含むitemsに加え、プロバイダーから提供される場合はクエリ、リクエストID、レイテンシなどのメタデータが含まれます。
どの検索プロバイダーと結果件数の上限に対応していますか？
providerパラメータにceramic、exa、またはlinkupを指定します。省略した場合は、デフォルトでCeramic.aiが使用されます。limitパラメータでは1～10件の結果を指定でき、デフォルトは10です。
自分のプロバイダーAPIキーを使用できますか？
はい。AI Gateway Provider Keys設定にプロバイダーキーとエイリアスを保存し、リクエストでproviderとbyokAliasを渡します。BYOKを使用すると、プロバイダーから直接請求されます。byokAliasを明示的に設定したものの利用できない場合、AI Gatewayクレジットにフォールバックせず、リクエストは失敗します。
Quick Facts
- カテゴリ
- AI開発者向けツール
- プラットフォーム
- Cloudflare AI GatewayおよびWorkers AI
- 提供状況
- オープンベータ
- プロバイダー
- Ceramic.ai、Exa、Linkup
- アクセス方法
- REST APIおよびWorkers AI binding
- デフォルトプロバイダー
- Ceramic.ai
Cloudflare Web Search APIの代替品
ClayHog
ClayHogは、ChatGPT、Gemini、Perplexity、Claude、Google AI Overviewsでのブランド表示を追跡するAI検索可視化プラットフォーム。引用、競合、感情、コンテンツ機会を1つのダッシュボードで管理できます。
Grok AI Assistant
GrokはxAIによって開発された無料のAIアシスタントであり、真実性と客観性を優先するように設計されており、リアルタイム情報アクセスや画像生成などの高度な機能を提供します。
qbrin
qbrinは、社内ナレッジを引用付き回答に変え、根拠がない場合は回答を控える企業向けAI検索・ガード付きエージェント基盤です。ソースに基づく応答、ポリシー制御、追跡可能なAI操作を必要とするチーム向け。
Octen
Octenは、ライブなWebコンテキスト、構造化された回答、エージェントやコパイロット、チャットボット向けの検索ツールを備えたAIアプリ向けの検索インフラです。検索、抽出、マルチモーダル検索に加え、API、SDK、Skills、MCP、CLIで利用できます。
Scite
Sciteは、論文の検索、引用文脈の確認、学術文献に基づく回答取得に役立つAI研究プラットフォームです。全文ソース、特許、関連研究資料を横断してエビデンスを評価できます。
Wikiwand
ユーザーがウィキペディアを利用する際の体験を向上させるために、知識の消費を効率化するAI駆動のウィキ集約ツールです。