n8n Integration

Scavio ships an official, n8n-verified community node: n8n-nodes-scavio. Drop it into any n8n workflow to run real-time search across Google, Amazon, Walmart, YouTube, and Reddit without writing HTTP nodes or maintaining custom auth headers. The node is also usableAsTool, so you can attach it directly to an n8n AI Agent node.

Verified status

Prerequisites

  1. n8n version 1.0 or later (cloud or self-hosted).
  2. A Scavio API key from dashboard.scavio.dev.

Install (n8n Cloud and self-hosted)

Inside n8n, open Settings → Community Nodes → Install and enter the package name:

Text
n8n-nodes-scavio

Click Install. n8n will pull the latest verified version from npm and register the Scavio node in your workflow editor. No restart required on n8n Cloud; self-hosted may need a reload.

Install (manual / Docker)

For self-hosted instances that prefer to pin the package directly:

Bash
# Inside your n8n container or host
npm install n8n-nodes-scavio

# Then restart n8n so the node is loaded
n8n start

For Docker deploys, mount a volume that includes the installed package or extend the n8n image and run npm install n8n-nodes-scavio as part of the build.

Configure credentials

  1. In n8n, open Credentials → New and pick Scavio API.
  2. Paste your Scavio API key into the API Key field. The key is stored encrypted by n8n.
  3. Click Test. The credential test calls GET /api/v1/usage on the Scavio API (a free endpoint), so you get instant feedback that the key is valid without consuming credits.

Use the Scavio node

  1. Add a new node to your workflow and search for Scavio.
  2. Pick a Resource:
    • Google — organic SERP search.
    • Amazon — product search and product detail by ASIN across 12 marketplaces.
    • Walmart — product search and product detail with fulfillment + price filters.
    • YouTube — video search and metadata.
    • Reddit — post search and full post + comment tree by id.
    • Account — check API usage and remaining credits.
  3. Pick an Operation for that resource (e.g. Search, Get Product, Get Post).
  4. Fill in the operation parameters (query string, country, ASIN, post id, etc.).
  5. Run the node. The output is structured JSON your downstream nodes can read directly.

Use as a tool inside n8n AI Agent nodes

The Scavio node is registered with usableAsTool: true, so n8n AI Agent nodes can call it as a tool inside multi-step reasoning. Connect the Scavio node to the agent's tool input and the agent will call Scavio: Google Search, Scavio: Amazon Search Products, etc. as needed during a run.

Available operations

ResourceOperations
GoogleSearch
AmazonSearch Products, Get Product
WalmartSearch Products, Get Product
YouTubeSearch, Get Metadata
RedditSearch Posts, Get Post
AccountGet Usage

Example workflows

Common patterns the Scavio node fits cleanly:

  • Lead qualification — Inbound webhook → Scavio (Google · site:linkedin.com/company COMPANY) → LLM scoring → CRM write.
  • Amazon price drop alerts — Cron → Scavio (Amazon · Get Product by ASIN) → compare to previous price → Slack alert. A working example workflow ships in the repo as workflows/amazon-price-drop.json.
  • Reddit sentiment monitoring — Cron → Scavio (Reddit · Search Posts) → LLM summarization → daily digest email.
  • Localized content automation — Daily cron → Scavio (Google + Reddit) for live local context → LLM composes posts → Google Sheet for client approval.
  • Grounded WhatsApp / Slack bots — Trigger on message → Scavio (Google) for live answer grounding → LLM composes reply → channel reply.

Update the node

n8n monitors npm for new versions of verified nodes and propagates them automatically after a quick re-review. To force a manual update on self-hosted n8n:

Bash
npm install n8n-nodes-scavio@latest
n8n start

Troubleshooting

  • Credential test fails: confirm the API key is the full sk_live_ prefixed key from dashboard.scavio.dev and that your network can reach https://api.scavio.dev.
  • Node not appearing in editor after install: on self-hosted, restart the n8n process so it re-registers community nodes.
  • 429 / rate-limit errors: see the rate limits docs and the errors reference for retry guidance.

Resources