n8n 节点 - 辅助集成

这是一个n8n社区节点,整合 说明 使用您的 n8n 工作流程,您可以运行 Appify Actors, 从网站提取结构化数据, 以及自动化复杂的网络刮取任务 .

说明 是开发者建立、部署和发布网络自动化工具的平台,同时 无 8n 是一个 获得公平代码许可 用于 AI 工作流程自动化的工具,允许您连接各种服务.

目录

• 安装自主机实例
• 在n8n云上安装
• 安装用于发展和贡献
• 业务
• 全权证书
• 兼容性
• 使用量
• 资源
• 释放
• 版本历史
• 解决问题

安装(自备)

要直接从 n8n 编辑器 UI 安装辅助社区节点:

1. 打开你的n8n实例.
2. 转到 设置 > 社区节点
3. 选择 安装。 。 。 .
4. 输入 npm 包名 : @apify/n8n-nodes-apify 以安装最新版本。 安装特定版本( 如 0. 6.4) 输入 @apify/[email protected]。所有版本均可使用 这里
5. 同意 风险 使用社区节点并选择 安装
6. 该节点现在可用于您的工作流程中.

安装(n8n云)

如果你使用n8n Cloud,安装社区节点更简单:

1. 转到 帆布 打开 节点面板。 。 。 .
2. 搜索 说明 在社区节点登记簿中.
3. 点击 安装节点 在您实例中添加“辅助节点”.

在n8n上,云用户可以选择不显示已验证的社区节点. 案件所有者可以在云管理小组中切换这个. 要安装 Apify 节点, 确保启用已验证的社区节点的安装 .

安装(开发和贡献)

· 先决条件

• 节点.js: 22.x或更高(需要)
• 无: 10.8.2或以上(所需)

校验您的版本 :

node --version  # Should be v22.x.x or higher
npm --version   # Should be 10.8.2 or higher

如果您使用 nvm项目包括: .nvmrc 文档。 简单运行 :

nvm use

1. 克隆和安装依赖

清除寄存器并安装依赖性 :

git clone https://github.com/apify/n8n-nodes-apify.git
cd n8n-nodes-apify
npm install

2. 构建节点包

npm run build

3. 启动开发服务器

用您的节点链接启动 n8n 开发服务器 :

npm run dev

变革

如果您对本地的自定义节点做了任何更改, 请记住要重建并重新启动 :

npm run build

自行托管 n8n: 用于触发的 public webhook URL

这种配置是我们服务触发功能正确工作的必要条件.

默认情况下, 当运行本地 n8n 时使用 Webhook URL 生成 Webhook URL localhost,外部服务无法达到。 为了解决这个问题:

1. 设置您的 Webhook URL
   在 n8n 运行的同一 shell 或 Docker 环境中,导出 WEBHOOK_URL 到一个公开的地址。 例如:

export WEBHOOK_URL="https://your-tunnel.local"

2. 重新开始 n8n

npm run dev

业务

此节点支持按资源类型组织的一系列广泛的认证操作:

演员

• 运行演员: 执行带有可选输入参数的演员
  • 默认行为: 使用预定义的输入值
  • 自定义输入: 提供 JSON 对象以覆盖任何或所有默认参数
  • 可配置的超时和内存限制
  • 构建版本选择
• 运行演员并获取数据集项目: 执行一个演员, 等待它完成, 并返回数据集项
• 网络获取: 获取一个单一的 URL 并用请求的格式( 标记下、 文本、 HTML、 链接或原始) 获取其内容, 并带有可选的自定义标题
• 拼接单个 URL (折旧):快速刮取单一的 URL - 使用 Web 抓取
• 获取最后运行: 获取最近演员运行的信息

演员任务

• 运行任务: 执行预定义的演员任务
  • 支持自定义输入 JSON
  • 配置超时
  • 特定任务设置
• 运行任务并获取数据集项目: 执行任务, 等待任务完成, 并返回数据集项

演员运行

• 获取用户运行列表: 列出用户的所有运行
  • 倾角支持
  • 排序选项
  • 状态过滤
• 走开: 获取特定运行的详细信息

数据集

• 获取项目: 从数据集获取项目

键值存储

• 获取密钥值存储记录:按密钥检索特定记录

触发器

当演员或任务完成时自动启动 n8n 工作流程

• 可配置以触发成功、失败、中止、超时或这些状态的任何组合
• 产出中包括运行的元数据
• 可用的触发器 :
  • 演员运行完成: 演员运行完成后启动工作流程
  • 任务运行完成: 当任务完成时启动工作流程

AI 工具

所有添加的节点操作都可以与n8n的AI工具结合来创建强大的工作流程. 例如,你可以使用演员从网站上刮取数据,然后使用AI模型来分析或总结所提取的信息.

全权证书

该节点支持两种认证方法:

1. API 密钥认证

   • 在 n8n 证书栏下配置您的认证 API 密钥 apifyApi

2. OAuth2 认证 (仅以n8n云提供)

   • 在 n8n 证书栏下配置 OAuth2 证书 apifyOAuth2Api

兼容性

• 无 8n: 1.57.0及以上版本
• 节点.js: 22.x或更高
• 无: 10.8.2或以上

使用量

1. 创建演员: 设置一个新的演员 说明。 。 。 .
2. 设置工作流程: 以 n8n 创建新工作流程.
3. 添加认证节点: 在工作流程中插入“辅助节点”.
4. 配置证书: 输入您的 API 密钥和演员 ID .
5. 选择操作:为节点选择想要的操作.
6. 执行工作流程:运行工作流程以执行"认证"操作.

资源

• n8n 社区节点文档
• 认证 API 文档

重新发布新版本

该项目使用GitHub Actions工作流程实现发布进程的自动化,包括发布到npm. 这是如何触发新的发布.

先决条件(所有方法):

• 确保您在 GitHub 上的目标分支与您想要包含到发布中的所有更改更新 .
• 决定新版本编号,在语义化后进行(如:, vX.Y.Z) (中文(简体) ).
• 准备你们的释放说明 详细列出变化.
• 如果你用CLI来释放, 确保你有 GitHub CLI (英语:gh(中文(简体) ) 安装和认证(gh auth login) (中文(简体) ).

方法1:使用 GitHub Web UI(建议方便使用)

1. 导航到 GitHub 发布 :

   • 转到您的仓库“ 释放” 标签

2. 起草新版:

   • 点击 "新发行稿" 按钮.

3. 创建或选择标签 :

   • 在"选择标签"的下架中:
     • 键入您的新标签名称 (例如, v1.2.3) (中文(简体) ).
     • 如果标签不存在, GitHub 将提示您使用类似选项 "创建新标签:v1.2.3发布" 点击这个.
     • 确保 目标分支 用于创建新标签的选定正确。 此标记将指向此目标分支上的最新承诺 .

4. 设置发布标题和注释 :

   • 设置"释名"(如:, vX.Y.Z 或更描述性的标题).
   • 对于描述字段中的放出注释,您有一些选项:
     • 写你准备的释放笔记.
     • 点击“ Generate 释放注释” 按钮: GitHub 将尝试根据上次发布以来的合并拉取请求自动创建发布注释. 然后可以审查和编辑这些自动生成的注释.

5. 发布该版本 :

   • 点击 "图书馆发行" 按钮.

     发布后,GitHub会从您指定的分支创建标签并再创建发行. 这个"已发布"的发布事件触发了自动化的工作流程.

方法2:完全 CLI 驱动释放

这种方法使用 GitHub CLI(gh用于所有步骤,包括标签创建.

1. 确保您的本地目标分支同步并按下更改 : bash git checkout master git pull origin master

2. 创建“发布”(它也创建和推动标签): 替换 vX.Y.Z 与您想要的标签/版本。 命令将从您指定的最新任务创建此标记 --target 分支( 默认为寄存器默认分支, 如果 --target 省略,分支更新).

   gh release create vX.Y.Z \
       --target master \
       --title "vX.Y.Z" \
       --notes "Your detailed release notes here.
       - Feature X
       - Bugfix Y"
   
   # Or, to use notes from a file:
   gh release create vX.Y.Z \
       --target master \
       --title "vX.Y.Z" \
       --notes-file ./RELEASE_NOTES.md
   
   # Or, to generate notes from pull requests (commits must follow conventional commit format for best results):
   gh release create vX.Y.Z \
       --target master \
       --title "vX.Y.Z"
       --generate-notes
   

- `vX.Y.Z`: The tag and release name.
- `--target <branch>`: Specifies which branch the tag should be created from (e.g., `master`). If the tag `vX.Y.Z` doesn't exist, `gh` will create it based on the HEAD of this target branch and push it.
- `--title "<title>"`: The title for your release.
- `--notes "<notes>"` or `--notes-file <filepath>` or `--generate-notes`: Your release notes.

  _This command will create the tag, push it to GitHub, and then publish the release. This "published" release event triggers the automated workflow._

释放后:自动化工作流程和核查(所有方法通用)

无论您如何创建并发布 GitHub 发布 :

1. 自动工作流程执行:

   • "放出并发布"GitHub动作工作流程将自动触发.
   • 它将履行:
     1. 密码检查.
     2. 版本提取( O)X.Y.Z从放出标签.
     3. 构建和测试过程.
     4. 更新 package.json 财务报告和审定财务报表 package-lock.json 改为版本 X.Y.Z。 。 。 .
     5. 将这些版本的更改交回给发布对象的分支 chore(release): set version to X.Y.Z [skip ci]。 。 。 .
     6. 发布软件包 @apify/[email protected] {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}请说.

2. Npm 验证软件包 : 在工作流程成功完成( 请检查您的 GitHub 仓库中的“ 动作” 标签): - 在 npm 上验证新版本 : bash npm view @apify/n8n-nodes-apify version 这个应该打印 X.Y.Z。 。 。 .

版本历史

在此跟踪节点的更改和更新 .

解决问题

共同问题

1. 认证错误

   • 校验您的 API 密钥正确

2. 未找到资源

   • 校验资源标识格式
   • 检查您的认证账户中是否存在资源
   • 确保您能够访问资源

3. 操作失败

   • 检查输入参数
   • 验证资源限制( 记忆、 超时)
   • 详细错误消息的验证控制台

获得帮助

如果遇到问题:

1. 检查 认证 API 文档
2. 评议 n8n 社区节点文件
3. 在 GitHub 仓库