# @apify/n8n-nodes-apify 中文文档

规范地址：https://npmcn.com/package/%40apify/n8n-nodes-apify/

版本：0\.9\.0
npm 元数据更新时间：2026-10-22T09:24:05.427Z
中文译文更新时间：2026-11-06T10:03:21.207Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40apify/n8n-nodes-apify
原文对照：https://npmcn.com/package/%40apify/n8n-nodes-apify/?lang=original
项目主页：https://github.com/apify/n8n-nodes-apify
源码仓库：https://github.com/apify/n8n-nodes-apify

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.1 MB，282 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.0\.0
- 运行依赖：0 个
- peer 依赖：n8n-workflow \*
- 首次发布：2025-05-26T12:01:45.655Z
- 最新版本发布：2026-10-22T09:24:04.886Z
- 近 30 天下载量：166469（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 8 个）

## 中文简介

n8n 用于辅助的节点

## 安装

```sh
npm install @apify/n8n-nodes-apify
```

也可以使用：`pnpm add @apify/n8n-nodes-apify`、`yarn add @apify/n8n-nodes-apify`、`bun add @apify/n8n-nodes-apify`

## README

# n8n 节点 - 辅助集成

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

[说明](https://apify.com/) 是开发者建立、部署和发布网络自动化工具的平台,同时 [无 8n](https://n8n.io/) 是一个 [获得公平代码许可](https://docs.n8n.io/reference/license/) 用于 AI 工作流程自动化的工具,允许您连接各种服务.

## 目录

-   [安装自主机实例](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-installation-self-hosted)
-   [在n8n云上安装](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-installation-n8n-cloud)
-   [安装用于发展和贡献](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-installation-development-and-contributing)
-   [业务](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-operations)
-   [全权证书](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-credentials)
-   [兼容性](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-compatibility)
-   [使用量](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-usage)
-   [资源](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-resources)
-   [释放](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-releasing-a-new-version)
-   [版本历史](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-version-history)
-   [解决问题](https://npmcn.com/package/%40apify/n8n-nodes-apify/#readme-troubleshooting)

## 安装(自备)

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

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

## 安装(n8n云)

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

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

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

## 安装(开发和贡献)

### · 先决条件

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

校验您的版本 :

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

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

```bash
nvm use
```

### 1\. 克隆和安装依赖

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

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

### 2\. 构建节点包

```bash
npm run build
```

### 3\. 启动开发服务器

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

```bash
npm run dev
```

* * *

### 变革

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

```bash
npm run build
```

* * *

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

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

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

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

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

2.  **重新开始 n8n**

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

![auth](https://npmcn.com/package/%40apify/n8n-nodes-apify/docs/auth.png)

## 兼容性

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

## 使用量

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

![workflow](https://npmcn.com/package/%40apify/n8n-nodes-apify/docs/workflow.png)

## 资源

-   [n8n 社区节点文档](https://docs.n8n.io/integrations/community-nodes/)
-   [认证 API 文档](https://docs.apify.com/)

# 重新发布新版本

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

**先决条件(所有方法):**

-   确保您在 GitHub 上的目标分支与您想要包含到发布中的所有更改更新 .
-   决定新版本编号,在语义化后进行(如:, `vX.Y.Z`) (中文(简体) ).
-   准备你们的释放说明 详细列出变化.
-   如果你用CLI来释放, 确保你有 [GitHub CLI (英语:`gh`(中文(简体) )](https://cli.github.com/) 安装和认证(`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` 省略,分支更新).
    
    ```bash
    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/n8n-nodes-apify@X.Y.Z` {\\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 文档](https://docs.apify.com/)
2.  评议 [n8n 社区节点文件](https://docs.n8n.io/integrations/community-nodes/)
3.  在 [GitHub 仓库](https://github.com/apify/n8n-nodes-apify)

## 常见问题

### @apify/n8n-nodes-apify 是什么？

n8n 用于辅助的节点

### 如何安装 @apify/n8n-nodes-apify？

在项目目录运行 npm install @apify/n8n-nodes-apify，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：n8n-workflow（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @apify/n8n-nodes-apify 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/apify\_\_n8n-nodes-apify 是否存在。

### @apify/n8n-nodes-apify 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @apify/n8n-nodes-apify 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @apify/n8n-nodes-apify 可以商用吗？

@apify/n8n-nodes-apify 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @apify/n8n-nodes-apify 的下载量有多少？

根据 npm 官方下载统计，@apify/n8n-nodes-apify 在 2026/10/06 – 2026/11/04 这 30 天内被下载 166,469 次，日均约 5,549 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @apify/n8n-nodes-apify 还在维护吗？

最新版本 0\.9\.0 发布于 2026/10/22（15 天前）；至今共发布 29 个版本，其中过去 12 个月发布了 8 个；首次发布于 2025/05/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。