assetseeker

Asset Seeker — 在线创意素材搜索

概述

从精选的高质量来源中搜索互联网上可免费商用的创意素材。涵盖 照片、插画、图标、视频片段、音乐、音效和字体——所有素材都已核验授权安全性（CC0 / 可免费商用）。

本工具基于“创作者素材库大盘点”视频中的研究成果——每个来源都已核验授权条款、中国大陆访问情况和 API 可用性。

何时使用此技能

当用户需要为内容创作寻找在线素材时启用：

• “帮我找一张适合视频缩略图的山景照片”
• “搜索线条风格的笔记本电脑图标”
• “我需要一段用于 B-roll 的城市交通无人机航拍视频”
• “找一段舒缓的钢琴背景音乐”
• “搜索适合标题的粗体中文字体”
• “找一张科技感的图片” / “帮我搜个图标” / “有没有免费商用的视频素材”

请勿用于：本地文件搜索、视频编辑或素材管理工具（Eagle/Billfish）。

支持的来源

照片

来源	API	免费额度	中国大陆访问	授权
Pexels（默认）	✅ 照片 + 视频	每小时 200 次请求，每月 20k 次	✅ 可直接访问	无需署名
Unsplash	✅ 照片	每小时 50 次请求（演示版）	✅ 可直接访问	建议署名
Pixabay	✅ 照片 + 视频	免费	✅ 可直接访问	无需署名

插画与矢量图

来源	API	备注
unDraw	❌	一键重新着色；全部免费
Storyset	❌（Freepik API 需付费）	可编辑角色 + 动画
Humaaans / Open Doodles / Open Peeps	❌	可直接从网站下载

图标

来源	API	免费额度	备注
Iconify（默认）	✅ 开放 API	无需密钥	200 多套图标集，30 万多个图标
Noun Project	✅	每月免费 5,000 次	需要 OAuth

视频片段

来源	API	免费额度	中国大陆访问
Pexels Video（默认）	✅	每小时 200 次请求，每月 20k 次	✅ 可直接访问
Pixabay Video	✅	免费	✅ 可直接访问
Mixkit	🎭 Playwright 爬虫	免费，无需署名	✅ 可直接访问
Coverr	✅	需要申请	✅ 可直接访问

音乐与音效

来源	API	备注
Freesound（音效默认来源）	✅	OAuth，社区中规模最大的音效库
Pixabay Music	❌ 音乐 API 不可用	仅支持网页下载；无需署名
YouTube Audio Library	❌	需手动操作；部分素材需要署名

字体

来源	API	备注
Google Fonts（默认）	✅ 元数据 API	1,500 多个字体系列，OFL
100font	❌	优质中文免费字体目录

工作流

步骤 1 — 理解请求

确定：

• 素材类型：照片 / 图标 / 视频 / 音乐 / 音效 / 字体 / 插画
• 关键词：用户要搜索的内容
• 风格提示：方向、颜色、氛围、风格

如果类型不明确，请简短询问；否则继续操作。

步骤 2 — 检查 API 密钥

运行前置检查：

SKILL_DIR="${SKILL_DIR:-${CLAUDE_SKILL_DIR}}"
python3 "${SKILL_DIR}/scripts/seek_assets.py" sources

这会列出所有可用来源及其 API 密钥是否已配置。如果没有任何 API 密钥，只有 Iconify（图标）可用——请告知用户，并建议至少配置 PEXELS_API_KEY（免费，适用范围最广）。

步骤 3 — 搜索

# Photo search (searches Pexels + Pixabay + Unsplash in parallel when keys are set)
python3 "${SKILL_DIR}/scripts/seek_assets.py" search photo "mountain sunset"

# Icon search (Iconify — always works, no key needed)
python3 "${SKILL_DIR}/scripts/seek_assets.py" search icon "laptop"

# Video search (via Pexels API)
python3 "${SKILL_DIR}/scripts/seek_assets.py" search video "city traffic"

# Video search (via Mixkit Playwright scraper — no API key needed)
python3 "${SKILL_DIR}/scripts/seek_assets.py" search video "sunset" --source mixkit

# Sound effect search
python3 "${SKILL_DIR}/scripts/seek_assets.py" search sfx "whoosh"

# Font search
python3 "${SKILL_DIR}/scripts/seek_assets.py" search font "bold sans-serif"

# Limit results
python3 "${SKILL_DIR}/scripts/seek_assets.py" search photo "cat" --max 10

# Filter by orientation
python3 "${SKILL_DIR}/scripts/seek_assets.py" search photo "landscape" --orientation landscape

# Human-readable output
python3 "${SKILL_DIR}/scripts/seek_assets.py" search icon "arrow" --format text

步骤 4 — 展示结果

对每项结果，展示：

• 缩略图 / 预览 URL（如有）
• 来源名称 + 授权
• 下载链接或说明
• 任何署名要求

对于 Iconify，还要展示图标集名称并建议用法（例如：<span class="iconify" data-icon="mdi:laptop">）。

步骤 5 — 下载（如有需要）

python3 "${SKILL_DIR}/scripts/seek_assets.py" download <url> --output poster_bg.jpg

对于没有直接 API 下载功能的来源，请在浏览器中打开页面 URL，或指导用户手动下载。

命令

search — 查找素材

python3 seek_assets.py search <type> <keyword> [options]

类型：photo、icon、video、music、sfx、font

选项：

• --max N — 每个来源的结果数（默认：10）
• --source S — 指定来源（例如，--source pexels、--source iconify）
• --orientation landscape|portrait|square — 照片/视频方向
• --color red|orange|yellow|green|... — 照片颜色筛选（Pexels/Pixabay）
• --format json|text — 输出格式（默认：json）

sources — 列出可用来源

python3 seek_assets.py sources
python3 seek_assets.py sources --type photo

显示每个来源的状态：是否已配置 API 密钥、免费层级限制、中国可访问性。

download — 下载单个素材

python3 seek_assets.py download <url> --output <path>

环境变量

# Photo & Video (get free key at pexels.com/api)
export PEXELS_API_KEY="your-pexels-api-key"

# Photo (get free key at unsplash.com/developers)
export UNSPLASH_ACCESS_KEY="your-unsplash-access-key"

# Photo & Video (get free key at pixabay.com/api/docs)
export PIXABAY_API_KEY="your-pixabay-api-key"

# Sound Effects (get key at freesound.org/apiv2/apply)
export FREESOUND_API_KEY="your-freesound-api-key"
# Optional: OAuth token for higher rate limits
export FREESOUND_TOKEN="your-oauth-token"

# Fonts (get key at console.cloud.google.com)
export GOOGLE_FONTS_API_KEY="your-google-fonts-api-key"

# Noun Project icons (get key at thenounproject.com/developers)
export NOUN_PROJECT_KEY="your-noun-project-key"
export NOUN_PROJECT_SECRET="your-noun-project-secret"

优先级顺序：至少设置 PEXELS_API_KEY（免费，支持照片和视频）。Iconify 无需密钥即可使用。

获取 API 密钥

服务	注册网址	获取密钥所需时间
Pexels	https://www.pexels.com/api/	~2 分钟
Unsplash	https://unsplash.com/developers	~5 分钟（需要注册应用）
Pixabay	https://pixabay.com/api/docs/	~2 分钟
Freesound	https://freesound.org/apiv2/apply/	~1 天（需人工审核）
Google Fonts	https://console.cloud.google.com/	~5 分钟

要求

# Core (stdlib, no pip needed for photos/icons/fonts)
pip install requests

# Optional: for Mixkit Playwright scraper
pip install playwright && python -m playwright install chromium

手动来源（无 API — Agent 提供直接指导）

这些来源已记录在该技能的知识库中，但没有编程 API。用户提出这类需求时，Agent 会提供精选建议和直接链接：

• 插画：unDraw、Storyset、ManyPixels、DrawKit、IRA Design、Open Doodles
• 视频（无 API）：Mixkit、Coverr、Mazwai、Videvo
• 音乐（无 API）：Pixabay Music、YouTube Audio Library、Freepd、Uppbeat
• 字体（无 API）：100font（100font.com）、猫啃网（maoken.com）
• 表情符号：Fluent Emoji、Twemoji、OpenMoji、Noto Emoji
• AI 工具：remove.bg、Suno、即梦、可灵 Kling

用户需要这些内容时，Agent 应查阅 references/asset_catalog.md 获取完整的精选列表。

参考资料

• references/asset_catalog.md — 包含网址、许可、中国可访问性和备注的完整精选来源目录（摘自创作者素材调研）

项目结构

assetseeker/
├── SKILL.md                   # This file (in skills/assetseeker/)
├── README.md                  # English README
├── README_CN.md               # Chinese README
├── references/
│   └── asset_catalog.md       # Full curated source catalog
└── skills/
    └── assetseeker/
        ├── SKILL.md
        ├── references/
        │   └── asset_catalog.md
        └── scripts/
            └── seek_assets.py # Main CLI

相关技能

• video-podcast-maker — 使用这些素材的视频制作流程
• imagencn — 真实照片无法满足需求时使用的 AI 图像生成工具