組み込みWeb検索ツール vs 検索API：エージェントが実際に支払うもの

組み込みツールのコストがその料金より高くなるのはなぜですか？

読み取ったページが入力トークンとして返ってくるからです。OpenAIは検索コンテンツをモデルのレートで課金し、miniモデルでは呼び出しごとに8,000入力トークンを固定で計上します。Claudeは検索結果を入力トークンとして課金し、その後も会話の各ターンで再度計上されます。

呼び出しごとの料金は見える部分にすぎません。トークン部分はタスクごとの検索回数と会話の長さに応じて増えます。また、ほとんどの組み込みツールは何回検索するかを自ら決定します。

計算例はどのようなものですか？

これは明示した前提に基づく試算であり、見積もりではありません。 月に100,000回の検索を実行するエージェントを例にします。

• 1,000回あたり$10の組み込みツール： ツール料金は$1,000。これにコンテンツトークンが加わります。呼び出しあたり8,000トークン固定とすると、8億入力トークンになります。入力100万トークンあたり$1.00と仮定すると（概算値であり、ベンダー価格ではありません）、$800が加算されます。合計：約$1,800。
• 単体API： LLMWebSearchでは、100,000回の検索で$145かかり、各検索は上位3ページを返します。モデルは渡したテキストを引き続き読み取ります。3ページそれぞれから1,500トークンを送ると、4億5,000万トークンとなり、同じ仮定レートで約$450です。合計：約$145に$450を加えた額。

差額は2つの要因から生じます。呼び出しごとの料金と、モデルに届くテキスト量の制御です。単体APIではreadとmax_charsを設定でき、エージェントに不要なページを除外できます。

組み込みツールがより適した選択となるのはどんな場合ですか？

コードを最小限にしたいとき。組み込みツールなら2つ目のアカウントも、APIキーも、ツール定義も不要です。モデルへのリクエストでオンにするだけです。検索回数が少ない短いチャットにも向いていて、トークンの追加分も小さく済みます。

Geminiの有料ティアでは月5,000回のグラウンディング付き検索クエリが無料なので、多くのプロトタイプをカバーできます。Claudeのweb_fetchには呼び出しごとの課金がないため、既知のURLを取得するコストはトークンだけです。また、どうしてもプロバイダーの引用をそのままの形式で表示する必要があるなら、組み込みツールがすでにそれをやってくれます。

単独の検索APIがより適しているのはどんなときですか？

生の検索結果が必要なとき、1つのタスクで多数の検索を行うとき、あるいは同じツールを複数のモデルで使いたいときです。単独のAPIはランキング済みの検索結果とページ本文をあなたのコードに返します。キャッシュしたり、再ランキングしたり、表示したり、OpenAI、Claude、Gemini、オープンウェイトのモデルなど任意のモデルに渡したりできます。

また、特定プロバイダーのルールに縛られることも避けられます。Grounding with Bingは検索結果を他のアプリケーションに渡しません。Googleは検索候補の表示を義務付けています。単独のAPIなら、結果はそのベンダーの規約の下で自由に扱えます。ただしその規約も読んでください。Braveのデフォルト規約は結果の保存を禁じており、TavilyとExaの規約はあなたの入力と出力に対する権利を留保しています。

単独の検索APIはOpenAIやClaudeのモデルで使えますか？

はい、functionツールとして使えます。モデルにweb_search関数を記述し、モデルが呼び出したら検索を実行して結果を返します。OpenAI function-callingガイドではPythonでの一連の流れを紹介しており、MCPサーバーを使えば同じ検索をClaude Desktop、Claude Code、Cursorに組み込めます。コストガイドは月額費用の見積もりに役立ちます。