skill
video-material-finder
通用 Agent Skill:跨平台查找指定视频、高清来源与可授权下载的视频素材,核验许可证并返回直链。
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/30bewater/video-material-finder itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 22, 2026找视频素材(Video Material Finder)
一个面向通用 AI Agent 的开源 Skill:根据标题、截图、台词、人物或片段线索查找特定视频,也可以跨多个公开素材库查找可复用的视频素材,并统一返回来源、清晰度、许可证、署名要求和直接下载地址。
它解决什么问题
- 找到某个视频的原始/官方出处和更高清版本
- 搜索 YouTube、Bilibili 和可选的 Brave Video Search
- 搜索 Wikimedia Commons、NASA、美国国会图书馆、Pexels、Pixabay
- 把不同平台结果统一成一套字段,自动去重
- 区分“能观看”“免版税”“Creative Commons”“公有领域”和“需要人工复核”
- 仅在来源与许可明确时,给出可直接下载的视频文件链接
- 中文默认交互,也支持英文查询和英文输出
为什么不叫“免版权搜索”
“免费”“免版税”和“没有版权”不是一回事。这个 Skill 使用三级状态:
| 状态 | 含义 | 直接下载建议 |
|---|---|---|
reusable | 许可证或公有领域信息明确 | 可以提供文件链接,仍需检查人物、商标、音乐等附加权利 |
review | 馆藏权利因条目而异,或可能含第三方内容 | 可以查看来源,不应直接宣称可商用 |
blocked | 权利不明、保留所有权利或来源不可验证 | 不作为可下载素材推荐 |
安装
使用支持 Agent Skills 的安装器:
npx skills add https://github.com/30bewater/video-material-finder
或克隆后把整个目录放到 Agent 的 Skills 目录;标准入口是根目录的 SKILL.md。Skill 本身不要求一次性安装所有工具,按当前需求选择已有工具或 API。
快速使用
直接对 AI 说:
帮我找 Frank Ocean Endless 的官方或最高画质来源,列出候选链接和已验证分辨率。
帮我找 5 段可商用的 4K 海浪航拍素材,附原始页面、直接下载链接和许可证。
也可以单独运行脚本:
python scripts/probe_sources.py
python scripts/search_stock_video.py "ocean waves" --providers commons,nasa,loc --include-review --format markdown
python scripts/search_specific_video.py "Frank Ocean Endless visual album" --providers youtube,bilibili --format markdown
数据源与配置
| 数据源 | 用途 | 是否需要密钥 | 许可策略 |
|---|---|---|---|
| Wikimedia Commons | CC / 公有领域素材 | 否 | 读取每个文件的机器可读许可证 |
| NASA Image and Video Library | 航天、地球科学、历史视频 | 否 | 默认 review,检查第三方署名与 NASA 标识规则 |
| Library of Congress | 历史影像与馆藏 | 否 | 按条目权利说明判断,默认 review |
| Pexels | 现代图库视频 | PEXELS_API_KEY | Pexels License |
| Pixabay | 现代图库视频 | PIXABAY_API_KEY | Pixabay Content License |
| YouTube | 找特定视频 | 需要本地 yt-dlp,不需要 API key | 只做搜索,不默认允许下载 |
| Bilibili | 找特定视频 | 否(优先使用系统 curl) | 只做搜索,不默认允许下载 |
| Brave Video Search | 更广泛的网页视频搜索 | BRAVE_SEARCH_API_KEY | 只做发现,许可仍看原始页面 |
设置可选密钥:
$env:PEXELS_API_KEY = "your-key"
$env:PIXABAY_API_KEY = "your-key"
$env:BRAVE_SEARCH_API_KEY = "your-key"
脚本只检查密钥是否存在,不会打印密钥值。不要把密钥写进仓库。
兼容性
SKILL.md 遵循通用 Agent Skill 的目录习惯,可供 Codex、Claude Code 及其他会读取 Skill 指令的 Agent 使用。辅助脚本基于 Python 3.10+ 标准库;特定视频的 YouTube 搜索可选依赖 yt-dlp,媒体分析可由 Agent 按需调用 FFmpeg。
限制
- 搜索结果不是法律意见,最终发布者仍需核验授权范围。
- CDN 文件地址可能过期;长期记录应保留素材来源页。
- 人物肖像、商标、建筑、艺术品、音乐和第三方片段可能拥有独立权利。
- 不绕过 DRM、登录、订阅、地区限制或站点反爬机制。
- 不批量镜像素材站,也不把图库内容原样打包转售。
开发验证
python -m unittest discover -s tests -v
python -m py_compile scripts/*.py
python path/to/skill-creator/scripts/quick_validate.py .
License
MIT。素材搜索结果仍受各自来源页面所列许可证与使用条款约束。