douyin-video

Other Community

Repo stars 1,060
Author repo douyin-mcp-server

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: 从抖音分享链接获取无水印视频下载链接, 下载视频, 并使用语音识别提取视频中的文案, 自动保存到文件. pip install requests ffmpeg-python 文案提取功能使用硅基流动 API, 需要设置环境变量: export API_KE…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “功能概述”, “环境要求”, “依赖安装”, “系统要求”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name douyin-video directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “功能概述 / 环境要求 / 依赖安装” before expanding.

Boundaries And Review

Dependencies: Prepare Vendor-specific API keys before running a full task.
Permissions: Declared permissions include read; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

抖音无水印视频下载和文案提取

从抖音分享链接获取无水印视频下载链接, 下载视频, 并使用语音识别提取视频中的文案, 自动保存到文件.

功能概述

获取下载链接: 从抖音分享链接解析出无水印视频的直接下载地址 (无需 API 密钥)
下载视频: 将无水印视频下载到本地指定目录
提取文案: 通过语音识别从视频中提取文字内容 (需要硅基流动 API 密钥)
自动保存: 每个视频的文案自动保存到独立文件夹 (视频ID为文件夹名)

环境要求

依赖安装

pip install requests ffmpeg-python

系统要求

FFmpeg 必须安装在系统中 (用于音视频处理)
macOS: brew install ffmpeg
Ubuntu: apt install ffmpeg

API 密钥配置 (仅文案提取需要)

文案提取功能使用硅基流动 API, 需要设置环境变量:

export API_KEY="[REDACTED:credential]"

获取 API 密钥: https://cloud.siliconflow.cn/

使用方法

方法一: 使用脚本 (推荐)

# 获取视频信息和下载链接 (无需 API 密钥)
python douyin_downloader.py --link "抖音分享链接" --action info

# 下载视频到指定目录
python douyin_downloader.py --link "抖音分享链接" --action download --output ./videos

# 提取视频文案并保存到文件 (需要 API_KEY 环境变量)
python douyin_downloader.py --link "抖音分享链接" --action extract --output ./output

# 提取文案并同时保存视频
python douyin_downloader.py --link "抖音分享链接" --action extract --output ./output --save-video

# 安静模式 (减少输出)
python douyin_downloader.py --link "抖音分享链接" --action extract --output ./output --quiet

输出目录结构

提取文案后, 每个视频会保存到独立文件夹:

output/
├── 7600361826030865707/      # 视频ID为文件夹名
│   └── transcript.md         # Markdown 格式文案文件
├── 7581044356631612699/
│   ├── transcript.md
│   └── 7581044356631612699.mp4  # 使用 --save-video 时保存
└── ...

Markdown 文案格式

# 视频标题

| 属性 | 值 |
|------|-----|
| 视频ID | `7600361826030865707` |
| 提取时间 | 2026-01-30 14:19:00 |
| 下载链接 | [点击下载](url) |

---

## 文案内容

(语音识别的文字内容)

方法二: 在 Python 代码中调用

from douyin_downloader import get_video_info, download_video, extract_text

# 获取视频信息
info = get_video_info("抖音分享链接")
print(f"视频ID: {info['video_id']}")
print(f"标题: {info['title']}")
print(f"下载链接: {info['url']}")

# 下载视频
video_path = download_video("抖音分享链接", output_dir="./videos")

# 提取文案并保存到文件
result = extract_text("抖音分享链接", output_dir="./output")
print(f"文案已保存到: {result['output_path']}")
print(result['text'])

工作流程

获取视频信息

解析抖音分享链接, 提取真实的视频 URL
模拟移动端请求获取页面数据
从页面 JSON 数据中提取无水印视频地址
返回视频 ID, 标题和下载链接

提取视频文案

解析分享链接获取视频信息
下载视频到临时目录
使用 FFmpeg 从视频中提取音频 (MP3 格式)
调用硅基流动 SenseVoice API 进行语音识别
清理临时文件, 返回识别的文本

常见问题

无法解析链接

确保链接是有效的抖音分享链接
链接格式通常为 https://v.douyin.com/xxxxx/ 或完整的抖音视频 URL

提取文案失败

检查 API_KEY 环境变量是否已设置
确保 API 密钥有效且有足够的配额
确保 FFmpeg 已正确安装

下载速度慢

这取决于网络条件和视频大小
脚本会显示下载进度

注意事项

本工具仅供学习和研究使用
使用时需遵守相关法律法规
请勿用于任何侵犯版权或违法的目的

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Other
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @yzfly · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Guided setup
External API key: Required · Vendor-specific
Detected OS requirements: macOS · Linux
Runtime requirements: Python
Detected file/system behavior: Read-only
Detected network behavior: External requests
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview douyin-video.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# 抖音无水印视频下载和文案提取

从抖音分享链接获取无水印视频下载链接, 下载视频, 并使用语音识别提取视频中的文案, 自动保存到文件.

## 功能概述

- **获取下载链接**: 从抖音分享链接解析出无水印视频的直接下载地址 (无需 API 密钥)
- **下载视频**: 将无水印视频下载到本地指定目录
- **提取文案**: 通过语音识别从视频中提取文字内容 (需要硅基流动 API 密钥)
- **自动保存**: 每个视频的文案自动保存到独立文件夹 (视频ID为文件夹名)

## 环境要求

### 依赖安装

```bash
pip install requests ffmpeg-python
```

### 系统要求

- FFmpeg 必须安装在系统中 (用于音视频处理)
- macOS: `brew install ffmpeg`
- Ubuntu: `apt install ffmpeg`

### API 密钥配置 (仅文案提取需要)

文案提取功能使用硅基流动 API, 需要设置环境变量:

```bash
export API_KEY="[REDACTED:credential]"
```

获取 API 密钥: https://cloud.siliconflow.cn/

## 使用方法

### 方法一: 使用脚本 (推荐)

```bash
# 获取视频信息和下载链接 (无需 API 密钥)
python douyin_downloader.py --link "抖音分享链接" --action info

# 下载视频到指定目录
python douyin_downloader.py --link "抖音分享链接" --action download --output ./videos

# 提取视频文案并保存到文件 (需要 API_KEY 环境变量)
python douyin_downloader.py --link "抖音分享链接" --action extract --output ./output

# 提取文案并同时保存视频
python douyin_downloader.py --link "抖音分享链接" --action extract --output ./output --save-video

# 安静模式 (减少输出)
python douyin_downloader.py --link "抖音分享链接" --action extract --output ./output --quiet
```

### 输出目录结构

提取文案后, 每个视频会保存到独立文件夹:

```
output/
├── 7600361826030865707/      # 视频ID为文件夹名
│   └── transcript.md         # Markdown 格式文案文件
├── 7581044356631612699/
│   ├── transcript.md
│   └── 7581044356631612699.mp4  # 使用 --save-video 时保存
└── ...
```

### Markdown 文案格式

```markdown
# 视频标题

| 属性 | 值 |
|------|-----|
| 视频ID | `7600361826030865707` |
| 提取时间 | 2026-01-30 14:19:00 |
| 下载链接 | [点击下载](url) |

---

## 文案内容

(语音识别的文字内容)
```

### 方法二: 在 Python 代码中调用

```python
from douyin_downloader import get_video_info, download_video, extract_text

# 获取视频信息
info = get_video_info("抖音分享链接")
print(f"视频ID: {info['video_id']}")
print(f"标题: {info['title']}")
print(f"下载链接: {info['url']}")

# 下载视频

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> 功能概述 → 环境要求 → 依赖安装 → 系统要求 → API 密钥配置 (仅文案提取需要) → 使用方法
terms    -> 获取下载链接 · 下载视频 · 提取文案 · 自动保存
files/cmd -> brew install ffmpeg · apt install ffmpeg · 7600361826030865707 · https://v.douyin.com/xxxxx/ · APIKEY
body sha256 -> 416f7f80bf30