一、这个 skill 是做什么的
这个 skill 是一个"说人话就能用"的媒体下载助手。你不用懂任何命令,只要告诉我"想要什么",它就会自动去搜索并下载对应的图片或视频片段,而且支持把视频自动剪裁到你指定的长度。
它对接四大来源:Pexels / Unsplash / Pixabay 三大免版权图库(图片+部分视频,适合做配图、壁纸、素材),以及 YouTube(视频内容丰富,支持按时间段裁剪、甚至只抽音频)。下载的图片默认取原图高清分辨率,视频可指定时长自动裁剪。
它最大的贴心点是按需配置、不折腾人:下载 YouTube 视频完全不需要任何 Key;首次下图片时才检查图库 Key,而且会像聊天一样帮你对比选平台,不会一上来就甩一堆配置要求。
二、什么时候用它
- 你想找一批配图("帮我下载 5 张星空图片""找些适合做壁纸的风景图")。
- 你要一段短视频素材做背景("下载 15 秒海浪视频""找城市夜景视频 30 秒以内")。
- 你想下载某个 YouTube 视频,或只要其中的某一小段("下载第 2 分钟到第 3 分钟")。
- 你只想提取 YouTube 视频的音频("只下载这个视频的音频")。
- 你中英文混合下指令都行("Download sunset photos" / "找一段 ocean wave 视频")。
三、前置条件 / 准备
- 下载 YouTube 视频:直接就能用,不需要任何 API Key。
- 下载图片/图库视频:首次使用会从 Pexels / Unsplash / Pixabay 三家里挑。三个都免费,注册后一键生成 Key。AI大模型或AI智能体 会先检查你是否已配置,若都没配会列出三家对比让你选。
三家图库怎么选(都免费):
• Pexels:高质量、更新快,搜英文效果更好。
• Pixabay:数量多、种类全,插图/矢量图丰富。
• Unsplash:艺术感强,风光/人文类尤其出色(适合壁纸)。
若你已配了其中任意一家,会直接用已有源下载,并提示你可补配其他家以扩大覆盖范围。
进阶 / 可选依赖(普通对话下载时由 AI大模型或AI智能体 自动处理,无需你手动装):
requests(图库搜索下载必需)、yt-dlp(YouTube 下载必需)、ffmpeg(视频剪辑必需,Windows 可用 winget install ffmpeg 安装)。
下载位置:所有文件默认保存在 ~/.ai-agent/skills/media-downloader/downloads/(即你用户目录下的该路径)。如果找不到,去这个文件夹里看。
四、具体用法(步骤)
- 说清你要什么:直接用自然语言告诉 AI大模型或AI智能体 关键词、数量、时长。例如"帮我下载 5 张星空的图片"。
- 图片首次会问平台:若三个图库 Key 都没配,AI大模型或AI智能体 会列出 Pexels/Pixabay/Unsplash 对比,你挑一个(或说"都配上")。注册拿 Key 后它会自动接着下。
- 视频可指时长:"下载一段 30 秒以内的城市夜景视频"会自动裁剪到时长内。
- YouTube 可指时间段:贴链接 + "第 2 分钟到第 3 分钟"即可裁剪;"只要音频"会抽音轨。
- 等下载完成:AI大模型或AI智能体 会告诉你文件落在 downloads 文件夹的哪个位置。
五、可直接照用的示例
你直接对 AI大模型或AI智能体 说:「帮我下载 5 张星空的图片,要高清的。」
AI大模型或AI智能体 会:先检查图库 Key 状态;若没配就给你三家对比让你选,选好后从对应图库搜"starry sky / 星空"并下载 5 张原图分辨率图片,存到 downloads 文件夹并告诉你路径。
你直接对 AI大模型或AI智能体 说:「下载这个 YouTube 视频的第 1 分 30 秒到第 2 分钟:https://youtube.com/watch?v=xxx」
AI大模型或AI智能体 会:直接用 yt-dlp 拉下该视频并自动用 ffmpeg 裁出 1:30–2:00 这一段,不需要你提供任何 Key,下完告诉你文件位置。
你直接对 AI大模型或AI智能体 说:「找一段 15 秒左右的海浪视频,做背景用。」
AI大模型或AI智能体 会:从免费视频源搜"ocean wave",下载并自动裁剪到约 15 秒的片段,存到 downloads 文件夹。
进阶 / 可选:如果你习惯命令行,也可以用自带 CLI(<skill_dir> 指该 skill 安装目录,由 AI大模型或AI智能体 自动替换):
# 检查各图库 API Key 配置状态
python /media_cli.py status
# 下载图片(关键词/数量/输出目录)
python /media_cli.py image "星空" -n 5 -o 输出目录
# 下载视频素材(关键词/最大时长/数量)
python /media_cli.py video "ocean wave" -d 15 -n 1
# 下载 YouTube 视频并可裁剪时间段(秒)
python /media_cli.py youtube "URL" --start 90 --end 120
# 只搜索不下载
python /media_cli.py search "关键词" --type image/video/all
# 剪辑本地已有视频
python /media_cli.py trim 输入文件 --start 开始 --end 结束
六、常见注意 / 避坑
- YouTube 不用 Key,但图库要:下 YouTube 视频完全免费无需配置;首次下图片才需要图库 Key,且 AI大模型或AI智能体 会引导你选,不会一上来就拦你。
- 找不到下载文件:默认都在
~/.ai-agent/skills/media-downloader/downloads/,先去那看,别以为没下下来。
- 图库搜索英文更准:尤其是 Pexels,用英文关键词(如 "sunset")往往比中文结果更好,需要中文意境时可中英混用。
- 剪辑依赖 ffmpeg:视频裁剪/抽音频需要 ffmpeg;若命令报错多半是没装,Windows 用
winget install ffmpeg 装一下即可。
- 免费图库可商用:Pexels/Pixabay/Unsplash 多为免费授权,但正式商用前仍建议看一眼具体素材的许可说明。
七、相关 skill / 延伸
- video-editor:媒体下载器偏"获取素材",若下载后想做更精细的裁剪/合并/配音/加字幕,可交给 video-editor。
- ai-image-generation:若你要的不是"真实素材"而是"AI 生成的图",可改用此 skill 直接出图。
- ai-video-generation:同理,若你要的是 AI 生成的视频而非下载的真实片段,可配合此 skill。
- video-subtitle-author:下载 YouTube 视频后想加字幕/文案,可延伸使用。