Find My (Apple)
Rastrea dispositivos Apple y AirTags mediante la aplicación FindMy.app en macOS. Como Apple no proporciona una CLI para FindMy, esta habilidad usa AppleScript para abrir la aplicación y capturas de pantalla para leer las ubicaciones de los dispositivos.
Requisitos previos
- macOS con la aplicación Find My e iCloud iniciado
- Dispositivos/AirTags ya registrados en Find My
- Permiso de grabación de pantalla para la terminal (Preferencias del Sistema → Privacidad y Seguridad → Grabación de Pantalla)
- Opcional pero recomendado: Instalar
peekaboopara una mejor automatización de IU:brew install steipete/tap/peekaboo
Cuándo usarla
- El usuario pregunta "¿dónde está mi [dispositivo/gato/llaves/bolso]?"
- Rastreo de ubicaciones de AirTags
- Verificación de ubicaciones de dispositivos (iPhone, iPad, Mac, AirPods)
- Monitoreo del movimiento de mascotas u objetos a lo largo del tiempo (rutas de patrulla de AirTag)
Método 1: AppleScript + Captura de pantalla (Básico)
Abrir FindMy y navegar
# Abrir la aplicación Find My
osascript -e 'tell application "FindMy" to activate'
# Esperar a que cargue
sleep 3
# Tomar una captura de pantalla de la ventana de Find My
screencapture -w -o /tmp/findmy.png
Luego usa vision_analyze para leer la captura:
vision_analyze(image_url="/tmp/findmy.png", question="¿Qué dispositivos/objetos se muestran y cuáles son sus ubicaciones?")
Cambiar entre pestañas
# Cambiar a la pestaña Dispositivos
osascript -e '
tell application "System Events"
tell process "FindMy"
click button "Devices" of toolbar 1 of window 1
end tell
end tell'
# Cambiar a la pestaña Objetos (AirTags)
osascript -e '
tell application "System Events"
tell process "FindMy"
click button "Items" of toolbar 1 of window 1
end tell
end tell'
Método 2: Automatización de IU con Peekaboo (Recomendado)
Si peekaboo está instalado, úsalo para una interacción más fiable con la interfaz:
# Abrir Find My
osascript -e 'tell application "FindMy" to activate'
sleep 3
# Capturar y anotar la IU
peekaboo see --app "FindMy" --annotate --path /tmp/findmy-ui.png
# Hacer clic en un dispositivo/objeto específico por ID de elemento
peekaboo click --on B3 --app "FindMy"
# Capturar la vista de detalle
peekaboo image --app "FindMy" --path /tmp/findmy-detail.png
Luego analiza con visión:
vision_analyze(image_url="/tmp/findmy-detail.png", question="¿Cuál es la ubicación mostrada para este dispositivo/objeto? Incluye dirección y coordenadas si son visibles.")
Flujo de trabajo: Rastrear ubicación de AirTag a lo largo del tiempo
Para monitorear un AirTag (por ejemplo, rastrear la ruta de patrulla de un gato):
# 1. Abrir FindMy en la pestaña Objetos
osascript -e 'tell application "FindMy" to activate'
sleep 3
# 2. Hacer clic en el AirTag (permanecer en la página — el AirTag solo se actualiza mientras la página está abierta)
# 3. Capturar la ubicación periódicamente
while true; do
screencapture -w -o /tmp/findmy-$(date +%H%M%S).png
sleep 300 # Cada 5 minutos
done
Analiza cada captura con visión para extraer coordenadas y luego compila una ruta.
Limitaciones
- FindMy no tiene CLI ni API — debe usar automatización de IU
- Los AirTags solo actualizan su ubicación mientras la página de FindMy está activa
- La precisión de la ubicación depende de la cercanía de dispositivos Apple en la red FindMy
- Se requiere permiso de grabación de pantalla para las capturas
- La automatización con AppleScript puede fallar en distintas versiones de macOS
Reglas
- Mantén la aplicación FindMy en primer plano al rastrear AirTags (las actualizaciones se detienen si se minimiza)
- Usa
vision_analyzepara leer el contenido de la captura — no intentes analizar píxeles manualmente - Para rastreo continuo, usa un cronjob para capturar y registrar ubicaciones periódicamente
- Respeta la privacidad — solo rastrea dispositivos/objetos que el usuario posea