← 返回 Skills 市场
125
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install douyin-transcribe-fast
功能描述
抖音视频快速转文字(优化版)。用户发抖音链接,自动提取文案。 特点:本地 Whisper 转录,无需 API Key,零成本,高隐私。 触发词:抖音、转文字、提取文案、视频转录
使用说明 (SKILL.md)
抖音视频快速转文字(优化版)🎬➡️📝
本地 Whisper 转录,无需 API Key,零成本,高隐私。
前置依赖检查
使用前确保以下工具已安装:
1. Python 3.8+
python --version
2. FFmpeg(音频处理)
ffmpeg -version
未安装?Windows: winget install Gyan.FFmpeg
3. OpenAI Whisper(本地转录)
pip install openai-whisper
使用方式
方式 1:抖音链接
用户发送抖音链接,如:
2.89 03/17 zTl:/ [email protected] 真正赚钱的人到底怎么用 AI? https://v.douyin.com/D4SVbwCEY6g/
执行步骤:
步骤 1:解析视频信息
使用 douyin-mcp 获取视频下载链接:
mcporter call douyin-mcp.parse_douyin_video_info share_link="\x3C抖音链接>"
步骤 2:下载视频(仅音频流)
ffmpeg -i "\x3C视频URL>" -vn -acodec pcm_s16le -ar 16000 -ac 1 "audio.wav" -y
步骤 3:本地 Whisper 转录
whisper "audio.wav" --model tiny --language Chinese --output_format txt
💡 优化提示:
- 使用
tiny模型最快(适合短视频)- 使用
base模型平衡速度和质量- 使用
small模型质量最好(适合长视频)
步骤 4:返回结果
读取生成的 txt 文件,返回给用户。
方式 2:本地视频文件
用户发送视频文件,直接执行步骤 3-4。
优化策略
🚀 速度优化
| 策略 | 效果 | 适用场景 |
|---|---|---|
| 只下载音频流 | 减少 90% 下载时间 | 所有视频 |
| 使用 tiny 模型 | CPU 转录 1-2 分钟 | 短视频 (\x3C3分钟) |
| 使用 base 模型 | CPU 转录 3-5 分钟 | 中等视频 (3-10分钟) |
| 跳过视频下载 | 直接提取音频 URL | 网页版抖音 |
💰 成本优化
- 零 API 费用:本地 Whisper 完全免费
- 零网络依赖:不需要 Groq/OpenAI API
- 隐私保护:视频/音频不离开本地机器
🛡️ 稳定性优化
- 不依赖浏览器:避免抖音反爬和登录问题
- 不依赖第三方 API:避免 API 限制和费用
- 离线可用:安装后无需网络即可转录
完整工作流程
用户发送抖音链接
↓
提取 modal_id / 视频 URL(通过 douyin-mcp)
↓
下载音频流(ffmpeg,~1-5MB)
↓
本地 Whisper 转录(tiny/base/small 模型)
↓
返回中文文案
总耗时:
- 短视频(\x3C3分钟):2-3 分钟
- 中等视频(3-10分钟):5-8 分钟
- 长视频(>10分钟):10-15 分钟
故障排查
| 问题 | 原因 | 解决 |
|---|---|---|
| douyin-mcp 返回 403 | API Key 无效 | 检查 ~/.cursor/mcp.json 配置 |
| ffmpeg 未找到 | 未安装或不在 PATH | 安装 ffmpeg 并添加到环境变量 |
| whisper 未找到 | 未安装 | 运行 pip install openai-whisper |
| 转录质量差 | 模型太小或音频不清 | 改用 base/small 模型 |
| 转录速度慢 | CPU 性能不足 | 使用 tiny 模型或升级硬件 |
模型选择建议
| 模型 | 速度 | 质量 | 显存/内存 | 推荐场景 |
|---|---|---|---|---|
| tiny | ⚡ 最快 | ⭐⭐ | ~1GB | 短视频、快速预览 |
| base | 🚀 快 | ⭐⭐⭐ | ~1GB | 日常使用 |
| small | 🚗 中等 | ⭐⭐⭐⭐ | ~2GB | 高质量需求 |
| medium | 🐢 慢 | ⭐⭐⭐⭐⭐ | ~5GB | 专业用途 |
配置示例
Windows PowerShell 环境变量
$env:PATH = "C:\Users\\x3C用户名>\AppData\Local\Programs\Python\Python311\Scripts;" +
"C:\ffmpeg\bin;" +
$env:PATH
快速转录命令
# 下载音频
ffmpeg -i "\x3C视频URL>" -vn -acodec pcm_s16le -ar 16000 -ac 1 "audio.wav" -y
# 转录(tiny 模型,最快)
whisper "audio.wav" --model tiny --language Chinese --output_format txt
# 转录(base 模型,平衡)
whisper "audio.wav" --model base --language Chinese --output_format txt
与原版 skill 对比
| 特性 | douyin-transcribe | douyin-transcribe-fast(本版) |
|---|---|---|
| 依赖 | Groq API Key | 无需 API Key |
| 费用 | 免费(Groq) | 完全免费 |
| 隐私 | 音频上传到 Groq | 完全本地 |
| 速度 | 3-5 秒 | 2-15 分钟(取决于视频长度) |
| 网络要求 | 需要网络 | 安装后离线可用 |
| 准确度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐(small模型) |
| 适用场景 | 快速转录、大量视频 | 隐私敏感、离线环境、零成本 |
最佳实践
- 短视频(\x3C3分钟):直接用 tiny 模型,2分钟出结果
- 中等视频(3-10分钟):用 base 模型,平衡速度和质量
- 长视频(>10分钟):用 small 模型,或分段处理
- 批量处理:先下载所有音频,再批量转录
- 质量优先:对重要视频使用 small 模型,日常用 base
技术栈
- douyin-mcp:获取视频信息
- ffmpeg:音频提取和处理
- OpenAI Whisper:本地语音识别
- Python:运行环境
优化版 Skill,让抖音文案提取更简单、更私密、更经济。
安全使用建议
This skill appears to do what it claims (local Whisper transcription), but proceed with caution. Key points:
- The script calls 'mcporter' (douyin-mcp) to parse Douyin links but the SKILL.md didn't list mcporter as a required tool — make sure you install and trust mcporter before use.
- The script builds shell commands with user-supplied values (share links and extracted URLs) and runs them with shell=True. That is a real command-injection risk if you or others pass crafted inputs. Prefer running it only on trusted inputs or run the script in an isolated environment (container/VM) until the code is patched to use subprocess with argument lists (no shell) and proper input validation/escaping.
- Transcripts are saved under ~/.openclaw/workspace/douyin-transcripts; confirm you are comfortable with this persistent storage location.
- If you plan to run this on a multi-user or server environment, review and harden the script (remove shell=True, validate/sanitize inputs, and explicitly require mcporter in documentation) before enabling autonomous invocation.
If you want, I can suggest a small patch to the script that removes shell=True and safely constructs subprocess calls, and I can point out exactly where to add mcporter as a documented dependency.
功能分析
Type: OpenClaw Skill
Name: douyin-transcribe-fast
Version: 1.0.0
The skill provides legitimate functionality for transcribing Douyin videos using local Whisper, but it contains a shell injection vulnerability in `scripts/douyin_transcribe_fast.py`. The script uses `subprocess.run(shell=True)` to execute CLI commands (ffmpeg, whisper, mcporter) while wrapping user-provided inputs in double quotes without sufficient sanitization, which could lead to remote code execution (RCE) if a malicious URL or filename is processed. While the behavior is aligned with the stated purpose and no evidence of intentional malice or data exfiltration was found, the implementation poses a significant security risk.
能力评估
Purpose & Capability
The name/description (local Whisper transcription of Douyin videos) aligns with the code and instructions: it uses douyin-mcp to get a video URL, ffmpeg to extract audio, and local Whisper to transcribe. Minor inconsistency: the SKILL.md pre-requisites list Python, ffmpeg, and openai-whisper but omit the required 'mcporter' tool (used to call douyin-mcp) which is necessary for URL extraction.
Instruction Scope
The SKILL.md and script instruct running shell commands that include user-provided data (share links and extracted video URLs). The Python script constructs shell commands (via subprocess.run with shell=True) embedding these values without escaping or sanitization, which opens the door to command injection if input is malicious or crafted. Aside from that, instructions stay within the transcription purpose and do not attempt to read unrelated system secrets or send outputs to hidden endpoints.
Install Mechanism
No install spec (instruction-only + single helper script) — nothing is downloaded or written automatically by an installer. Dependencies are managed manually (ffmpeg, whisper, mcporter). This is lower risk from an install-source perspective, but the README omission of mcporter is an operational gap.
Credentials
The skill declares no credentials or environment variables and does not request unrelated secrets. It writes transcripts into a directory under the user's home (~/.openclaw/workspace/douyin-transcripts), which is reasonable for this function but worth noting as persisted data on disk.
Persistence & Privilege
The skill is not marked 'always:true' and uses normal autonomous invocation defaults. It does not attempt to modify other skill configurations or require elevated privileges.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install douyin-transcribe-fast - 安装完成后,直接呼叫该 Skill 的名称或使用
/douyin-transcribe-fast触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- 首发版本,实现抖音视频本地极速转文字。
- 支持用户发送抖音链接或视频文件,自动提取音频并本地 Whisper 转录,无需 API Key。
- 依赖 Python、ffmpeg 和 openai-whisper(本地安装,无外部请求,保护隐私)。
- 多模型选择(tiny/base/small)兼顾转录速度与质量,灵活适配短/中/长视频场景。
- 零成本,离线可用,完整支持隐私敏感和网络受限环境。
- 提供详细安装教程、使用流程与常见问题排查。
元数据
常见问题
抖音视频快速转文字 是什么?
抖音视频快速转文字(优化版)。用户发抖音链接,自动提取文案。 特点:本地 Whisper 转录,无需 API Key,零成本,高隐私。 触发词:抖音、转文字、提取文案、视频转录. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 125 次。
如何安装 抖音视频快速转文字?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install douyin-transcribe-fast」即可一键安装,无需额外配置。
抖音视频快速转文字 是免费的吗?
是的,抖音视频快速转文字 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
抖音视频快速转文字 支持哪些平台?
抖音视频快速转文字 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 抖音视频快速转文字?
由 btboy773(@btboy773)开发并维护,当前版本 v1.0.0。
推荐 Skills