用途
Asset Seeker 用于在互联网上搜索可免费商用的创意素材，覆盖照片、插图、图标、视频素材、音乐、音效和字体。资料称各来源均经过许可条款、中国可访问性和 API 可用性核实，许可类型包括 CC0 或免费商用。它不用于本地文件搜索、视频剪辑或素材管理工具（如 Eagle/Billfish）。
主要能力
- 统一搜索入口：通过 seek_assets.py 的 search 命令按类型和关键词检索。支持类型为 photo、icon、video、music、sfx、font。
- 多来源聚合：照片可并行搜索 Pexels、Pixabay、Unsplash；图标默认使用 Iconify（无需 Key，200+ 图标集、30 万+ 图标）；视频可用 Pexels Video、Pixabay Video，或用 Mixkit 的 Playwright 抓取（无需 API Key）；音效默认 Freesound；字体默认 Google Fonts。
- 筛选与输出控制：--max 控制每个来源结果数（默认 10）；--source 指定来源；--orientation 支持 landscape/portrait/square；--color 支持颜色过滤（Pexels/Pixabay）；--format 支持 json/text。
- 来源状态检查：sources 命令列出各来源是否已配置 API Key、免费额度、中国可访问性，可按类型过滤。
- 素材下载：download 命令下载单个素材到指定路径；无直接 API 下载的来源则提供页面链接或指导手动下载。
- 人工来源指引：对无 API 的插图、视频、音乐、字体、Emoji 等来源，提供精选推荐与直接链接，完整目录见 references/asset_catalog.md。
使用方式
先运行来源检查： python3 "${SKILL_DIR}/scripts/seek_assets.py" sources 搜索示例： python3 "${SKILL_DIR}/scripts/seek_assets.py" search photo "mountain sunset" python3 "${SKILL_DIR}/scripts/seek_assets.py" search icon "laptop" python3 "${SKILL_DIR}/scripts/seek_assets.py" search video "city traffic" python3 "${SKILL_DIR}/scripts/seek_assets.py" search video "sunset" --source mixkit python3 "${SKILL_DIR}/scripts/seek_assets.py" search sfx "whoosh" python3 "${SKILL_DIR}/scripts/seek_assets.py" search font "bold sans-serif" python3 "${SKILL_DIR}/scripts/seek_assets.py" search photo "cat" --max 10 python3 "${SKILL_DIR}/scripts/seek_assets.py" search photo "landscape" --orientation landscape python3 "${SKILL_DIR}/scripts/seek_assets.py" search icon "arrow" --format text 下载示例： python3 "${SKILL_DIR}/scripts/seek_assets.py" download <url> --output poster_bg.jpg 环境变量：PEXELS_API_KEY、UNSPLASH_ACCESS_KEY、PIXABAY_API_KEY、FREESOUND_API_KEY、FREESOUND_TOKEN、GOOGLE_FONTS_API_KEY、NOUN_PROJECT_KEY、NOUN_PROJECT_SECRET。资料建议至少配置免费的 PEXELS_API_KEY（覆盖照片与视频）；Iconify 无需任何 Key。 依赖：核心功能需 pip install requests；Mixkit 抓取需 pip install playwright && python -m playwright install chromium。
适用场景
为视频封面找照片、搜索描边风格笔记本电脑图标、寻找城市交通航拍 B-roll、查找舒缓钢琴背景音乐、搜索粗体中文字体做标题等。用户用中文提出“找一张科技感的图片”“帮我搜个图标”“有没有免费商用的视频素材”时也适用。
限制
资料未提供各来源的完整价格与长期可用性承诺，仅列出免费额度（如 Pexels 200 次/小时、2 万次/月；Unsplash demo 50 次/小时；Noun Project 每月 5000 次）。Freesound 需 OAuth 且审批约 1 天。部分来源（unDraw、Storyset、Humaaans、Pixabay Music、YouTube Audio Library、100font、猫啃网等）无程序化 API，只能提供链接或手动下载指导。音乐类型在资料中未列出可用的 API 搜索来源，Pixabay Music API 不可用。未配置任何 API Key 时仅图标搜索可用。