assetseeker

Asset Seeker — オンラインのクリエイティブアセット検索

概要

厳選された高品質なソースから、インターネット上の商用利用無料のクリエイティブアセットを検索します。写真、イラスト、アイコン、動画素材、音楽、効果音、フォントに対応しており、すべてライセンスの安全性（CC0／商用利用無料）を確認済みです。

「创作者素材库大盘点」動画の調査内容に基づいています。すべてのソースについて、ライセンス条件、中国からのアクセス可否、API の利用可否を確認済みです。

このスキルを使う場面

ユーザーがコンテンツ制作向けのオンラインアセットを探しているときに有効にします。

• 「動画のサムネイル用に山の写真を探して」
• 「アウトラインスタイルのノートパソコンのアイコンを検索して」
• 「Bロール用に、街の交通を撮影したドローン映像が必要です」
• 「落ち着いたピアノのBGMを探して」
• 「タイトル用の太字の中国語フォントを探して」
• 「科技感のある画像を探して」／「アイコンを検索して」／「商用利用無料の動画素材はありますか」

次の用途には使わないでください：ローカルファイルの検索、動画編集、アセット管理ツール（Eagle／Billfish）。

対応ソース

写真

ソース	API	無料枠	中国からのアクセス	ライセンス
Pexels（デフォルト）	✅ 写真＋動画	200 req/hr、20k/月	✅ 直接アクセス	クレジット表記不要
Unsplash	✅ 写真	50 req/hr（デモ）	✅ 直接アクセス	クレジット表記を推奨
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 req/hr、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 — アセットを1つダウンロード

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 キーの取得

サービス	登録 URL	キーの取得にかかる時間
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 なし — エージェントが直接案内）

これらのソースはスキルのナレッジベースに記載されていますが、プログラムから利用できる API はありません。ユーザーがこれらの種類を求めた場合、エージェントは厳選したおすすめと直接リンクを提示します。

• イラスト：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

これらが必要な場合、エージェントは厳選した一覧全体を確認するために references/asset_catalog.md を参照してください。

参考資料

• references/asset_catalog.md — URL、ライセンス、中国からのアクセス可否、注記を含む、厳選されたソースの総合カタログ（creator-assets の調査結果から抽出）

プロジェクト構成

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 画像生成