n8n-nodes-feishu

n8n 社区节点，用于与飞书/Lark API 交互，支持消息发送、文档操作、日历管理、多维表格等功能。

v2.1.0 新增: Lark Webhook Trigger（HTTP Webhook 触发器）、Respond to Lark（同步响应节点）

本项目 fork 自 n8n-nodes-feishu-lark，并进行了以下改进：

• 适配最新 n8n 版本 (v2.x)
• 更新 Node.js 引擎要求至 v22+
• 添加 npm provenance 支持
• 修复代码质量问题

部分功能（Webhook Trigger、Respond 节点、自动分页、超时批次管理）参考自 luka-n8n-nodes/n8n-nodes-feishu

安装

在 n8n 中安装此节点：

npm install @snae/n8n-nodes-feishu

或者通过 n8n 界面安装：Settings > Community Nodes > Install > 输入 @snae/n8n-nodes-feishu

功能特性

支持的资源

• 消息 (Message): 发送、回复、编辑、转发、撤回消息；查询消息内容与历史记录；上传/下载文件、图片、音频、视频等资源
• 群组 (Chat/Group): 创建/更新/删除群聊、搜索群组、添加/移除/查询成员、管理群主
• 多维表格 (Base/Bitable): 创建/更新/删除应用、表格、记录、字段、视图；批量操作
• 日历 (Calendar): 创建/管理日历和日程事件；管理日程参与人；日历搜索与空闲查询
• 文档 (Document): 创建/读取云文档，管理文档块
• 云空间 (Space): 文件管理（递归列表/搜索/上传/下载）、文件夹创建/删除、空间统计、导入导出
• 电子表格 (Spreadsheet): 读写表格数据、管理工作表、行列操作、单元格样式/合并/查找替换
• 通讯录 (Contacts): 查询用户信息、批量获取用户；部门搜索及子部门/成员列表管理
• 任务 (Task): 任务管理
• 知识库 (Wiki Spaces): 知识库空间管理

触发器

• Lark Trigger: 通过 WebSocket 长连接接收飞书事件推送（仅支持中国版飞书）。支持卡片回调同步响应（Response Node 模式）。
• Lark Webhook Trigger ✨ 新增: 通过 HTTP Webhook 接收事件回调，支持加密推送解密、URL 验证、Response Node 模式
• Webhook: 通过 n8n Webhook 节点接收事件（支持国际版 Lark）

响应节点

• Respond to Lark ✨ 新增: 同步响应飞书卡片交互，支持 WebSocket 和 Webhook 两种模式

特殊操作

• Send and Wait: 发送消息并等待用户响应，支持 Human-in-the-loop 工作流
• Send Streaming Message: 支持 AI Agent 流式输出到飞书机器人
• Parse Message: 解析飞书事件回调数据

凭证配置

Tenant Token（应用身份）

1. 在飞书开放平台创建应用，获取 App ID 和 App Secret
2. 在 n8n 中添加凭证，选择 Lark Tenant Token API
3. 填入 App ID 和 App Secret
4. 选择合适的 Base URL（中国版或国际版）

User Token（用户身份）

1. 在飞书开放平台配置 OAuth2 重定向 URL
2. 在 n8n 中添加凭证，选择 Lark OAuth2 API
3. 填入 Client ID 和 Client Secret
4. 配置所需的 Scope 权限（建议包含 offline_access）

详细配置请参考飞书开放平台文档。

飞书开放平台 API 文档: Server Docs

开发

# 安装依赖
npm install

# 构建
npm run build

# 开发模式（监听文件变化）
npm run dev

# 代码检查
npm run lint

# 测试
npm test

发布

本项目使用 GitHub Actions 自动发布到 npm。当推送 tag 时会自动触发发布流程：

# 创建新版本 tag
git tag v2.0.1
git push origin v2.0.1

发布时会自动添加 npm provenance 签名，确保包的可信性。

许可证

MIT License

相关链接

• GitHub 仓库
• 飞书开放平台文档
• n8n 社区节点文档
• 原项目仓库