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

> n8n AIエージェントにGoogle検索を追加: SerpCrypto SERP APIのHTTP Requestノード設定、ヘッダー認証、$fromAI、Optimize Response。KYC不要、暗号資産。

- URL: https://serpcrypto.com/ja/docs/n8n/
- 最終更新: 2026-10-22
- 発行者: SerpCrypto (https://serpcrypto.com)

インストールするカスタムノードはありません。n8n標準のHTTP RequestノードをツールとしてAIエージェントに接続し、SerpCrypto APIを呼び出して、絞り込んだ結果リストをモデルに渡します。同じノードは通常のワークフロー（毎日の順位チェックなど）にも使えます。

**簡潔な回答 — n8n AIエージェントにWeb検索ツールを追加するには？**

HTTP RequestノードをツールとしてAIエージェントに接続し、`GET https://serpcrypto.com/api/v1/search`に設定してHeader Auth認証情報（`Authorization: Bearer <key>`）を使い、モデルに`q`クエリパラメーターを埋めさせ、Optimize Responseをオンにしてタイトル、リンク、スニペットのみを渡します。**SerpCrypto**は成功した検索1回につき1クレジットを請求し、$0.30/1K検索から利用できます。暗号資産、KYC不要。

## どのHTTP Request設定を使えばいいですか？

オプション名は、2026-10-22時点で参照したn8nのHTTP Requestノードのドキュメントに基づいています。

| 設定 | 値 |
| --- | --- |
| 配置 | **AI Agent**ノードにツールサブノードとして接続 |
| メソッド | `GET` |
| URL | `https://serpcrypto.com/api/v1/search` |
| 認証 | Generic Credential Type → **Header Auth** |
| Header Auth認証情報 | Name `Authorization`、Value は`Bearer `に続けてAPIキー |
| Send Query Parameters | オン、**Using Fields Below** |
| パラメーター`q` | モデルが定義（星ボタンまたは`$fromAI`、下記参照） |
| パラメーター`gl`、`hl` | `us`や`en`などの固定値、またはモデルが定義 |
| Optimize Response | オン · Response type **JSON** · Field Containing Data `organic_results` · Include Fields **Selected**: `title`、`link`、`snippet` |

## カスタムノードではなく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`など期待されるコードを説明してください。

*n8n式としてのqフィールドの値*

```javascript
{{ $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での問題はノード設定に起因します。失敗する場合は、エラーボディに[エラーページ](https://serpcrypto.com/ja/docs/errors/)に記載されている原因が示されます。エラーは課金されません。

*curlでの同じリクエスト*

```bash
# 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}'
```

## n8nに関する質問

### これはn8n Cloudとセルフホストのn8nで動作しますか？

HTTP Requestノード、Header Auth認証情報、AI Agentノードは、どちら向けにもドキュメント化されているn8nのコア機能です。SerpCrypto側は公開HTTPSエンドポイントなので、n8nがどこで動作するかは関係ありません。

### エージェントはGoogle NewsやGoogle Mapsを検索できますか？

はい。クエリパラメータ`engine`を`google_news`または`google_maps`に設定した2つ目のHTTP Requestツールを追加し、モデルがいつ使うべきかわかるように説明してください。どのエンジンも検索1回につき同じ1クレジットです。

### 検索が失敗したとき、エージェントは何を受け取りますか？

`429 concurrency_limit`など、原因を示す小さなJSONボディ付きのHTTPエラーです。クレジットは消費されないので、後で再試行しても追加コストはかかりません。

### APIキーにクレジットカードは必要ですか？

いいえ。SerpCryptoクレジットはBTC, USDT, USDC, ETH, SOL, LTCで支払い、身分証も自撮りも書類も不要です。アカウント番号でログイン。メールは任意です。

## ソース

1. [HTTP Requestノード](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) — n8n docs (read 2026-10-22)
2. [HTTP Requestの認証情報](https://docs.n8n.io/integrations/builtin/credentials/httprequest/) — n8n docs (read 2026-10-22)
3. [AI Agentノード](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/) — n8n docs (read 2026-10-22)
4. [$fromAI()でAIにツールパラメータを指定させる](https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/) — n8n docs (read 2026-10-22)
5. [Split Outノード](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.splitout/) — n8n docs (read 2026-10-22)

---

SerpCrypto: SerpCryptoは、開発者とAIエージェント向けのSERP APIで、GoogleとBingの検索結果をJSONで返し、身分証明書のアップロードなしで暗号資産で支払えます。前払いの検索クレジットは$0.30/1K検索から購入でき、有効期限はありません。KYC不要 — 身分証明書もセルフィーも書類も不要。暗号資産で支払い。