n8n統合

Scavioは公式のn8n検証済みコミュニティノード n8n-nodes-scavioを提供しています。このノードを任意のn8nワークフローに追加するだけで、HTTPノードを作成したりカスタム認証ヘッダーを管理することなく、Google、Amazon、Walmart、YouTube、Redditを横断したリアルタイム検索を実行できます。このノードはusableAsToolとしても登録されているため、n8nのAIエージェントノードに直接接続することも可能です。

確認済みステータス

• npm上のパッケージ: n8n-nodes-scavio
• n8nチームに承認されており、次のn8nリリースバッチで検証済みコミュニティノードとして配布されます。
• ソースコード: github.com/scavio-ai/n8n-nodes-scavio
• ライセンス: MIT

前提条件

1. n8n バージョン1.0以降（クラウドまたはセルフホスト）。
2. dashboard.scavio.devから取得したScavio APIキー。

インストール (n8n Cloud および セルフホスト)

n8n内で、設定 → コミュニティノード → インストールを開き、パッケージ名を入力します：

n8n-nodes-scavio

インストールをクリックします。n8nが最新の検証済みバージョンをnpmから取得し、ワークフローエディタにScavioノードを登録します。n8n Cloudでは再起動は不要です。セルフホストの場合はリロードが必要な場合があります。

インストール (手動 / Docker)

パッケージを直接指定したいセルフホストインスタンス向け：

# n8nコンテナまたはホスト内で実行
npm install n8n-nodes-scavio

# ノードを読み込むためにn8nを再起動
n8n start

Dockerデプロイの場合、インストールされたパッケージを含むボリュームをマウントするか、n8nイメージを拡張してビルドの一部としてnpm install n8n-nodes-scavioを実行します。

認証情報の設定

1. n8nで、認証情報 → 新規を開き、Scavio APIを選択します。
2. Scavio APIキーをAPI Keyフィールドに貼り付けます。キーはn8nによって暗号化されて保存されます。
3. テストをクリックします。認証情報テストは、Scavio APIのGET /api/v1/usage（無料のエンドポイント）を呼び出すため、クレジットを消費せずにキーが有効であることを即座に確認できます。

Scavioノードの使用

1. ワークフローに新しいノードを追加し、Scavioを検索します。
2. リソースを選択します：
   • Google — 有機SERP検索。
   • Amazon — 12のマーケットプレイスにわたる商品検索とASINによる商品詳細。
   • Walmart — フルフィルメントと価格フィルター付きの商品検索と商品詳細。
   • YouTube — 動画検索とメタデータ。
   • Reddit — 投稿検索とIDによる完全な投稿＋コメントツリー。
   • Account — API使用量と残りクレジットの確認。
3. そのリソースに対するオペレーションを選択します（例：Search、Get Product、Get Post）。
4. オペレーションパラメータを入力します（クエリ文字列、国、ASIN、投稿IDなど）。
5. ノードを実行します。出力は構造化されたJSONで、後続のノードで直接読み取ることができます。

n8n AIエージェントノード内でのツールとしての使用

ScavioノードはusableAsTool: trueで登録されているため、n8nのAIエージェントノードがマルチステップ推論の中でツールとして呼び出すことができます。Scavioノードをエージェントのツール入力に接続すると、エージェントは実行中に必要に応じてScavio: Google Search、Scavio: Amazon Search Productsなどを呼び出します。

利用可能なオペレーション

ワークフロー例

Scavioノードがうまく適合する一般的なパターン：

• リードの質評価 — インバウンドWebhook → Scavio (Google · site:linkedin.com/company 会社名) → LLMスコアリング → CRM書き込み。
• Amazon価格下落アラート — Cron → Scavio (Amazon · Get Product by ASIN) → 前回の価格と比較 → Slackアラート。動作するワークフロー例がリポジトリにworkflows/amazon-price-drop.jsonとして含まれています。
• Reddit感情モニタリング — Cron → Scavio (Reddit · Search Posts) → LLM要約 → 日次ダイジェストメール。
• ローカライズされたコンテンツ自動化 — 日次Cron → Scavio (Google + Reddit) でライブのローカルコンテキスト取得 → LLMが投稿を作成 → クライアント承認用Googleスプレッドシート。
• グラウンディングされたWhatsApp/Slackボット — メッセージトリガー → Scavio (Google) でライブ回答のグラウンディング → LLMが返信を作成 → チャンネル返信。

ノードの更新

n8nはnpmで検証済みノードの新しいバージョンを監視し、簡単な再レビューの後に自動的に配布します。セルフホストのn8nで手動更新を強制するには：

npm install n8n-nodes-scavio@latest
n8n start

トラブルシューティング

• 認証情報テストが失敗する: APIキーが dashboard.scavio.dev から取得した完全なsk_live_プレフィックス付きキーであること、およびネットワークがhttps://api.scavio.devに到達できることを確認してください。
• インストール後にエディタにノードが表示されない: セルフホストの場合、n8nプロセスを再起動してコミュニティノードを再登録してください。
• 429 / レート制限エラー: レート制限のドキュメントと、リトライのガイダンスについては エラーリファレンスを参照してください。

リソース

• npm上のn8n-nodes-scavio
• GitHub上のソース
• n8nコミュニティノードインストールガイド
• Scavio APIクイックスタート
• Google Search APIリファレンス