如何将ThorData与n8n集成

本教程介绍如何安装ThorData n8n节点、配置SERP API凭证，并运行你的第一个搜索工作流。

你可以透过 n8n-nodes-thordata-serp 社群节点将 ThorData 整合到 n8n。完成设定后，即可在 n8n 工作流程中直接调用 ThorData SERP API，从 Google、Bing、DuckDuckGo、Yandex 等搜寻引擎取得结构化搜寻结果。

概览

n8n是一个工作流自动化平台，可通过视觉化方式连接应用、API和AI Agent。 ThorData提供SERP API能力，适用于实时搜索结果获取、当地化搜索分析、SEO监控、市场调研以及Agent驱动的Web数据工作流。

通过ThorData n8n集成，你可以：

• 在 n8n 中运行 Google、Bing、DuckDuckGo、Yandex 等 SERP 搜寻。

• 使用国家/地区、语言、设备、市场等本地化搜寻参数。

• 将搜寻结果连接到 AI Agent、报告管线、警告、数据增强等工作流。

• 在需要更高控制度的场景下，透过原始请求模式传入高阶 SERP 参数。

前置条件

开始之前，请确保你已经具备：

• 一个可用的n8n实例。

• 安装n8n社区节点的权限。

• 一个以sk_开头的 ThorData SERP API Key。

具体步骤

1

安装

在 n8n 的 Community Nodes 面板中安装 ThorData 节点：

• 开启你的 n8n 实例。

• 创建新工作流，或打开已有工作流进行编辑，并搜索 thordata。

• 点击安装节点。

安装完成后，n8n会新增：

• 一个名为 Thordata SERP API 的凭证类型。

• 一个名为 Thordata SERP 的工作流节点。

2

配置凭证

在将节点加入生产工作流之前，建议先创建ThorData凭证：

• 在 n8n 中开启 Credentials。

• 新建凭证，并选择 Thordata SERP API。

• 粘贴你的 ThorData SERP API Key。

• 除非你正在测试内部开发环境，否则保持默认 endpoint。

• 储存或测试该凭证。

凭证测试请求和工作流执行请求都会向ThorData发送以下来源标识，用于平台使用统计：

Origin: n8n

3

创建第一个工作流

在n8n中运行ThorData搜索：

• 创建一个新工作流，或开启已有工作流。

• 新增 Thordata SERP 节点。

• 选择你的 Thordata SERP API 凭证。

• 选择一个 Operation，例如 Google Search。

• 填写该操作显示的字段。

• 执行节点。

节点会传回ThorData SERP JSON 回应，以及所选操作的请求元数据。你可以将输出结果传递给下游 n8n 节点，例如 AI Agent、Code 节点、数据库、表格、通知或报告工具。

示例：Google Search

当你需要从 Google 取得常规网页搜寻结果时，可以使用该操作。

Operation: Google Search
Search Query: coffee
Country/Region: United States
Language: English
Number of results: 10

典型场景包括市场调研、SEO监控、竞品分析，以及检索增强型AI工作流。

示例：Bing Image Search

当工作流需要从Bing获取图片搜索结果时，可以使用该操作。

Operation: Bing Image Search
Search Query: coffee
Country/Region: United States
Market: en-US
Result count: 10

示例：Google Lens Search

当工作流以图片URL作为输入时，可以使用Google Lens Search。

Operation: Google Lens Search
Image URL: https://example.com/image.png

示例：Yandex Search

当工作流需要Yandex SERP结果时，可以使用Yandex Search。

Operation: Yandex Search
Search Query: coffee

高级用法：Raw SERP Request

当你希望选择一个已生成的SERP action，同时手动传入高级参数时，可以使用Raw SERP Request。

Operation: Raw SERP Request
Raw Action: Google Lens Search
Raw Query: https://example.com/image.png
Extra Parameters JSON: {"hl":"en"}

节点会根据所选action自动使用正确的查询字段，例如 q、text、url、product_id、patent_id、author_id 或 trend。

Extra Parameters JSON 必须是合法的JSON对象。 该字段会在可见表单字段之后合并到请求中。 节点会控制 engine 和默认的 json=2 值，囙此额外参数不能覆盖已选择的搜寻引擎。

支持的操作

Thordata SERP 节点会暴露由ThorData元数据生成的SERP action。 操作清单包括：

分类	支持的操作
网页搜索	Google Search、Bing Search、DuckDuckGo Search、Yandex Search
图片	Google Images、Bing Images、Google Lens
新闻	Google News、Bing News
电商	Google Shopping、Google Play
研究	Google Scholar、Google Patents
本地与出行	Google Maps、Google Hotels、Google Flights
市场与趋势数据	Google Finance、Google Trends

每个显式操作只会显示该 action 支援的参数。如需传入未显示在表单中的进阶参数，请使用 Extra Parameters JSON。

故障排查

401或403错误

请检查：

• API Key是否以 sk_ 开头。

• 凭证类型是否为 Thordata SERP API。

• API Key 是否已过期或被禁用。

如有需要，请在ThorData中生成新的SERP API Key，并更新n8n凭证。

400错误

请检查：

• 所选操作是否填写了必需的查询字段或URL字段。

• Extra Parameters JSON 是否为合法 JSON。

• 参数是否与所选SERP操作匹配。

429错误

如果工作流触发限流，可以尝试：

• 降低n8n工作流并发。

• 在请求之间增加批次处理或延迟节点。

• 检查你的ThorData配额和速率限制。

网络错误

如果n8n无法访问ThorData，请检查：

• n8n运行环境是否可以访问 https://serpapi.thordata.net。

• 如果你的环境要求出站代理，请在n8n运行环境层面配置代理。

• 检查部署环境中的防火墙、DNS或区域网络限制。

下一步

节点配置完成后，你可以将ThorData SERP结果连接到：

• AI Agent节点，为模型提供实时搜索上下文。

• 数据库或表格节点，用于周期性SERP跟踪。

• 通知节点，用于新闻、排名或竞品变化告警。

• Code节点，用于自定义过滤、排序、抽取或数据增强逻辑。