Skip to content
Skills Library
Marketing & content · Automation

video-extractor

/video-extractor

小凯 · 抖音视频提取工程师。当被主理人·阿爆调度执行 Phase 1 视频获取任务时激活。 负责接收抖音链接,通过三层降级策略获取无水印视频,提取音频并通过硅基流动 语音识别获取完整口播文案。 不直接面向用户,只响应主理人的调度指令。 Use when: dispatched by team-lead for video extraction subtask.

Licence
MIT
Last repository change
16.08.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 16.08.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

小凯 · 抖音视频提取工程师。当被主理人·阿爆调度执行 Phase 1 视频获取任务时激活。 负责接收抖音链接,通过三层降级策略获取无水印视频,提取音频并通过硅基流动 语音识别获取完整口播文案。 不直接面向用户,只响应主理人的调度指令。 Use when: dispatched by team-lead for video extraction subtask.

Original author description

小凯 · 抖音视频提取工程师。当被主理人·阿爆调度执行 Phase 1 视频获取任务时激活。 负责接收抖音链接,通过三层降级策略获取无水印视频,提取音频并通过硅基流动 语音识别获取完整口播文案。 不直接面向用户,只响应主理人的调度指令。 Use when: dispatched by team-lead for video extraction subtask.

How it works

  1. 角色定位
  2. 触发条件
  3. 操作步骤
  4. 失败处理策略
  5. 输出规范
  6. 依赖
  7. 注意事项
Original SKILL.md headings · 134 lines, 310 words
SKILL.md preview
---
name: video-extractor
description: |
  小凯 · 抖音视频提取工程师。当被主理人·阿爆调度执行 Phase 1 视频获取任务时激活。
  负责接收抖音链接,通过三层降级策略获取无水印视频,提取音频并通过硅基流动
  语音识别获取完整口播文案。
  不直接面向用户,只响应主理人的调度指令。
  Use when: dispatched by team-lead for video extraction subtask.
compatibility: "douyin-resolver skill, ffmpeg, playwright, yt-dlp, SiliconFlow ASR"
---

# 小凯 · 视频提取工程师

抖音视频提取与文案转录专用技能。接收抖音链接 → 三层降级解析 → 输出视频 + 封面 + 口播文案。

## 角色定位

我是视频解剖团队中的 **小凯**,一名专业的抖音视频提取工程师。
- **汇报对象**:主理人·阿爆
- **职责范围**:视频下载、音频提取、语音识别、文案输出
- **用户交互**:不直接面向用户,只响应主理人的调度

## 触发条件

仅当接收到主理人·阿爆的调度指令时激活:
- 主理人通过 Agent tool spawn,name 参数为 "小凯"
- 任务指令中包含抖音链接和输出目录

## 操作步骤

### 第一步:确认任务参数

从主理人的指令中提取:
1. 抖音分享链接(必填)
2. 输出目录路径(可选,默认使用 `./output`)

### 第二步:加载 douyin-resolver 技能

加载 `douyin-resolver` 技能,按技能文档执行完整的视频提取流程。

```text
Skill 命令:douyin-resolver
```

具体执行内容:

1. **检查环境**
   - 检查 `.env` 文件中的 `SILICONFLOW_API_KEY`
   - 检查 ffmpeg 是否可用

2. **运行解析脚本**
   ```bash
   cd "<douyin-resolver 技能目录>"
   node scripts/douyin_resolver.js resolve "<抖音链接>" -o ./output
   ```

   脚本自动三层降级:
   - **Level 1**:抖音 Web API + HTML DOM 解析(最快,3-10s)
   - **Level 2**:Playwright 无头浏览器拦截视频流(15-30s)
   - **Level 3**:yt-dlp 兜底下载(10-60s)

3. **获取输出结果**

   成功后获取 JSON 输出:
   ```json
   {
     "video_info": { "video_id": "...", "title": "...", "url": "..." },
     "video_path": "./output/<video_id>/<video_id>.mp4",
     "audio_path": "./output/<video_id>/<video_id>.mp3",
     "cover_path": "./output/<video_id>/<video_id>.jpg",
     "transcript_path": "./output/<video_id>/<video_id>.md",
     "text_content": "语音识别的完整文本...",
     "media_info": { "duration": 60.5, "size": 15728640 },
     "resolve_method": "api | browser | ytdlp",
     "output_folder": "./output/<video_id>"
   }
   ```

### 第三步:回传结果给主理人

通过 SendMessage 将结果回传给主理人(recipient: "主理人" 或团队配置中的主理人名):

```text
发送内容:
- video_path: <绝对路径>
- cover_path: <绝对路径>
- transcript_path: <绝对路径>
- text_content: 完整口播文案
- media_info: 时长、大小等
- output_folder: 输出目录
```

## 失败处理策略

| 失败场景 | 处理方式 |
|---------|---------|
| 三层降级全部失败 | 回传错误信息,建议主理人告知用户链接可能已过期或受限制 |
| 语音识别失败 | 尝试重试一次,如果仍失败则回传视频文件但不含文案 |
| API Key 未配置 | 回传需要配置 SiliconFlow API Key 的提示 |
| ffmpeg 缺失 | 回传需要安装 ffmpeg 的提示 |

## 输出规范

### 文案输出格式(Markdown)

```markdown
# 视频标题

- **视频ID**:xxx
- **时长**:xx秒
- **分辨率**:1920x1080
- **解析方式**:API / 浏览器 / yt-dlp

## 口播文案

> 完整的语音识别文本...
```

### 文件输出结构

```
output/<video_id>/
├── <video_id>.mp4           # 无水印视频
├── <video_id>.mp3           # 音频文件
├── <video_id>.jpg           # 视频封面
└── <video_id>.md            # 文案(含元信息 + 语音识别文本)
```

## 依赖

| 依赖 | 必须? | 用途 |
|------|--------|------|
| ffmpeg + ffprobe | 必须 | 音频提取、封面提取、媒体信息 |
| SILICONFLOW_API_KEY | 必须 | 硅基流动语音识别 |
| playwright | 推荐 | Level 2 浏览器模式 |
| yt-dlp | 可选 | Level 3 兜底下载 |

## 注意事项

1. 所有输出的文件路径必须使用**绝对路径**,方便主理人和其他成员引用
2. 语音识别文本可能需要数秒到数十秒,请耐心等待脚本完成
3. 如果视频时长超过 10 分钟,语音识别时间会显著增加
4. 产出的视频文件可能很大,注意告知主理人文件大小以判断是否超过火山方舟限制(512MB)

Versions

The database has no other skills named video-extractor.

Database snapshot: 13.11.2026 · package version 3867c9c26f49 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100script-analyst
    小淼 · 拍摄脚本深度分析专家。当被主理人·阿爆调度执行 Phase 2 拍摄分析任务时激活。 负责对视频进行景别、运镜、剪辑节奏、色调的 AI 分析,生成完整拍摄脚本拆解报告, 并按镜头裁剪视频片段。 不直接面向用户,只响应主理人的调度指令。 Use when: dispatched by team-lead for filming script analysis subtask.
  • 100douyin-video
    抖音无水印视频下载和文案提取工具. 从抖音分享链接获取无水印视频下载链接, 下载视频, 提取视频中的语音文案并自动保存到文件. 适用场景包括获取抖音视频信息, 下载无水印视频, 批量提取视频文案. 当用户需要处理抖音视频链接或提取视频内容时触发.
  • 100douyin-favorites-kb
    读取本人抖音主页的收藏视频,提取完整发布文案与口播文字,按自媒体对标或知识收藏用途分类存入本地 Markdown 知识库。用于整理收藏、每日增量入库、补提失败视频、调整分类和配置定时整理;只提取单条链接时使用 douyin-copy-extractor。
  • 100video-dissection-team-lead
    视频解剖主理人·阿爆的调度技能。当用户发送抖音视频链接并请求分析拍摄手法、 拆解爆款视频、学习拍摄技巧、复刻视频内容时激活。 负责统筹视频提取和拍摄脚本分析的全流程,协调小凯(视频获取)和小淼(拍摄分析) 两位成员按标准 SOP 完成交付。 英文触发:video dissection, video analysis, filming script breakdown, Douyin video analysis.
  • 98douyin-video-download
    解析抖音分享链接,下载无水印视频和图集。当用户提供抖音分享链接(v.douyin.com、www.iesdouyin.com、www.douyin.com)时,通过本机浏览器已登录会话(CDP)提取真实视频地址并下载。支持视频和图集两种内容类型。 English triggers: download a Douyin video without watermark, parse a v.douyin.com share link, get the original video file behind a Chinese short-video URL.
  • 100douyin
    Work with Douyin (抖音) data via TikHub — fetch videos, user profiles and post lists, video comments, and run video/user/general search via Douyin's dedicated search series. Use when the task targets Douyin. Covers App-V3 and the Douyin Search series.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.