mcpField
A
apple-photos

apple-photos

github.com/sundial-orgクリエイティブ・メディア67059 回インストール34 週間前に更新
リポジトリ

apple-photos について

apple-photosは、SQLiteクエリでApple Photosライブラリを参照するスクリプト集です。アルバムや人物、写真を確認したい人向けで、条件検索や写真の書き出しにも対応します。

主な機能

  1. 01ライブラリ統計とアルバムの表示
  2. 02最近の写真と人物の一覧
  3. 03人物、内容、日付での検索
  4. 04写真情報の取得
  5. 05HEIC変換を伴う写真の書き出し

活用シーン

  1. 01ライブラリ内の写真数の確認
  2. 02人物や日付による写真検索
  3. 03写真の内容による検索
  4. 04閲覧用の写真の書き出し

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill apple-photos

インストール後、Claude Code で/apple-photosを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

scripts/
photos-count.sh
photos-export.sh
photos-info.sh
photos-list-albums.sh
photos-list-people.sh
photos-recent.sh
photos-search-content.sh
photos-search-date.sh
photos-search-person.sh

詳細

Apple Photos

SQLite クエリを使って Photos.app にアクセスします。スクリプトは cd {baseDir} から実行します。

要件

  • ターミナルにフルディスクアクセスを許可します（システム設定 → プライバシーとセキュリティ → フルディスクアクセス）

コマンド

コマンド使い方
ライブラリの統計情報scripts/photos-count.sh
アルバム一覧scripts/photos-list-albums.sh
最近の写真scripts/photos-recent.sh [count]
人物一覧scripts/photos-list-people.sh
人物で検索scripts/photos-search-person.sh <name> [limit]
写真の内容で検索scripts/photos-search-content.sh <query> [limit]
日付で検索scripts/photos-search-date.sh <start> [end] [limit]
写真情報scripts/photos-info.sh <uuid>
写真をエクスポートscripts/photos-export.sh <uuid> [output_path]

出力

  • 最近の写真／検索結果：Filename | Date | Type | UUID
  • 人物：ID | Name | Photo Count
  • エクスポート先のデフォルト：/tmp/photo_export.jpg

ワークフロー：写真を表示する

  1. UUID を取得します：scripts/photos-recent.sh 1
  2. エクスポートします：scripts/photos-export.sh "UUID"
  3. /tmp/photo_export.jpg を表示します

注記

  • 日付形式：YYYY-MM-DD または YYYY-MM-DD HH:MM
  • 写真の内容による検索では ML を使用するため、日付／人物による検索（約 100ms）より時間がかかります（約 5～10 秒）
  • エクスポート時に HEIC は自動的に JPEG に変換されます
  • 名前検索では大文字と小文字を区別せず、一部一致で検索します

コメント

Markdown 対応