HTTP Requestツールを使ったn8n AIエージェント向けWeb検索

カスタムノードではなくHTTP Requestノードを使うのはなぜですか？

ヘッダー1つとクエリパラメータ4つを付けたGETリクエスト1回でAPIに必要なものはすべて済むからです。n8nのドキュメントによると、HTTP Requestノードは通常のノードとして実行することも、AIエージェントにツールとして接続することもでき、一部のオプションはツール形式でのみ利用できます。

当社側でインストールや更新が必要なものは何もなく、APIキーはワークフローではなくn8nのクレデンシャルストアに保管されます。n8n専用のAPIキーを発行してください。エージェント、アプリ、チームメンバーごとに1つのAPIキーを作成し、ダッシュボードから他のキーに触れずにどれでも失効させられます。

モデルは検索クエリをどのように書くのですか？

n8nの$fromAI()関数をqフィールドの値の中で使います。ドキュメントに記載された形式は$fromAI(key, description, type, defaultValue)です。キーquery、"What to search for on the web"のような説明、型stringを使います。n8nは、$fromAI()はAI Agentノードに接続されたツールでのみ動作すると注記しています。

ツール自体についても平易な言葉で説明してください。たとえば"Searches the web and returns sources with their page text; cite the URLs"のように。エージェントはそのテキストを使って、いつ検索するかを判断します。

レスポンスを最適化をオンにするのはなぜですか？

ツールが返すものはすべてモデルのコンテキストに入るからです。レスポンスを最適化はツール専用のオプションで、モデルに渡される内容を減らします。JSON型では、データを含むフィールドをresultsに設定し、title、url、contentのみを含めます。

これによりエージェントは、本文付きの短いソース一覧だけを受け取り、それ以外は何も見えません。長さは当社側でmax_charsを使って制限でき、各ページはAPIから出る前に切り詰められます。

エージェントなしで検索をスケジュール実行できますか？

はい。HTTP RequestノードをSchedule Triggerの後ろの通常のノードとして使い、検索クエリを固定します。topic=newsとtime_range=dayを追加してあるテーマのその日の記事を集め、タイトルとURLをチャット、スプレッドシート、メールに送ります。

スケジュール実行のニュース検索を1日1回行うと月に約30クレジットなので、5,000検索（$9.25）で多くのテーマを長期間カバーできます。検索クレジットに有効期限はありません。今月使わなかった分は来年も残ります。

ページが拒否されたとき、ワークフローは何を受け取りますか？

検索自体は成功します。拒否された結果はタイトルとURLを保持し、contentはなく、content_statusに理由（blocked_by_robotsなど）が示されます。当社のリーダーはrobots.txtを尊重します。LLMWebSearchとして名乗り、サイトが自身またはすべてのロボット向けに定めたルールに従い、読み取りを許可されていないページのコンテンツは除外します。

HTTPエラーは別です。キーが誤っていると401、残高が空だと402、呼び出しが多すぎると429が返ります。エージェントでは、ツールがエラーをそのまま返すようにしてモデルが説明できるようにします。スケジュール実行のワークフローでは、エラーをログに記録する分岐へルーティングします。エラーページにはすべてのコードが記載されています。

ワークフローを構築する前に呼び出しをテストするには？

curlレシピにある同じリクエストをcurlで実行してください。ターミナルでは成功してn8nで失敗する場合は、原因はノード設定にあります。よくあるのは、クレデンシャルの値にBearer プレフィックスがない、またはqフィールドが空のケースです。