n8n Bilibili Node

这是一个用于 n8n 的 Bilibili 节点，允许您在 n8n 工作流中与 Bilibili API 进行交互。

功能特性

• 认证管理: 支持二维码登录和 Cookie 文件认证
• 视频管理: 上传视频、获取视频列表、查看视频详情
• 用户信息: 获取用户信息和登录状态
• MCP 集成: 通过 biliup-mcp 服务器进行 API 调用

安装

1. 克隆项目到本地：

git clone <repository-url>
cd n8n-nodes-bilibili

2. 安装依赖：

npm install

3. 编译项目：

npm run build

4. 链接到 n8n：

npm link
cd ~/.n8n/nodes
npm link n8n-nodes-bilibili

配置

1. 设置 Bilibili API 凭据

在 n8n 中创建新的凭据：

• 凭据类型：Bilibili API
• 认证方式：选择 "mcp" 或 "direct"
• MCP 服务器地址：http://localhost:3000（如果使用 MCP 方式）

2. 启动 MCP 服务器

确保 biliup-mcp 服务器正在运行：

cd /path/to/biliup-mcp
RUST_LOG=debug ./target/release/biliup-mcp-server

使用方法

认证操作

检查登录状态

• 资源：Auth
• 操作：Check Status

登录

• 资源：Auth
• 操作：Login
• 登录方式：QR Code 或 Cookie File

视频操作

上传视频

• 资源：Video
• 操作：Upload
• 必需参数：
  • 视频路径：视频文件的完整路径（多个文件用逗号分隔）
  • 标题：视频标题
• 可选参数：
  • 描述：视频描述
  • 标签：视频标签（逗号分隔）
  • 分类ID：视频分类（默认：171）
  • 版权：原创(1)或转载(2)
  • 封面路径：封面图片路径

获取视频列表

• 资源：Video
• 操作：List
• 参数：
  • 起始页：从第几页开始（默认：1）
  • 最大页数：获取多少页（默认：1）

获取视频详情

• 资源：Video
• 操作：Show
• 参数：
  • BVID：Bilibili 视频 ID

用户操作

获取用户信息

• 资源：User
• 操作：Get Info

示例工作流

项目包含一个示例工作流文件 examples/bilibili-test-workflow.json，您可以将其导入到 n8n 中进行测试。

导入工作流

1. 在 n8n 界面中，点击 "Import from file"
2. 选择 examples/bilibili-test-workflow.json 文件
3. 配置 Bilibili API 凭据
4. 运行工作流进行测试

工作流说明

示例工作流包含以下节点：

1. 手动触发器: 启动工作流
2. 检查登录状态: 验证 Bilibili 账户登录状态
3. 获取用户信息: 获取当前用户的基本信息
4. 获取视频列表: 获取用户的视频列表
5. 上传视频（示例）: 视频上传示例（默认禁用）

故障排除

常见问题

1. 编译错误

   • 确保安装了所有依赖：npm install
   • 检查 TypeScript 版本兼容性

2. MCP 服务器连接失败

   • 确保 biliup-mcp-server 正在运行
   • 检查服务器地址和端口配置

3. 认证失败

   • 检查 Cookie 文件路径是否正确
   • 确保 Cookie 文件格式正确且未过期

4. 视频上传失败

   • 检查视频文件路径是否正确
   • 确保视频格式符合 Bilibili 要求
   • 检查网络连接和上传权限

调试模式

启用调试模式查看详细日志：

RUST_LOG=debug ./target/release/biliup-mcp-server

开发

项目结构

n8n-nodes-bilibili/
├── credentials/
│   └── BilibiliApi.credentials.ts    # 凭据定义
├── nodes/
│   └── Bilibili/
│       ├── Bilibili.node.ts          # 主节点实现
│       └── bilibili.svg              # 节点图标
├── examples/
│   └── bilibili-test-workflow.json   # 示例工作流
├── package.json                      # 项目配置
├── tsconfig.json                     # TypeScript 配置
└── gulpfile.js                       # 构建配置

构建命令

• npm run build: 编译 TypeScript 并构建图标
• npm run dev: 开发模式（监听文件变化）
• npm run lint: 代码检查
• npm run test: 运行测试

贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目。

许可证

MIT License