Save Douyin Video To Feishu Drive

name: douyin-video-parse description: 从抖音分享链接或视频页 URL 解析出可下载的视频直链、标题与描述，并可下载到本地或上传到飞书云盘。适用于需要解析抖音 URL（短链、/video/、/note/、modal_id 等）并获取真实播放地址或下载视频时使用。

何时使用

• 用户提供抖音分享链接或视频页 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. 参考 飞书开放平台文档 开通文件夹权限
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 - 云盘文件夹未分享给机器人