list_photos

内容

nameは、人が呼ぶとおりのファイル名（「DSC04851」）で写真を探します。大文字小文字を区別せず、名前の一部に一致し、カンマ区切りで複数の名前を一度に指定できます。ユーザーが挙げた名前を、ほかのすべてのツールが求める写真のidに変えるために使います。takenは、写真が撮影された時刻（EXIFのISO形式の時刻）です。説明がないときに、撮影分を日ごとや夕方ごと（「夕焼けのフレーム」）にまとめる方法になります。taken_after / taken_beforeで絞り込みます（ISO形式、その値を含み、日付だけを指定するとその日全体が対象）。たとえばstatus="keep"、taken_after="2026-09-22T18:00"のようにします。大きな撮影分では、すべてを一覧にせず、絞り込んでください。撮影時刻はanalyze_photosが読み取るので、時刻で絞り込む前にそれを実行してください。それまでは、まだ時刻のない写真が何枚あるかが、応答のnoteに書かれます。ステータス（pending、keep、trash、culled、exported、error）で絞り込むか、省略するとすべてが対象です。大きなライブラリでは、limitとoffsetでページを送ります。応答には、一致した総数が含まれます。この一覧の写真のidが、写真ごとのすべてのツールが求めるものです。

パラメーター

頼み方

名前で呼ぶ必要はありません。やりたいことを伝えれば、エージェントがツールを選びます：

D:/Shoots/eva_tomにある結婚式の撮影分をセレクトして、ベストのフレームを残し、外したものを教えてください。

ライブラリのほかのツール

このツールを使うワークフロー

• AIで結婚式の撮影分をセレクトする — AIによる結婚式の写真セレクト
• クライアント向けギャラリーの写真を選んでエクスポートする — AIでクライアントギャラリーのベスト写真を選ぶ
• 重複とほぼ重複する写真を見つける — 重複写真を自動で見つける
• 写真を自動で採点してランク付けする — 写真の品質を自動で採点

実行される場所

お使いのパソコン上です。imagicのMCPサーバーは、AIクライアントが起動するローカルのプロセスで、写真がディスクの外に出ることはなく、何もアップロードされません。これは、このリファレンスにあるすべてのツールに当てはまり、このツールも同じです。

呼び出すには、imagicに接続されたMCPクライアントが必要です。Claude Code、Cursor、VS Code、Codex、Gemini CLIなど十のクライアントで、セットアップは三分ほどです。