instagram-reels

🎬 短视频一键转录归档助手

基于 yt-dlp 与 Groq Whisper 的 Instagram Reels 下载转录方案,无需登录即可提取公开视频音频与字幕,适合内容研究与归档场景。

收藏
8k
安装
2.2k
版本
v1.0.0
CLS 安全性认证2026-05-16
点击查看完整报告 >

使用说明

核心用法

该 Skill 提供了一套完整的 Instagram Reels 处理流水线,通过三步操作实现视频元数据提取、音频下载与语音转录。用户只需提供 Reel URL,即可获取包含原始描述、上传者信息、时长元数据以及完整音频转录文本的结构化输出。技术栈采用 yt-dlp 进行无登录视频解析(支持公开内容),ffmpeg 完成音频格式转换,最终调用 Groq 免费的 Whisper API 实现极速转录(约 1-2 秒返回)。

显著优点

零门槛接入:无需 Instagram 账号即可处理公开 Reels,降低了数据采集门槛。多平台兼容:同一套流程可复用于 TikTok、YouTube Shorts 等 yt-dlp 支持的平台。成本优势:Groq Whisper 提供免费额度,转录成本远低于商业方案。技术透明:纯文档型 Skill,无隐藏代码,所有操作均可审计验证。响应速度:Groq 推理加速使得长音频转录可在秒级完成,支持 25 分钟以内的内容。

潜在缺点与局限性

隐私内容受限:私有 Reels 需要手动导出浏览器 Cookie,操作门槛显著提高。临时文件管理:/tmp 目录的元数据与音频文件不会自动清理,存在磁盘占用与隐私残留风险。版权合规灰色地带:下载第三方内容可能违反平台服务条款,商业使用需谨慎评估。单点依赖:核心功能绑定 Groq API,若服务调整或密钥失效将完全不可用。格式脆弱性:依赖 yt-dlp 解析 Instagram 页面结构,平台反爬升级可能导致方案失效。

适合的目标群体

内容研究者、社交媒体分析师、无障碍服务开发者、多语言字幕制作团队,以及需要批量归档公开短视频素材的创作者。特别适合研究短视频传播规律、提取教育类内容文本、或为听障用户生成字幕的场景。

使用风险

API 密钥泄露:GROQ_API_KEY 需通过环境变量注入,在共享环境或日志中可能意外暴露。供应链稳定性:yt-dlp 需持续更新以应对平台反制,ffmpeg 版本差异可能导致编码失败。法律合规风险:未经授权下载与转录可能触发 DMCA 投诉或账号封禁。数据残留:临时文件包含视频元数据与音频副本,多用户环境下存在信息泄露隐患。

安全解读

核心用法

该 Skill 提供完整的 Instagram Reels(及 TikTok、YouTube Shorts)下载与音频转录流程,分为三步:

1. 元数据提取:使用 yt-dlp --write-info-json 获取视频描述、作者、时长及 CDN 地址,无需登录即可处理公开内容
2. 音频下载与转换:从 JSON 解析音频 URL,用 curl 下载 m4a 后通过 ffmpeg 转为 MP3

3. AI 转录:调用 Groq Whisper API(whisper-large-v3-turbo)生成带时间戳的字幕,支持自动语言检测

显著优点

  • 零代码依赖:纯 Markdown 文档,用户可复制粘贴执行,无隐藏逻辑
  • 工具链成熟:yt-dlp、ffmpeg、curl 均为行业标准工具,社区维护活跃
  • 免费 AI 转录:Groq 提供速率限制下的免费 Whisper 服务,响应速度 1-2 秒
  • 多平台兼容:同一流程适用于 TikTok、YouTube Shorts 等 yt-dlp 支持的 1000+ 站点
  • 隐私友好:本地处理元数据和音频文件,仅转录环节上传音频

潜在缺点与局限性

  • T3 来源风险:维护者为个人开发者 antoinedc,无企业背书,需自行审计代码
  • 外部依赖脆弱:Instagram/TikTok 频繁更新反爬机制,yt-dlp 需持续更新
  • 速率限制瓶颈:Groq 免费 tier 有请求频次限制,高并发场景需付费升级
  • 私有内容限制:需手动导出浏览器 cookies,操作门槛较高
  • 无错误处理:示例代码无重试、无异常捕获,生产环境需自行加固
  • 25 分钟上限:单条音频转录时长受限,长视频需切片处理

适合人群

  • 内容创作者批量归档自己的 Reels/Shorts 文案
  • 研究人员采集公开短视频进行文本分析
  • 无障碍需求用户获取视频字幕文本
  • 开发者作为 yt-dlp + Whisper 集成的参考实现

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| API 密钥泄露 | GROQ_API_KEY 需通过环境变量注入 | 使用 `.env` 或密钥管理工具,避免硬编码 |
| 命令注入 | URL 未经严格过滤传入 shell | 验证 URL 域名,避免特殊字符 |
| 临时文件残留 | /tmp 文件可能泄露敏感内容 | 执行后主动清理,注意多用户环境权限 |
| 版权合规 | 下载他人内容可能违反平台 ToS | 仅处理自有内容或获得授权的内容 |
| 隐私数据外传 | 音频上传至 Groq 服务器 | 阅读 Groq 数据保留政策,避免敏感内容 |

instagram-reels 内容

手动下载zip · 1.9 kB
SKILL.mdtext/markdown
请选择文件