analyze_photos

内容

シャープネス、露出、構図を採点し、重複を検出して、写真をkeep、trash、culled（未決定）に振り分けます。任意のしきい値は0.0から1.0で、keep_threshold以上のスコアの写真はkeepに、trash_threshold以下はtrashになります。両方とも未設定のままにすると、ユーザーの設定済みのデフォルトが使われます。大きなライブラリでは時間がかかることがあります。重いAIモデルは、インストールされていなければ自動的に飛ばされます。解析の統計と、ステータスごとのライブラリの件数を返します。採点されるのは保留中の写真だけです。すでに解析済みの写真は、その後にスコアラーが改良されていても、保存済みのスコアのままです。そうした写真にはreanalyze_stale_photosを使います。smart_rank（デフォルトはfalse、試験的）は、高速なセレクトのあとに二回目の処理を加えます。画像理解モデルが、解析済みの写真のうち残す価値のあるものと、スナップ（看板、駐車中の車、床など）を判定し、それをもとにライブラリ全体を並べ直します。以前に解析した写真も並べ直すので、保留中の写真がなくても単独で使えます。速度よりも良い上位の写真を優先したいとユーザーが望む場合にだけ有効にしてください。このパソコンで写真検索を一度も使ったことがなければ、約600MBの一度きりのダウンロードが必要で、1000枚あたり約二分が加わります。解析を再実行することはなく、手動のkeepやtrashの判断を変えることもなく、失敗したり使えなかったりした場合は、高速なセレクトの結果がそのまま残ります。応答には、見積もり、状態、件数を含むsmart_rankのブロックが付きます。リモートでは、呼び出しの制限時間を過ぎるとバックグラウンドのジョブとして実行され、scan_directoryと同様に、返されたjob_idでget_job_statusを呼び出して確認します。

パラメーター

頼み方

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

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

セレクトのほかのツール

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

• AIで結婚式の撮影分をセレクトする — AIによる結婚式の写真セレクト
• 重複とほぼ重複する写真を見つける — 重複写真を自動で見つける
• 写真を自動で採点してランク付けする — 写真の品質を自動で採点

実行される場所

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

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