SerpCrypto SERP APIによるn8n AIエージェントでのWeb検索

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

n8nのドキュメントによると、HTTP Requestノードは通常のノードとして実行することも、AIエージェントにアタッチしてツールとして使うこともできます。これはSerpCryptoのようなREST APIをカバーしており、ヘッダーと少数のクエリパラメータを付けた1回のGETリクエストで済みます。インストールしたり最新の状態に保ったりする必要のあるコミュニティノードはありませんし、認証情報はn8nの暗号化された認証情報ストアに保持されます。

AI Agentノードにはチャットモデルと少なくとも1つのツールサブノードが必要です。n8n 1.82.0以降、すべてのAI AgentはTools Agentとして動作するため、エージェントは検索ツールをいつ呼び出すかを自分で判断します。

APIキーはどのように保存しますか？

Header Authの認証情報を作成します。n8nの認証情報のドキュメントには、ヘッダーのNameとValueという2つのフィールドが説明されており、ベアラートークンはNameをAuthorization、ValueをBearer <token>にしたヘッダー認証であると記載されています。NameにAuthorizationを、ValueにBearer とあなたのSerpCryptoキーを入れてください。

n8nには汎用のBearer認証タイプも用意されています。どちらでも同じヘッダーが送信されます。n8n専用のAPIキーを用意すれば、他のスクリプトとは別に使用状況を確認でき、必要ならそのキーだけを失効させられます。ダッシュボードからいつでも作成・失効できるAPIキー。

モデルはどのように検索クエリを埋めるのですか？

モデルにqを定義させます。対象となるパラメータフィールドの横に、値をモデルに委ねる星のボタンがn8nに表示されます。$fromAI()式を自分で入力することもでき、キー、説明、型、デフォルト値を受け取ります。説明はモデルに何を入れるべきかを伝えます。n8nのドキュメントによると、$fromAI()はAI Agentノードに接続されたツールでのみ動作します。

エージェントが1つの市場向けに動くなら、glとhlは固定してください。ユーザーがさまざまな国について尋ねる場合は、これらもモデルに設定させ、gbやdeなど期待されるコードを説明してください。

{{ $fromAI("query", "The search query, as a person would type it", "string") }}

Optimize Responseを有効にするのはなぜですか？

JSONでの完全な検索結果ページは長く、ツールが返すものはすべてモデルのコンテキストに入ります。Optimize ResponseはHTTP Requestノードのツール専用オプションで、モデルに渡されるデータを削減します。n8nによるとコストを抑えられることもあります。JSONレスポンスタイプでは、Field Containing Dataをorganic_resultsに設定し、title、link、snippetだけを選択してください。

これにより、エージェントは検索ごとにページのあらゆるブロックではなく、約10件の短いエントリを読み取ります。エージェントがローカルな質問に答える場合は、2つ目のツールのField Containing Dataをかわりにlocal_resultsに指定してください。

同じAPIを通常のワークフローで使うにはどうすればよいですか？

エージェントなしでは、HTTP Requestノードを固定のqを指定した通常のノードとして使います。たとえば、毎朝キーワードを確認するSchedule Triggerワークフローなどです。次に、Field to Split Outをorganic_resultsに設定したSplit Outノードを追加します。これによりリストが結果ごとに1アイテムとなり、スプレッドシートやデータベースのノードですぐに使えます。

各実行はキーワードごとに1回の検索なので、1日50キーワードなら月に約1,500クレジットを使います。25,000検索パック（$18.75）はそれを10倍以上カバーし、プリペイドの検索クレジットに有効期限はありません。未使用の検索は、使用するまでアカウントに残ります。

n8nの外でリクエストをテストするにはどうすればよいですか？

同じリクエストをターミナルで実行します。そこで動作すれば、n8nでの問題はノード設定に起因します。失敗する場合は、エラーボディにエラーページに記載されている原因が示されます。エラーは課金されません。

# The request the HTTP Request node sends, for a test in a terminal
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=n8n self-hosted vs cloud" -d gl=us -d hl=en \
  | jq '.organic_results[]? | {title, link, snippet}'