> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapier

> 将 Decodo Web Data API 连接到 Zapier：在 Zap 中获取网页、批量抓取 URL 列表，以及运行 Google 或 Amazon 搜索，无需编写代码。

Decodo [**Zapier 集成**](https://zapier.com/apps/decodo/integrations)可将 Web Data API 连接到您的 Zap。您可以获取网页、批量抓取 URL 列表，或运行 Google 和 Amazon 搜索，然后将页面内容或解析后的结果传递给下一个步骤——电子表格、AI 步骤或 Slack 消息——全程无需编写代码。

> [!NOTE]
>
> 源代码和最新版本请查看 [**zapier 仓库**](https://github.com/Decodo/zapier)。

> [!NOTE]
>
> 下文中加粗的名称是 Zapier 界面中的英文字段和操作名称，请按原文在界面中查找。

## 操作

该集成提供三个操作（action），不提供触发器（trigger）。请使用其他应用的触发器启动您的 Zap，或使用 **Schedule by Zapier**。

| 操作 | 功能 |
| - | - |
| **Fetch URL** | 抓取单个页面，返回 Markdown、HTML 或 PNG 屏幕截图 |
| **Fetch URL List** | 单次运行最多抓取 25 个 URL，返回每个页面的内容，以及计数和失败详情 |
| **Run Search** | 运行 Google 或 Amazon 搜索，返回解析后的结果或页面内容 |

## 设置

1. 从 [**Web Data API 演练场**](https://dashboard.decodo.com/web-data/playground)复制您的 Web Data API 密钥。任意 [**Web Data API 计划**](https://dashboard.decodo.com/web-data/pricing)均可使用。[**控制面板**](https://dashboard.decodo.com/)提供免费试用。
2. 在您的 Zap 中添加一个步骤，搜索 **Decodo**。
3. 选择 **Fetch URL**、**Fetch URL List** 或 **Run Search**。
4. 将 API 密钥粘贴到 **API Key** 字段中，以连接您的 Decodo 账户。Zapier 会先与 Decodo 校验该密钥，然后再保存连接。
5. 配置该操作，测试该步骤，并将返回的字段映射到下一个步骤中。

> [!TIP]
>
> 建议先在 [**Web Data API 演练场**](https://dashboard.decodo.com/web-data/playground)中试跑您的 URL 或搜索。演练场中的设置与 Zapier 中的字段一一对应。

## Fetch URL 和 Fetch URL List

这两个操作都使用 `universal` 目标抓取页面，并共用同一套设置：

| 字段 | 默认值 | 说明 |
| - | - | - |
| **URL** / **URLs** | – | 要获取的页面，或最多 25 个页面。必填。对于列表，请每行填写一个 URL，或从前序步骤映射一个以逗号分隔的列表 |
| **Return markdown** | 开启 | 返回干净的 Markdown，而不是原始 HTML。最适合将内容传递给 AI 步骤 |
| **Headless** | HTML | 先在浏览器中加载页面并运行其 JavaScript。设置为 **Screenshot (PNG)** 可获取图片；留空则不使用浏览器抓取，速度更快 |
| **Location** | – | 发送请求的来源国家或城市，例如 `United States`。[了解更多](https://help.decodo.com/docs/cn/web-scraping-api-localisation.md) |
| **Device type** | – | Desktop 或 Mobile |

> [!NOTE]
>
> 只有在关闭 **Return markdown** 后，才会出现 **Screenshot (PNG)** 选项。

**Fetch URL** 返回 `content`、`url`、`status_code`、`task_id`、`created_at` 和 `updated_at`。

**Fetch URL List** 每次获取最多 10 个 URL，并返回：

| 字段 | 说明 |
| - | - |
| `requested` | 列表中的 URL 数量 |
| `scraped` | 返回的页面数量 |
| `failed` | 失败或被略过的 URL 数量 |
| `results` | 每个页面一个条目，字段与 **Fetch URL** 相同 |
| `errors` | 每个失败的 URL 一个条目，包含 `url` 和 `message` |

只要至少返回一个页面，该次运行就算成功，因此在使用 `results` 之前请先检查 `failed` 和 `errors`。只有当没有任何页面返回时，该次运行才会失败。

## Run Search

请先选择 **Search Type**。其余字段取决于该选择：

| 字段 | Search SERP | Search E-Commerce |
| - | - | - |
| **Search query** | 必填 | 必填 |
| **Return parsed results** | 开启 | 开启 |
| **Return markdown** | 关闭，仅在关闭解析结果后显示 | 关闭，仅在关闭解析结果后显示 |
| **Headless** | 可选 | 可选 |
| **Location** | 可选 | 可选 |
| **Locale** | 可选，界面语言，例如 `en-GB` | – |
| **Domain** | – | 可选，区域性 Amazon 站点，例如 `co.uk`。默认为 `com` |

**Search SERP** 调用 [**Google 搜索**](https://help.decodo.com/docs/cn/web-scraping-api-google-search.md)目标，**Search E-Commerce** 调用 [**Amazon 搜索**](https://help.decodo.com/docs/cn/web-scraping-api-amazon-search.md)。开启 **Return parsed results** 后，结果会以结构化字段返回，可映射到后续步骤中。关闭该选项则会返回页面本身，格式为 HTML、Markdown 或屏幕截图——若需屏幕截图，请同时关闭 **Return markdown** 并将 **Headless** 设置为 **Screenshot (PNG)**。

> [!TIP]
>
> 对于开启了 **Return markdown** 的 **Search SERP**，请将 **Headless** 留空。同时使用 Markdown 和 JavaScript 渲染抓取 Google 速度很慢且经常失败，而仅使用 Markdown 通常几秒内即可返回。

## 限制

* **时间限制**：每个 Decodo 请求有 25 秒超时，且整个操作必须在 Zapier 的 [**30 秒限制**](https://docs.zapier.com/platform/build/troubleshoot-action-timeouts)内完成。如果某个步骤超时，请关闭 **Headless** 或减少单次运行的 URL 数量。
* **URL 列表大小**：**Fetch URL List** 每次运行最多接受 25 个 URL。更长的列表请拆分到多次运行中。
* **输出大小**：一次 URL 列表运行最多返回约 5 MB 内容。超出部分的页面即便已被抓取，也会在 `errors` 中列为被略过。

## 示例工作流

* **将搜索结果写入电子表格**：按计划运行 Run Search，然后将解析后的结果映射为 Google Sheets 的行。
* **为 AI 步骤提供网页内容**：以 Markdown 格式获取页面，并将 `content` 传递给摘要或分析步骤。
* **从 URL 列表中提取数据**：将前序步骤中的 URL 映射到 Fetch URL List，处理 `results`，并将 `errors` 路由出去以供人工复查。

***

## 相关内容

* [**n8n**](https://help.decodo.com/docs/cn/n8n.md)：在 n8n 的可视化自动化平台中构建抓取工作流。
* [**MCP 服务器**](https://help.decodo.com/docs/cn/mcp.md)：将 AI 智能体和兼容 MCP 的工具连接到 Decodo。
* [**Web Data API 演练场**](https://dashboard.decodo.com/web-data/playground)：在构建 Zap 之前测试目标和设置。

***

> [card] [支持](https://direct.lc.chat/12092754)
>
> 需要帮助或只是想打个招呼？我们的支持团队全天候为您服务。 \
> 您也可以随时通过电子邮件 [support@decodo.com](mailto:support@decodo.com) 联系我们。

> [card] [反馈](mailto:feedback@decodo.com)
>
> 找不到您要找的内容？请求一篇文章！ \
> 有反馈意见？分享您对我们如何改进的想法。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.