@apdf/n8n-nodes-apdf

中文文档
1.1.0发布于 2026/10/22MIT零依赖构建来源已验证近 30 天下载 2066

apdf的n8n节点——PDF跟踪链接,读者分析与PDF处理

中文使用文档
文档目录20 节
  1. 安装
  2. 全权证书
  3. 节点
  4. Apdf 触发器
  5. 设置
  6. 活动
  7. 产出
  8. 示例
  9. 条件
  10. Apdf (英语)
  11. 文档
  12. 跟踪链接
  13. 分析
  14. 专题报告
  15. 自动化
  16. 任务
  17. 同步操作
  18. 页面范围
  19. 资源
  20. 许可证

@apdf/n8n-节点-apdf

N8n 节点 Apdf (英语) ——应用和代理的PDF接触层.

共享一个PDF作为每个接收者的跟踪链接,然后找出是谁打开的,哪些页面 实际上,他们读了, 他们停留了多久, 他们把什么打入它的形式。 同样的节点 覆盖完整的Apdf PDF工具集:创建,从Office转换,合并,分拆,压缩,OCR, 加密、读取和填写表格以及页面操作.

无 8n 是一个 获得公平代码许可 工作流程自动化平台.

安装

跟着 社区节点安装指南 并安装 @apdf/n8n-nodes-apdf。 。 。 .

全权证书

以 Apdf API 令牌认证节点 .

  1. 签名于 页:1 打开 盘子 API 托肯斯。 。 。 .
  2. 创造出一个符号并复制. 一个符号属于一个工作空间 所以每个请求都通过 这个节点作用于工作空间.
  3. 在 n8n 中创建新 Apdf API (英语) 证书并粘贴标志.

这个 基础 URL 字段默认为 https://apdf.io/api 而且只要你运行需要改变 Apdf在另一个主机.

Apdf 发送代号为 Authorization: Bearer <token>。证书测试呼叫 GET /me,它返回了用户和工作空间,符号是.

节点

这个包装有两个节点:

节点目的
Apdf 触发器当读者与您共享的文档交互时启动工作流程
Apdf (英语)读取业务约定数据并运行 PDF 操作

Apdf 触发器

触发器接收到一个Apdf自动化器在读取器做某事时所发送的webhook.

自动化,所以这个触发器需要 赞成 或者说 商业 计划 免费的哈比计划 Apdf拒绝创建自动化,因此启动工作流程失败出错. 这个 一旦达到计划对主动自动化的极限,同样的情况也会发生. 见 定价 每个计划的限度.

设置

触发器自己登记。 选择你关心的事件并启动工作流程—— 节点在 Apdf 中创建匹配的自动化,并在关闭时再次删除.

  1. 添加数据 Apdf 触发器 节点并选择您的 Apdf API (英语) 证书.
  2. 选择一个或多个 活动。 。 。 .
  3. 有选择地限制在一定范围内 文档 并添加 条件 例如 页面编号等于 7。 。 。 .
  4. 启动工作流程。 自动化显示在下面 文件 + 自动化 在Apdf中, 以工作流程命名.

没什么需要手工创造的 如果您删除了 Apdf 中的自动化,则解除和 重新激活工作流程重新创建它.

下 选项 您可以设置一个 Auth 信头值。节点将它作为一个 网页浏览头并拒绝任何未发送的请求——值得设置,因为 否则, Webhook URL 是唯一保护终点的东西. 认证页眉名称 更改哪个标题,以及 自动化名称 覆盖自动化的名称 进入Apdf.

活动

选择至少一个事件 。 Apdf 过滤其侧面,所以工作流程只运行于您 选中 .

活动当火
文档已打开一个读取器打开文档
已下载文档一个读者下载文档
已打印文档一个读者打印文档
已查看页面阅读器导航到一页
页面已读读者停留在页面上,每15秒测量一次
左页阅读器从页面中浏览
文本复制从文档复制文本的读者
链接被点击阅读器单击文档中的链接
提交表单读者在文档中提交表格
创建注释读者创建注释
注释已更新读者修改注释
注释已删除阅读器删除注释

文件和页面事件——打开、下载、印刷、浏览、阅读和左边——触发 自动化 每个阅读会话一次,即使基础测量重复。 页次 读取每15秒测量一次,但你的工作流程运行一次 文本复制, 链接点击, 格式提交和注释事件每次发生都会起火 .

产出

触发器发出自动有效载荷时未改变:

{
  "automation": { "id": "…", "name": "Notify on read" },
  "document": {
    "doc_id": "…",
    "name": "Proposal.pdf",
    "viewer_url": "https://…",
    "file_pages": 12
  },
  "trigger": { "matched_event": "page:read", "conditions_evaluated": true },
  "event": {
    "session_id": "…",
    "viewer_id": "…",
    "recipient": { "name": "Jane Doe", "email": "[email protected]" },
    "data": { "page": 5, "duration_ms": 45000 }
  },
  "session": { "total_duration_ms": 182000, "pages_viewed": 8, "completion_rate": 66.7 },
  "timestamp": "2026-07-28T12:00:00+00:00"
}

session.completion_rate 是文档页面的一个百分比. event.recipient 实值 null 当 Apdf 无法将读取器绑入跟踪链接时.

event.data 按事件变化 :

活动event.data
已查看页面page
页面读取,页左page, (中文(简体) ), duration_ms
文本复制page, (中文(简体) ), text
链接被点击page, (中文(简体) ), url, (中文(简体) ), text, (中文(简体) ), is_internal
提交表单fields
创建注释, 更新注释page, (中文(简体) ), type, (中文(简体) ), comment_text, (中文(简体) ), comment_author, (中文(简体) ), annotated_text
注释已删除page
文档打开、下载、打印null

示例

提醒你的团队,一旦有前景 读取你的定价页:

  1. Apdf 触发器 事件 页面已读, (中文(简体) ), 文档 设置在提案的ID,和 条件 联 合 国 页码等于 5。 。 。 .

    下游使用条件而不是IF节点. 每读一次自动化起火 读取符合其条件,然后过滤到 n8n 通常会看到不同的一页,永远不匹配.

  2. 偷懒 员额 {{ $json.event.recipient.name }} just read page {{ $json.event.data.page }} — {{ $json.session.pages_viewed }} pages in {{ $json.session.total_duration_ms / 1000 }}s。 。 。 .

条件

条件测试
页数等于事件发生的一页
时间最少在该页上花费了几秒钟
至少读取时间总数整个会议期间花费的秒数
至少查看的页面有多少不同的页面
完成率文件读取百分比

并非每个条件都与每个事件有关——一个页面条件需要一个页面事件,因为 举个例子 Apdf 启动工作流程时验证组合并返回清晰 如果无法工作, 错误 .

Apdf (英语)

任何操作需要文档的地方,节点都会提供 文档名称或标识 降级 居住于您的工作空间中—— 选择一个, 或提供一个ID, 当它出现时会有一个表达 从较早的节点.

列表操作遵循 n8n 常规 : 全部返回 抓取每一页, 或离开它 设置一个 限制答复没有包装,因此,每个记录都是作为自己的项目提出的 而不是作为一个项 持有整个响应.

文档

创建、列出、获取和删除跟踪文档、归档并解存档,并切换 a 文档介于公共访问和仅链接访问之间.

创建文档需要公开获取 文件網址 (单位:千美元) 名称。 。 。 .

每个收件人创建一个链接,使阅读活动归于一个人而不是一个 匿名读者. 创建、列表、删除、激活和关闭链接.

A 类 收件人名称 需要; 收件人电子邮件 是可选的.

分析

运行回返
获取文档分析文档的会话、读者、完成率和下载
获取会话文件的阅读记录
获取会话一会,包括每页详细情况
获取说明重点和评论读者离开
获取表格提交输入文档表格的读者

专题报告

Apdf PDF API的操作情况: 从 HTML 创建, (中文(简体) ), 从办公室转换, (中文(简体) ), 合并, (中文(简体) ), 分开, (中文(简体) ), 压缩, (中文(简体) ), 转换为图像, (中文(简体) ), 摘录页, (中文(简体) ), 删除 页 次, (中文(简体) ), 旋转页面, (中文(简体) ), 重叠页面, (中文(简体) ), 底页, (中文(简体) ), 搜索内容, (中文(简体) ), 读取内容, (中文(简体) ), OCR 转换, (中文(简体) ), OCR 搜索内容, (中文(简体) ), OCR 读取内容, (中文(简体) ), 读取 表单, (中文(简体) ), 填充表单, (中文(简体) ), 可视化窗体, (中文(简体) ), 添加安全性, (中文(简体) ), 删除安全性 财务报告和审定财务报表 读取 元数据。 。 。 .

每个操作都将其源作为可公开获取的URL. 更改 PDF 操作 返回新文件, 绝不修改源, 包括 删除页面。 。 。 .

从办公室转换 取一个 Word, Excel, PowerPoint, OpenDocument 或 RTF 文件( docx, doc, xlsx, xls, pptx, ppt, odt, ods, odp, rtf) 而不是一个PDF.

表格操作共同工作:

  • 读取窗体 返回带有名称、类型、值和选项的每个窗体字段,以及 它的标签和文字印在页面上.
  • 填充表单 把田地填满这些名字 复选框 true 或者说 false· ; 电台按钮、下拉和列表框选择。 留下的字段保留 和计算字段,如总数。 启用 平缓 下级 选项 因此填充的字段不能再被更改了.
  • 可视化窗体 使窗体页成为每个字段都有编号框的图像,以及 列出每个数字是哪个字段。 将图像交给一个AI步骤, 这样它就可以分辨哪个字段 填充,即使 名字不说,喜欢 Text12。 。 。 .

自动化

完全控制将读者活动变成网络呼号的规则: 创建, (中文(简体) ), 获取, (中文(简体) ), 获得多个, (中文(简体) ), 删除, (中文(简体) ), 启动, (中文(简体) ), 关闭, (中文(简体) ), 复制,以及 获取处决 提供历史.

创建一个需要 名称,一个或多个 活动 (单位:千美元) Webhook URL 软件设置 范围 改为 具体文件 缩入给定的ID,添加 条件 仅发射过a 阈值,并添加 Webhook 页眉 所以,你的端点 可以认证电话.

和触发器一样,这需要Pro或Business计划. 创建, (中文(简体) ), 启动 财务报告和审定财务报表 复制 如果哈比计划出了差错,或者一旦计划有活动限制,则失败 实现了自动化.

如果您只想要工作流程对读者作出反应,请使用 Apdf 触发器 相反,它创造了 并取消自己的自动化。 管理自动化时使用此资源 在方案方面,例如将它们指向n8n以外的系统.

任务

检查状态 投票结果是同步行动.

同步操作

Apdf在队列上运行着繁重的工作. 7个行动总是返回工作身份,而不是结果:

  • 从 HTML 创建
  • 从办公室转换
  • 压缩
  • 转换为图像
  • OCR 转换
  • OCR 读取内容
  • OCR 搜索内容

其余的 PDF 操作默认运行内置,仅在启用时返回工作标识 同步运行 下级 选项。 。 。 .

为了得到一份工作的结果, 无论是与 任务 – 检查状态 操作,或设置 (单位:千美元) Webhook URL 软件 apdf在工作完成后给你打电话.

页面范围

业务需要a 页 次 值接受页码和范围,例如 1,3-5。 。 。 . 有两个快捷键:

  • z ——最后一页
  • rN —— 第N页从结尾,所以 r2 是第二至最后一页

分开 额外接受 nN,将每个文件分为N页. n2 产量 2页的文件.

资源

许可证

麻省理工学院

版本与发布记录

@apdf/n8n-nodes-apdf 共发布 11 个版本,首次发布于 2026/10/09;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.1.0latest2026/10/2217 天前
1.0.12026/10/1820 天前
1.0.02026/10/1721 天前
0.1.72026/10/1622 天前
0.1.62026/10/1028 天前
0.1.52026/10/1028 天前

关于 @apdf/n8n-nodes-apdf 的常见问题

@apdf/n8n-nodes-apdf 是什么?

apdf的n8n节点——PDF跟踪链接,读者分析与PDF处理

如何安装 @apdf/n8n-nodes-apdf?

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

@apdf/n8n-nodes-apdf 支持 TypeScript 吗?

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

@apdf/n8n-nodes-apdf 可以商用吗?

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

@apdf/n8n-nodes-apdf 的下载量有多少?

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

@apdf/n8n-nodes-apdf 还在维护吗?

最新版本 1.1.0 发布于 2026/10/22(17 天前);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/10/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。