n8n集成

Scavio提供官方的、经n8n验证的社区节点： n8n-nodes-scavio。将其添加到任何n8n工作流中即可跨Google、 Amazon、Walmart、YouTube和Reddit运行实时搜索，无需编写HTTP节点或维护自定义认证头。该节点也支持 usableAsTool，因此您可以将其直接附加到n8n AI Agent节点。

验证状态

npm包： n8n-nodes-scavio
已通过n8n团队审核，作为经验证的社区节点在下一批n8n发布中上线
源代码： github.com/scavio-ai/n8n-nodes-scavio
许可证：MIT

前提条件

n8n 1.0或更高版本（云端或自托管）。
从 dashboard.scavio.dev 获取的Scavio API密钥。

安装（n8n Cloud及自托管）

在n8n中，打开 Settings → Community Nodes → Install，输入包名：

Text

n8n-nodes-scavio

点击 Install。n8n将从npm拉取最新的验证版本，并在工作流编辑器中注册 Scavio 节点。n8n Cloud无需重启；自托管可能需要重新加载。

安装（手动 / Docker）

对于偏好直接固定包的自托管实例：

Bash

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

# Then restart n8n so the node is loaded
n8n start

对于Docker部署，挂载包含已安装包的卷，或扩展n8n镜像并在构建过程中运行 npm install n8n-nodes-scavio。

配置凭证

在n8n中，打开 Credentials → New 并选择 Scavio API。
将您的Scavio API密钥粘贴到 API Key 字段中。密钥由n8n加密存储。
点击 Test。凭证测试调用Scavio API的 GET /api/v1/usage（免费端点），因此您可以即时验证密钥有效性而不消耗积分。

使用Scavio节点

在工作流中添加新节点并搜索 Scavio。
选择一个 Resource：
- Google — 有机SERP搜索。
- Amazon — 产品搜索和按ASIN获取产品详情，覆盖12个市场。
- Walmart — 产品搜索和带配送+价格过滤的产品详情。
- YouTube — 视频搜索和元数据。
- Reddit — 帖子搜索和按ID获取完整帖子+评论树。
- Account — 检查API使用量和剩余积分。
为该资源选择一个 Operation（如 Search、Get Product、Get Post）。
填写操作参数（查询字符串、国家、ASIN、帖子ID等）。
运行节点。输出是结构化JSON，下游节点可直接读取。

在n8n AI Agent节点中作为工具使用

Scavio节点注册了 usableAsTool: true，因此n8n AI Agent节点可以在多步推理中将其作为工具调用。将Scavio节点连接到智能体的工具输入，智能体将在运行过程中根据需要调用 Scavio: Google Search、 Scavio: Amazon Search Products 等。

可用操作

资源	操作
`Google`	Search
`Amazon`	Search Products, Get Product
`Walmart`	Search Products, Get Product
`YouTube`	Search, Get Metadata
`Reddit`	Search Posts, Get Post
`Account`	Get Usage

示例工作流

Scavio节点可轻松适配的常见模式：

线索鉴定 — 入站Webhook → Scavio（Google · site:linkedin.com/company COMPANY） → LLM评分 → CRM写入。
Amazon降价提醒 — 定时任务 → Scavio （Amazon · Get Product 按ASIN） → 与历史价格对比 → Slack提醒。仓库中包含一个可用的示例工作流 workflows/amazon-price-drop.json。
Reddit舆情监控 — 定时任务 → Scavio（Reddit · Search Posts） → LLM 摘要 → 每日摘要邮件。
本地化内容自动化 — 每日定时任务 → Scavio（Google + Reddit）获取实时本地内容 → LLM 撰写文案 → Google Sheet供客户审核。
基于事实的WhatsApp / Slack机器人 — 消息触发 → Scavio（Google）获取实时答案依据 → LLM 生成回复 → 频道回复。

更新节点

n8n监控npm上验证节点的新版本，并在快速复审后自动分发。要在自托管n8n上强制手动更新：

Bash

npm install n8n-nodes-scavio@latest
n8n start

故障排除

凭证测试失败：确认API密钥是来自 dashboard.scavio.dev 的完整 sk_live_ 前缀密钥，且您的网络可以访问 https://api.scavio.dev。
安装后节点未出现在编辑器中：在自托管环境中，重启n8n进程以重新注册社区节点。
429 / 速率限制错误：参阅速率限制文档和错误参考获取重试指导。

资源

n8n集成

安装（手动 / Docker）

对于偏好直接固定包的自托管实例：

Bash

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

# Then restart n8n so the node is loaded
n8n start

对于Docker部署，挂载包含已安装包的卷，或扩展n8n镜像并在构建过程中运行 npm install n8n-nodes-scavio。

使用Scavio节点

在工作流中添加新节点并搜索 Scavio。

选择一个 Resource：

Google — 有机SERP搜索。
Amazon — 产品搜索和按ASIN获取产品详情，覆盖12个市场。
Walmart — 产品搜索和带配送+价格过滤的产品详情。
YouTube — 视频搜索和元数据。
Reddit — 帖子搜索和按ID获取完整帖子+评论树。
Account — 检查API使用量和剩余积分。

为该资源选择一个 Operation（如 Search、Get Product、Get Post）。

填写操作参数（查询字符串、国家、ASIN、帖子ID等）。

运行节点。输出是结构化JSON，下游节点可直接读取。

资源

操作

Google

Amazon

Search Products, Get Product

Walmart

Search Products, Get Product

YouTube

Search, Get Metadata

Reddit

Search Posts, Get Post

Account

Get Usage

示例工作流

Scavio节点可轻松适配的常见模式：

线索鉴定 — 入站Webhook → Scavio（Google · site:linkedin.com/company COMPANY） → LLM评分 → CRM写入。

Amazon降价提醒 — 定时任务 → Scavio （Amazon · Get Product 按ASIN） → 与历史价格对比 → Slack提醒。仓库中包含一个可用的示例工作流 workflows/amazon-price-drop.json。

Reddit舆情监控 — 定时任务 → Scavio（Reddit · Search Posts） → LLM 摘要 → 每日摘要邮件。

本地化内容自动化 — 每日定时任务 → Scavio（Google + Reddit）获取实时本地内容 → LLM 撰写文案 → Google Sheet供客户审核。

基于事实的WhatsApp / Slack机器人 — 消息触发 → Scavio（Google）获取实时答案依据 → LLM 生成回复 → 频道回复。

故障排除

凭证测试失败：确认API密钥是来自 dashboard.scavio.dev 的完整 sk_live_ 前缀密钥，且您的网络可以访问 https://api.scavio.dev。

安装后节点未出现在编辑器中：在自托管环境中，重启n8n进程以重新注册社区节点。

429 / 速率限制错误：参阅速率限制文档和错误参考获取重试指导。