Communitygithub.com

V4TIME/V4SKILL

Apple-Geräte und AirTags über die FindMy.app auf macOS verfolgen.

Was ist V4SKILL?

Dieser Skill ermöglicht es KI-Agenten, Apple-Geräte, AirTags und andere über „Mein Netzwerk suchen“ verbundene Gegenstände über die macOS-FindMy-App zu verfolgen. Da Apple keine offizielle CLI oder API bereitstellt, wird eine Kombination aus AppleScript zur UI-Automatisierung und Bildschirmaufnahmen zur visuellen Standortermittlung eingesetzt. Der Skill unterstützt grundlegende Screenshot-Methoden sowie die erweiterte UI-Automatisierung mit dem Tool `peekaboo` (optional empfohlen) für stabilere Interaktionen. Ein besonderes Workflow-Beispiel zeigt, wie man den Standort eines AirTags über einen längeren Zeitraum aufzeichnen kann – nützlich z. B. für die Routenverfolgung von Haustieren. Der Skill setzt macOS, die FindMy-App mit aktiviertem iCloud und entsprechende Berechtigungen für Bildschirmaufnahmen voraus. Die wichtigsten Einschränkungen sind das Fehlen einer echten Schnittstelle – daher sind UI-Automatisierung und sichtbares Fenster für Aktualisierungen notwendig – sowie mögliche Kompatibilitätsprobleme zwischen macOS-Versionen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/V4TIME/V4SKILL/tree/HEAD/apple/findmy

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Find My (Apple)

Apple-Geräte und AirTags über die FindMy.app auf macOS verfolgen. Da Apple keine CLI für FindMy bereitstellt, nutzt dieser Skill AppleScript, um die App zu öffnen, und Bildschirmaufnahmen, um Gerätestandorte zu erfassen.

Voraussetzungen

  • macOS mit der App „Mein Netzwerk suchen“ und bei iCloud angemeldet
  • Geräte/AirTags, die bereits in „Mein Netzwerk suchen“ registriert sind
  • Berechtigung für Bildschirmaufnahmen für das Terminal (Systemeinstellungen → Datenschutz & Sicherheit → Bildschirmaufnahme)
  • Optional, aber empfohlen: Installieren Sie peekaboo für bessere UI-Automatisierung: brew install steipete/tap/peekaboo

Verwendung

  • Benutzer fragt: „Wo ist mein [Gerät/Katze/Schlüssel/Tasche]?“
  • Verfolgen von AirTag-Standorten
  • Überprüfen von Gerätestandorten (iPhone, iPad, Mac, AirPods)
  • Überwachung der Bewegung von Haustieren oder Gegenständen über die Zeit (AirTag-Patrouillenrouten)

Methode 1: AppleScript + Screenshot (Basis)

FindMy öffnen und navigieren

# Find My App öffnen
osascript -e 'tell application "FindMy" to activate'

# Auf das Laden warten
sleep 3

# Bildschirmfoto des Find My Fensters erstellen
screencapture -w -o /tmp/findmy.png

Anschließend vision_analyze verwenden, um das Bildschirmfoto zu lesen:

vision_analyze(image_url="/tmp/findmy.png", question="Welche Geräte/Objekte werden angezeigt und wo befinden sie sich?")

Zwischen Tabs wechseln

# Zum Tab „Geräte“ wechseln
osascript -e '
tell application "System Events"
    tell process "FindMy"
        click button "Geräte" of toolbar 1 of window 1
    end tell
end tell'

# Zum Tab „Objekte“ wechseln (AirTags)
osascript -e '
tell application "System Events"
    tell process "FindMy"
        click button "Objekte" of toolbar 1 of window 1
    end tell
end tell'

Methode 2: Peekaboo UI-Automatisierung (Empfohlen)

Wenn peekaboo installiert ist, für zuverlässigere UI-Interaktionen verwenden:

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

# UI aufnehmen und annotieren
peekaboo see --app "FindMy" --annotate --path /tmp/findmy-ui.png

# Auf ein bestimmtes Gerät/Objekt per Element-ID klicken
peekaboo click --on B3 --app "FindMy"

# Detailansicht aufnehmen
peekaboo image --app "FindMy" --path /tmp/findmy-detail.png

Anschließend mit Vision analysieren:

vision_analyze(image_url="/tmp/findmy-detail.png", question="Welcher Standort wird für dieses Gerät/Objekt angezeigt? Adresse und Koordinaten, falls sichtbar.")

Workflow: AirTag-Standort über Zeit verfolgen

Zum Überwachen eines AirTags (z. B. für die Routenverfolgung einer Katze):

# 1. Find My zum Tab „Objekte“ öffnen
osascript -e 'tell application "FindMy" to activate'
sleep 3

# 2. Auf das AirTag-Objekt klicken (auf der Seite bleiben – AirTag aktualisiert nur, wenn die Seite geöffnet ist)

# 3. Standort regelmäßig erfassen
while true; do
    screencapture -w -o /tmp/findmy-$(date +%H%M%S).png
    sleep 300  # Alle 5 Minuten
done

Jedes Bildschirmfoto mit Vision analysieren, um Koordinaten zu extrahieren, und daraus eine Route zusammenstellen.

Einschränkungen

  • FindMy hat keine CLI oder API – UI-Automatisierung ist erforderlich
  • AirTags aktualisieren den Standort nur, während die FindMy-Seite aktiv angezeigt wird
  • Die Standortgenauigkeit hängt von nahen Apple-Geräten im FindMy-Netzwerk ab
  • Für Bildschirmaufnahmen ist die Berechtigung zur Bildschirmaufnahme erforderlich
  • Die UI-Automatisierung mit AppleScript kann zwischen macOS-Versionen fehlschlagen

Regeln

  1. FindMy-App im Vordergrund lassen, während AirTags verfolgt werden (Aktualisierungen stoppen beim Minimieren)
  2. vision_analyze verwenden, um Bildschirmfoto-Inhalte zu lesen – nicht versuchen, Pixel zu parsen
  3. Für fortlaufende Verfolgung einen Cronjob nutzen, um regelmäßig Standorte zu erfassen und zu protokollieren
  4. Privatsphäre respektieren – nur Geräte/Objekte verfolgen, die dem Benutzer gehören

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

Verwandte Skills