Save Douyin Video To Feishu Drive

解析抖音链接获取视频直链,支持上传至飞书云盘或本地下载。

已扫描
适合谁
需要批量收集抖音视频素材的运营人员、使用飞书进行协作的团队管理者
不适合谁
无需视频素材整理的普通用户、无法访问飞书云盘或无权限配置的用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好(★☆☆)。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @kuaner/save-douyin-video-to-feishu-drive

Skill 说明

命令、参数、文件名以原文为准

何时使用

  • 用户提供抖音分享链接或视频页 URL,需要得到可下载的视频地址或直接下载视频文件
  • 需要将视频上传到飞书云盘并获取分享链接

使用方式选择

用户可以使用以下任一方式处理抖音视频:

方式一:上传飞书云盘(推荐)

# 获取飞书token
TOKEN=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
  -H "Content-Type: application/json" \
  -d '{"app_id":"<app_id>","app_secret":"<app_secret>"}' | python3 -c "import json,sys; print(json.load(sys.stdin)['tenant_access_token'])")

# 执行上传
node scripts/parse-douyin-video.js <抖音URL> --feishu <token> <folder_token>
  • 优点:支持大文件(>30MB),用户可直接在云盘下载
  • 返回:feishu_url(云盘链接)

首次使用需要配置:

  1. 在飞书云盘创建一个文件夹(如"抖音视频")
  2. 将文件夹分享给机器人,添加成员并设置权限
  3. 参考 [飞书开放平台文档](https://open.feishu.cn/document/faq/trouble-shooting/how-to-add-permissions-to-app) 开通文件夹权限
  4. 给机器人分配 drive:drive.metadata:readonly 权限

方式二:仅解析

node scripts/parse-douyin-video.js <抖音URL>
  • 返回:title, desc, video_urls 等信息
  • 适用于:只需要视频直链
  • ⚠️ 注意:返回的 video_url 直接访问会403,需要在请求时添加 Referer: https://www.douyin.com/ 才能下载

方式三:下载到本地

# 下载到临时目录(自动创建临时目录)
node scripts/parse-douyin-video.js <抖音URL> --download

# 下载到指定路径
node scripts/parse-douyin-video.js <抖音URL> /path/to/video.mp4
  • 返回:download_path
  • ⚠️ 飞书聊天发送限制:文件大小 ≤ 30MB,超过则需要使用方式一(上传云盘)
  • ⚠️ 通过飞书发送文件时:

- 上传接口 file_type 必须用 "stream"(不是 mp4)

- 发送消息接口 msg_type 用 "file"

- content 必须是字符串格式:"{\"file_key\":\"xxx\"}"

配置用户偏好

当用户选择了使用方式后,需要将偏好配置保存到 TOOLS.md:

## 抖音视频处理(使用偏好)

### 固定配置
- **飞书token获取**: app_id / app_secret
- **云盘文件夹**: folder_token

### 使用方式
收到抖音链接时,自动使用【飞书云盘】方式上传

常见错误

  • 1061004: forbidden - 云盘文件夹未分享给机器人
K
@kuaner

已收录 1 个 Skill

相关推荐