Hermes Agent Wiki 非公式・日本語wiki
この skill をそのまま使う: GitHub で原文を見る

英語原文・frontmatter 込みで、Hermes が読み込む実体そのままです(このページの本文は日本語版)。

Findmy

目次

macOS の FindMy.app で、Apple 製端末や AirTag の位置を調べます。

skill の情報

提供元 最初から入っています
パス skills/apple/findmy
バージョン 1.0.0
作者 Hermes Agent
ライセンス MIT
対応プラットフォーム macos
タグ FindMy, AirTag, location, tracking, macOS, Apple

参考: SKILL.md 全文

Find My (Apple)

macOS の FindMy.app を使って、Apple 製端末や AirTag の位置を調べます。Apple は FindMy 用の CLI を用意していないため、この skill では AppleScript でアプリを開き、 画面を撮って端末の位置を読み取ります。

事前に必要なもの

  • macOS、「探す」アプリ、そして iCloud にサインイン済みであること
  • 端末や AirTag が「探す」にあらかじめ登録されていること
  • ターミナルに画面収録の権限があること(システム設定 → プライバシー → 画面収録)
  • 必須ではありませんが、あると便利: UI 操作をより確実にする peekaboo を入れておきます。

brew install steipete/tap/peekaboo

こんなときに使います

  • 「わたしの端末 / 猫 / 鍵 / かばんはどこ?」と聞かれたとき
  • AirTag の位置を調べたいとき
  • 端末(iPhone、iPad、Mac、AirPods)の位置を確認したいとき
  • ペットや持ち物の動きを時間を追って見たいとき(AirTag の移動経路)

方法 1: AppleScript + スクリーンショット(基本)

FindMy を開いて画面を切り替える

# Open Find My app
osascript -e 'tell application "FindMy" to activate'

# Wait for it to load
sleep 3

# Take a screenshot of the Find My window
screencapture -w -o /tmp/findmy.png

続けて vision_analyze でスクリーンショットを読み取ります。

vision_analyze(image_url="/tmp/findmy.png", question="What devices/items are shown and what are their locations?")

タブを切り替える

# Switch to Devices tab
osascript -e '
tell application "System Events"
    tell process "FindMy"
        click button "Devices" of toolbar 1 of window 1
    end tell
end tell'

# Switch to Items tab (AirTags)
osascript -e '
tell application "System Events"
    tell process "FindMy"
        click button "Items" of toolbar 1 of window 1
    end tell
end tell'

peekaboo を入れてある場合は、こちらのほうが UI 操作が安定します。

# Open Find My
osascript -e 'tell application "FindMy" to activate'
sleep 3

# Capture and annotate the UI
peekaboo see --app "FindMy" --annotate --path /tmp/findmy-ui.png

# Click on a specific device/item by element ID
peekaboo click --on B3 --app "FindMy"

# Capture the detail view
peekaboo image --app "FindMy" --path /tmp/findmy-detail.png

続けて vision で読み取ります。

vision_analyze(image_url="/tmp/findmy-detail.png", question="What is the location shown for this device/item? Include address and coordinates if visible.")

手順: AirTag の位置を時間を追って記録する

AirTag を見張るとき(たとえば猫の移動経路を追うとき)は次のようにします。

# 1. Open FindMy to Items tab
osascript -e 'tell application "FindMy" to activate'
sleep 3

# 2. Click on the AirTag item (stay on page — AirTag only updates when page is open)

# 3. Periodically capture location
while true; do
    screencapture -w -o /tmp/findmy-$(date +%H%M%S).png
    sleep 300  # Every 5 minutes
done

撮った画像を 1 枚ずつ vision で読み取って座標を取り出し、経路としてまとめます。

制限

  • FindMy には CLI も API もありません。UI を操作するしかありません
  • AirTag の位置は、FindMy の画面を開いているあいだしか更新されません
  • 位置の精度は、FindMy のネットワークに参加している近くの Apple 製端末に左右されます
  • スクリーンショットを撮るには画面収録の権限が必要です
  • AppleScript による UI 操作は、macOS のバージョンが変わると動かなくなることがあります

ルール

  1. AirTag を追っているあいだは FindMy アプリを前面に出しておきます(最小化すると更新が止まります)
  2. スクリーンショットの中身は vision_analyze で読み取ります。ピクセルを自力で解析しようとしないでください
  3. 継続して追いたいときは、cronjob で定期的に撮影して位置を記録します
  4. プライバシーに配慮し、本人が持ち主である端末や持ち物だけを対象にします