export_photos

内容

デフォルトでは、すべてのkeep写真をエクスポートします（以前にエクスポートしたものも、再描画して含みます）。特定のセットをエクスポートするにはphoto_idsを、別のグループにはstatusを渡します。dest_dirは必要なら作成され、その中でファイルは、元の撮影フォルダー名のサブフォルダーにまとめられ、結果には書き込まれたファイルのパスが正確に一覧されます。描画はCPUに依存し、RAWファイルあたり数秒かかることがあります。結果には、エクスポートされた件数と失敗した件数が、写真ごとのエラーとともに報告されます。ユーザーがAdobe Lightroomで作業を続けたい場合は、lightroom=Trueを設定します。各独自形式のRAW（ARW、CR3、NEFなど）にはCamera Rawの.xmpサイドカーも作られ、RAWとそのサイドカーがエクスポートの隣にコピーされるため、そのフォルダーをLightroomに取り込むと、同じスライダー値でRAWが開きます。サイドカーはlightroom_sidecarsに一覧されます。DNG、TIFF、JPEGのファイルにはサイドカーは作られません。実験的なエフェクト、マスクレイヤー、LUT、ヒールとクローン、レンズ/パースの補正、上級者向けのRAWエンジン設定にはLightroomに相当するものがないため、imagic独自の描画にとどまり、lightroom_not_carriedに写真ごとに挙がります。これが空でないときはユーザーに伝え、Lightroomの結果が一致するとは期待させず、一覧にあるものだけを挙げてください。それ以外はすべて引き継がれます。ホワイトバランス、露出とトーンのスライダー、テクスチャ、明瞭度、かすみ除去、自然な彩度と彩度、HSL、カラーグレードとスプリットトーニング、トーンカーブ、シャープ、ノイズ除去、ビネット、グレイン、クロップと傾き補正です。ユーザーがLightroomで仕上げる予定なら、これらを優先してください。リモート接続ではdest_dirに制限があります。名前だけ、または相対的な名前（例："delivery"）は、常にユーザーが設定したエクスポートフォルダーの下に解決され、絶対パスは、そのフォルダーの中か、imagicの設定のmcp.remote_allowed_foldersに挙がっているフォルダーの中にある必要があります。それ以外はエラーで返され、エクスポート先とほかのフォルダーを許可する方法が説明されます。呼び出しの制限時間を過ぎるとバックグラウンドのジョブとしても実行され、scan_directoryと同様に、返されたjob_idでget_job_statusを呼び出して確認します。ローカルのクライアントには制限がなく、常に結果がそのまま返ります。

パラメーター

頼み方

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

このフォルダーのすべての採用写真に、暖かいフィルム調のルックを適用して、品質92でJPEGをエクスポートしてください。

編集のほかのツール

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

• AIエージェントでRAWファイルを一括編集する — AIでRAWファイルを一括編集
• クライアント向けギャラリーの写真を選んでエクスポートする — AIでクライアントギャラリーのベスト写真を選ぶ

実行される場所

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

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