bilibili

n8n node for Bilibili video management integration

Package Information

Downloads: 1 weekly / 10 monthly
Latest Version: 1.0.0
Author: biliup-mcp team

Available Nodes

Bilibili icon
Bilibili
Interact with Bilibili API for video management

Documentation

n8n Bilibili Node

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

功能特性

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

安装

  1. 克隆项目到本地：
git clone <repository-url>
cd n8n-nodes-bilibili
  1. 安装依赖：
npm install
  1. 编译项目：
npm run build
  1. 链接到 n8n：
npm link
cd ~/.n8n/nodes
npm link n8n-nodes-bilibili

配置

1. 设置 Bilibili API 凭据

在 n8n 中创建新的凭据：

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

Discussion