如何将代理接入 Zapier
Zapier 是一个自动化平台。它可以连接各类应用并在它们之间触发操作，无需您编写代码。一个“Zap”就是一条工作流：由触发器启动，随后运行一个或多个操作。
大多数 Zap 并不需要代理。Gmail 到 Slack 不需要，Google Sheets 到您的 CRM 也不需要，表单提交后发送邮件同样不需要。
代理只在更特定的场景下才有用： 当 Zap 需要发送自定义 HTTP 请求，且该请求必须通过特定的 IP 地址或地区从 Zapier 发出时.
本指南将带您完成一次真实配置。我们接入了一个 NodeMaven HTTP 代理 添加到 Zap 中，使用 Code by Zapier 和 Python，进行了测试，遇到报错，修复后成功发出了请求。下面就是我们的完整做法，包括其中犯的错误。
在 Zapier 中需要使用代理吗？
对大多数工作流来说，答案是否定的。
典型的 Zap 只是在各个应用之间传递数据：
- Gmail → Slack
- Google Sheets → CRM
- 新表单提交 → 邮件
这些都不需要代理。Zapier 本身已经处理了与每个应用的身份验证和连接。
当您的 Zap 需要发出对外的 HTTP 请求，并且该请求的源 IP 或所在位置很重要时，代理才会派上用场。 举几个例子：
- 查看网站针对特定地区的版本。
- 发送自动化 HTTP 请求，而目标服务会在意源 IP。
- 测试本地化页面在特定国家/地区的呈现效果。
- 从公开页面采集数据的一些网页数据收集工作流。
- 将请求分散到多个 IP，而不是全部从同一个地址发出。
Zapier 与代理如何配合使用
有两件事需要区分开：Zap 本身，以及该 Zap 某一步骤内部发出的网络请求。
Zap 是由触发器和动作步骤组成的序列。Zapier 会直接连接到各个应用的 API。并不存在一个“为整个 Zap 启用代理”的开关能作用于每个步骤。
如果您想让某个特定请求通过代理发出，就需要一个能让您直接控制 HTTP 连接的步骤。这正是 Code by Zapier 在您自己编写 Python 请求时所提供的能力。
本教程的架构如下：
代理由 Python 代码中的 requests 调用使用。它 不会作用于 Zap 中的任何其他步骤。 如果您在 Code 步骤之后再添加一个直接调用其他应用的动作，该动作不会经过代理。
还有一点值得澄清： NodeMaven 的代理端点是一个代理，而不是 API。您并不是在调用 NodeMaven 的 API 来获取数据，而是将一个普通的 HTTP 请求指向 NodeMaven 的网关地址，就像指向任何其他代理服务器一样。
为什么不直接使用 Zapier 的 Webhooks？
Webhooks by Zapier 可以让 Zapier 以触发器或操作的形式发送 HTTP 请求。它支持 GET、POST、PUT 和自定义请求，您可以设置请求头、载荷和 Basic Auth。
它所缺少的是通用的代理主机、代理端口、代理用户名和代理密码字段。Webhooks by Zapier 中没有任何设置可以将请求通过代理服务器转发。其中的 Basic Auth 是与目标 API 进行身份验证，而不是与前置的代理进行验证。
因此，本教程改用 Code by Zapier 。Python 代码步骤让您可以自行构建代理连接，使用 requests 库 库，该库在该环境中已经可用。
您需要准备什么
- 一个 Zapier 账户。 Code by Zapier 的软件包功能需要付费套餐，但这里使用的内置 requests 库无需添加外部软件包即可使用。
- 一个 NodeMaven 账户 ，并具备住宅/移动/ISP 代理访问权限。
- 您的 NodeMaven 代理主机、端口、用户名和密码.
- 一个目标 URL ，用于测试。
- Code by Zapier，使用 Run Python 选项。
本教程使用 HTTP 代理，而不是 SOCKS5。Code by Zapier 的 Python 环境运行 requests，而 requests 无需额外配置即可支持 HTTP 代理。
分步指南：在 Zapier 中配置 NodeMaven 代理
第 1 步：获取您的 NodeMaven 代理信息
登录您的 NodeMaven 控制面板并打开代理设置部分。您需要四个值：
| 字段 | 本次测试中使用的值 |
| 主机 | gate.nodemaven.com |
| 端口 | 8080 (HTTP) |
| 用户名 | 您的 NodeMaven 代理用户名 |
| 密码 | 您的 NodeMaven 代理密码 |
NodeMaven 的用户名可以包含的内容不止是账户标识符。根据您在控制面板中的配置，它还可以编码国家、地区、城市、会话 ID 以及 IP 质量筛选设置。这正是 NodeMaven 代理认证 的标准工作方式：它没有为位置和会话设置单独的字段， 这些设置就包含在用户名字符串本身之中.
如果您是第一次进行此设置，NodeMaven 官方的 住宅代理使用指南 详细介绍了如何在控制面板中生成带有位置和会话参数的用户名。
第 2 步：创建 Zap
在您的 Zapier 仪表板中：
- 点击 创建.
- 选择 Zap.
- 对于触发器，请搜索 Zapier 定时任务.
- 选择 Every Hour.
这里使用 Schedule by Zapier 只是为了提供一个简单、可重复的测试触发器。在实际工作流中，您可以将其替换为真正启动自动化的任何触发器：Google Sheets 中的新行、新的表单提交、Gmail 标签，或 Zapier 支持的任何其他触发方式。
第 3 步：添加 Code by Zapier
对于操作步骤：
- 点击 操作.
- 搜索 Code by Zapier.
- 选择 Run Python.
这里使用 Code by Zapier，是因为如上文所述，Webhooks by Zapier 没有代理配置选项。Code by Zapier 允许您编写 Python 脚本，自行构建并发送 HTTP 请求，其中包括代理连接。
请注意 Code by Zapier 目前的几项限制。其 Python 环境已预装 标准库、requests 和 BeautifulSoup 可直接使用。从 PyPI 添加其他第三方包也是可行的，但需要 付费的 Zapier 套餐.
Zapier 还建议：如果工作流需要发送多个 HTTP 请求，或需要更复杂的带身份验证的 API 调用，最好在其开发者平台上构建一个自定义应用。
第 4 步：将代理凭据添加为输入数据
在 配置 部分，添加四个 Input Data 字段：
| 密钥 | 示例值 |
| proxy_host | gate.nodemaven.com |
| proxy_port | 8080 |
| proxy_username | 您的 NodeMaven 用户名 |
| proxy_password | 您的 NodeMaven 密码 |
第 5 步：添加 Python 代码
以下是我们用于测试连接的代码的整理版本：
有几点值得特别说明：
- 代理字符串采用标准的 protocol://username:password@host:port format that requests 库 对代理的格式要求。
- 同一个代理 URL 会同时传给“http”和“https”，在 代理 字典中。这会让 requests 库 将普通 HTTP 和 HTTPS 流量都通过同一个 NodeMaven 网关路由。
- 该 超时 参数很重要。代理连接可能比直接请求更慢，而 Code by Zapier 步骤本身有执行时间限制，因此未设置超时的请求可能会一直挂起，直到被 Zapier 中断。
- api.ipify.org 是一个简单的 IP 查询端点。它会以 JSON 格式返回发起请求的公网 IP 地址。它不属于 NodeMaven 或 Zapier，这里仅用于确认请求确实是通过代理发出的。
第 6 步：测试 Zap
点击 继续，然后针对 Code by Zapier 步骤运行测试。
在我们的测试中，Code 步骤成功完成。Zapier 的编辑器显示该步骤测试成功。
在 Zapier 中使用代理可以自动化哪些任务？
- 特定地区的页面检查。 确认从某个特定国家发起请求时页面的显示效果。
- 价格监控。 按计划定时从公开页面抓取价格数据。
- 自动化 HTTP 数据采集。 从按地区返回不同响应的接口获取结构化数据。
- 检查本地化内容。 验证特定地区的跳转或内容版本是否按预期生效。
- 将 Google Sheets 中的 URL 发送到自定义 HTTP 请求。 遍历 URL 列表，并通过代理逐个抓取。
- 在表单提交后运行代理请求。 新数据一到达就立即触发查询或检查。
如果您需要采集具有一定规模的数据用于分析， NodeMaven 的 Python 网页抓取指南 介绍了超出单个 Zapier 步骤的完整配置，包括请求节奏控制和会话管理。
Zapier 中的轮换代理与粘性代理对比
NodeMaven 支持两种会话类型。
- 轮换代理: 每个请求都可以使用新的 IP。适合彼此独立、一次性的请求，请求之间无需保持连续性。
- 粘性代理： 在设定的会话期间保持同一个 IP。当工作流需要连续多个请求看起来来自同一位置时非常有用，NodeMaven 的粘性会话最长可保持 IP 达 24 小时。
如果 Zap 每小时定时触发一次，且每次只发出一个请求，使用轮换模式通常就足够了。
如果工作流需要多个相关请求看起来来自同一位置，粘性会话是更好的选择。
在 Zapier 中使用代理的最佳实践
- 匹配代理协议和端口。 如上所示，这是最常见的故障点。
- 请将凭据保存在 Input Data 字段中，不要硬编码在脚本里。
- 选用适合任务的代理类型。 在大多数目标网站上，住宅 IP 的表现与数据中心 IP 不同。
- 不要超出任务需要地轮换 IP。不必要的轮换毫无益处，还会增加排查难度。
- 请遵守目标网站或 API 的条款 以及速率限制。
- 始终 为请求设置超时时间 在该请求上。
- 在将代理接入更复杂的 Zap 之前，请先单独测试代理连接。NodeMaven 的 免费代理检测工具 能在您接触 Zapier 之前，快速确认主机、端口和凭据组合是否可用。
整套配置都在服务器端、即 Zapier 的 Python 沙箱中运行，不涉及浏览器，因此 WebRTC IP 泄露等浏览器相关问题在这里并不适用。
替代方案：使用中间件
如果 Code by Zapier 不够用，还有第二种更灵活的架构：
在这种方式下，Zapier 通过 Webhooks by Zapier 调用您自己的服务器，由服务器负责代理连接、重试和各类自定义逻辑。对于逻辑较重、每次运行需发起多个请求，或处理量超出单个 Code 步骤承载范围的工作流，这种方式更合适。
结语
Zapier 通常并不需要代理。大多数自动化只是在应用之间传输数据，从不直接发起 HTTP 请求。当某个工作流确实需要通过特定 IP 或地区发送自定义请求时， Code by Zapier 可以让您用普通的 Python 轻松实现 requests 库 调用。
如果您的 Zapier 工作流需要代理，NodeMaven 提供 HTTP 和 SOCKS5 代理 并支持在控制面板中配置地区和会话选项，以满足不同的自动化需求。
