Communitygithub.com

V4TIME/V4SKILL

Rastrea dispositivos Apple y AirTags mediante FindMy.app en macOS.

¿Qué es V4SKILL?

Esta habilidad permite localizar dispositivos Apple (iPhone, iPad, Mac, AirPods) y AirTags utilizando la aplicación Find My en macOS. Como Apple no proporciona una interfaz de línea de comandos (CLI) ni una API pública para Find My, la habilidad emplea AppleScript para automatizar la interacción con la aplicación y capturas de pantalla (screencapture) para leer las ubicaciones de los dispositivos. Es especialmente útil cuando un usuario pregunta '¿dónde está mi [dispositivo/gato/llaves/bolso]?' o para monitorear el movimiento de objetos a lo largo del tiempo (por ejemplo, rutas de patrulla de un gato con AirTag). La habilidad soporta macOS y recomienda la instalación opcional de la herramienta `peekaboo` para una automatización de interfaz de usuario más confiable. Para que funcione correctamente, se requiere permiso de grabación de pantalla para la terminal y que el usuario haya iniciado sesión en iCloud con sus dispositivos ya registrados en Find My. La habilidad detalla dos métodos: uno básico con AppleScript y captura de pantalla, y otro avanzado con `peekaboo`. También incluye un flujo de trabajo para rastrear la ubicación de un AirTag a lo largo del tiempo, capturando imágenes periódicamente y extrayendo coordenadas mediante análisis de visión (`vision_analyze`). Las limitaciones principales son la falta de CLI/API, la necesidad de mantener la ventana de Find My activa para que los AirTags actualicen su ubicación, y la posible incompatibilidad de AppleScript entre versiones de macOS.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 peekaboo para 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

  1. Mantén la aplicación FindMy en primer plano al rastrear AirTags (las actualizaciones se detienen si se minimiza)
  2. Usa vision_analyze para leer el contenido de la captura — no intentes analizar píxeles manualmente
  3. Para rastreo continuo, usa un cronjob para capturar y registrar ubicaciones periódicamente
  4. Respeta la privacidad — solo rastrea dispositivos/objetos que el usuario posea

Individual skills in this repo

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

Skills relacionados