Communitygithub.com

IsaacBell/pexels

Pexels APIからロイヤリティフリーのストックフォトを検索・取得します。ストックフォトの検索、プレースホルダー/デモ/シード画像の準備、ギャラリーの生成、プロジェクト用の画像が必要な場合に便利です(例:「Xの写真を5枚見つけて」「ヒーローセクションのストック画像を取得」「Pexelsから画像をシード」)。

pexels とは?

このスキルは、Pexels APIを利用してロイヤリティフリーの高品質ストックフォトを検索・取得するためのツールです。ユーザーが「猫の写真を3枚見つけて」や「ヒーローセクションに使うストック画像を取得して」といったリクエストをした際に、キーワード検索やカテゴリ指定に基づいて画像を取得します。主にAIエージェント(Claude Code, Cursor, Codexなど)がコード生成やプロトタイプ作成時に、実際の画像を埋め込む必要がある場合に活用されます。Pexels APIの無料プランに対応しており、APIキーを環境変数で設定するだけで簡単に利用可能です。返される画像データは、URLやライセンス情報、撮影者クレジットを含み、プロジェクトに直接組み込むことができます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IsaacBell/ai-marketing-toolkit/tree/main/skills/pexels

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

pexels は何をしますか?

Pexels APIからロイヤリティフリーのストックフォトを検索・取得します。ユーザーがストックフォトの検索、プレースホルダー/デモ/シード画像の準備、ギャラリーの生成、またはプロジェクト用の実際のロイヤリティフリー画像を必要とする場合(例:「Xの写真を5枚見つけて」「ヒーローセクションのストック画像を取得」「Pexelsから画像をシード」)に使用します。

セットアップ

  1. Pexels APIにアクセスし、無料のAPIキーを取得します。
  2. 環境変数 PEXELS_API_KEY を設定します:
export PEXELS_API_KEY="your_api_key_here"

使い方

写真を検索

キーワードに基づいて写真を検索できます:

from pexels import search_photos

# 特定のクエリで写真を検索
results = search_photos("自然", per_page=5)

写真IDで取得

Pexelsの写真IDを使用して単一の写真を取得:

from pexels import get_photo

photo = get_photo(2014422)

人気の写真

現在人気のある写真を取得:

from pexels import get_curated_photos

curated = get_curated_photos(per_page=10)

応答形式

各写真には以下のフィールドが含まれます:

  • id:一意の写真ID
  • width:画像の幅(ピクセル)
  • height:画像の高さ(ピクセル)
  • url:Pexels上の写真ページURL
  • photographer:写真家の名前
  • photographer_url:写真家のPexelsプロフィール
  • src:利用可能な各解像度の画像URLを含むオブジェクト(original, large, medium, small)
  • alt:画像の代替テキスト

例

カスタムギャラリーウィジェットへの画像のシード:

from pexels import search_photos

photos = search_photos("都会の風景", per_page=5)
for photo in photos:
    print(f"{photo['alt']} - {photo['photographer']}")
    print(f"ダウンロード: {photo['src']['medium']}")

注意事項

  • Pexels APIは無料ですが、レート制限があります。詳しくはPexels APIドキュメントをご確認ください。
  • すべての画像はロイヤリティフリーですが、Pexelsの帰属要件に従ってください。
  • 特定のキーワードで結果が返されない場合は、より一般的な用語を試すか、APIの応答を確認してください。

関連スキル