> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/zh/pa-qu/serp-api/ji-cheng/sdk-ji-cheng/ru-he-jiang-thordata-yu-n8n-ji-cheng.md).

# 如何将ThorData与n8n集成

安装 Thordata n8n 节点，配置 SERP API 凭据，运行本地化搜索工作流，并将结构化结果传递给 AI Agent、数据库或通知服务。

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

你可以透过 <kbd>n8n-nodes-thordata-serp</kbd> 社群节点将 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社区节点的权限。
* 一个以<kbd>sk\_</kbd>开头的 [**ThorData SERP API Key**](https://dashboard.thordata.com/serp-api/get-started)。

**具体步骤**

{% stepper %}
{% step %}
**安装**

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

* 开启你的 n8n 实例。
* 创建新工作流，或打开已有工作流进行编辑，并搜索 thordata。
* 点击安装节点。

**安装完成后，n8n会新增：**

* 一个名为 <mark style="color:pink;">`Thordata SERP API`</mark> 的凭证类型。
* 一个名为 <mark style="color:pink;">`Thordata SERP`</mark> 的工作流节点。
  {% endstep %}

{% step %}
**配置凭证**

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

* 在 n8n 中开启 <kbd>Credentials</kbd>。
* 新建凭证，并选择 <kbd>Thordata SERP API</kbd>。
* 粘贴你的 <kbd>ThorData SERP API Key</kbd>。
* 除非你正在测试内部开发环境，否则保持默认 endpoint。
* 储存或测试该凭证。

{% hint style="success" icon="filter" %}
凭证测试请求和工作流执行请求都会向ThorData发送以下来源标识，用于平台使用统计：
{% endhint %}

```
Origin: n8n
```

{% endstep %}

{% step %}
**创建第一个工作流**

在n8n中运行ThorData搜索：

* 创建一个新工作流，或开启已有工作流。
* 新增 <kbd>Thordata SERP</kbd> 节点。
* 选择你的 Thordata SERP API 凭证。
* 选择一个 <kbd>Operation</kbd>，例如 <kbd>Google Search</kbd>。
* 填写该操作显示的字段。
* 执行节点。

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

**示例：Google Search**

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

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

{% hint style="info" icon="sliders-simple" %}
典型场景包括市场调研、SEO监控、竞品分析，以及检索增强型AI工作流。
{% endhint %}

**示例：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**

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

```
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`。

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

**支持的操作**

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

<table data-search="false"><thead><tr><th width="367">分类</th><th>支持的操作</th></tr></thead><tbody><tr><td>网页搜索</td><td>Google Search、Bing Search、DuckDuckGo Search、Yandex Search</td></tr><tr><td>图片</td><td>Google Images、Bing Images、Google Lens</td></tr><tr><td>新闻</td><td>Google News、Bing News</td></tr><tr><td>电商</td><td>Google Shopping、Google Play</td></tr><tr><td>研究</td><td>Google Scholar、Google Patents</td></tr><tr><td>本地与出行</td><td>Google Maps、Google Hotels、Google Flights</td></tr><tr><td>市场与趋势数据</td><td>Google Finance、Google Trends</td></tr></tbody></table>

{% hint style="info" %}
每个显式操作只会显示该 action 支援的参数。如需传入未显示在表单中的进阶参数，请使用 <kbd>Extra Parameters JSON</kbd>。
{% endhint %}

**故障排查**

**401或403错误**

请检查：

* API Key是否以 <kbd>sk\_</kbd> 开头。
* 凭证类型是否为 <mark style="color:pink;">`Thordata SERP API`</mark>。
* 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节点，用于自定义过滤、排序、抽取或数据增强逻辑。