V4TIME/V4SKILL

Find My (Apple)

Rastreie dispositivos Apple e AirTags via o aplicativo Find My no macOS. Como a Apple não fornece uma CLI para o Find My, este skill usa AppleScript para abrir o aplicativo e capturas de tela para ler as localizações dos dispositivos.

Pré-requisitos

• macOS com o aplicativo Find My e iCloud conectado
• Dispositivos/AirTags já registrados no Find My
• Permissão de Gravação de Tela para o terminal (Ajustes do Sistema → Privacidade → Gravação de Tela)
• Opcional, mas recomendado: Instalar peekaboo para melhor automação de UI: brew install steipete/tap/peekaboo

Quando Usar

• O usuário pergunta "onde está meu [dispositivo/gato/chaves/mochila]?"
• Rastrear localizações de AirTags
• Verificar localizações de dispositivos (iPhone, iPad, Mac, AirPods)
• Monitorar movimentação de animais de estimação ou objetos ao longo do tempo (rotas de patrulha de AirTags)

Método 1: AppleScript + Captura de Tela (Básico)

Abrir Find My e Navegar

# Abrir o aplicativo Find My
osascript -e 'tell application "FindMy" to activate'

# Aguardar carregamento
sleep 3

# Capturar uma tela da janela do Find My
screencapture -w -o /tmp/findmy.png

Em seguida, use vision_analyze para ler a captura:

vision_analyze(image_url="/tmp/findmy.png", question="Quais dispositivos/itens são mostrados e quais são suas localizações?")

Alternar Entre Abas

# Alternar para a aba Dispositivos
osascript -e '
tell application "System Events"
    tell process "FindMy"
        click button "Devices" of toolbar 1 of window 1
    end tell
end tell'

# Alternar para a aba Itens (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: Automação de UI com Peekaboo (Recomendado)

Se peekaboo estiver instalado, use-o para interação de UI mais confiável:

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

# Capturar e anotar a UI
peekaboo see --app "FindMy" --annotate --path /tmp/findmy-ui.png

# Clicar em um dispositivo/item específico pelo ID do elemento
peekaboo click --on B3 --app "FindMy"

# Capturar a visualização de detalhes
peekaboo image --app "FindMy" --path /tmp/findmy-detail.png

Em seguida, analise com visão:

vision_analyze(image_url="/tmp/findmy-detail.png", question="Qual é a localização mostrada para este dispositivo/item? Inclua endereço e coordenadas, se visíveis.")

Fluxo de Trabalho: Rastrear Localização de AirTag ao Longo do Tempo

Para monitorar uma AirTag (por exemplo, rastrear a rota de patrulha de um gato):

# 1. Abrir Find My na aba Itens
osascript -e 'tell application "FindMy" to activate'
sleep 3

# 2. Clicar no item AirTag (permanecer na página — a AirTag só atualiza quando a página está aberta)

# 3. Capturar a localização periodicamente
while true; do
    screencapture -w -o /tmp/findmy-$(date +%H%M%S).png
    sleep 300  # A cada 5 minutos
done

Analise cada captura de tela com visão para extrair coordenadas e, em seguida, compile uma rota.

Limitações

• O Find My não possui CLI ou API — é necessário usar automação de UI
• AirTags só atualizam a localização enquanto a página do Find My está ativamente exibida
• A precisão da localização depende de dispositivos Apple próximos na rede Find My
• Permissão de Gravação de Tela é necessária para capturas de tela
• A automação de UI com AppleScript pode quebrar entre versões do macOS

Regras

1. Mantenha o aplicativo Find My em primeiro plano ao rastrear AirTags (as atualizações param quando minimizado)
2. Use vision_analyze para ler o conteúdo da captura — não tente interpretar pixels manualmente
3. Para rastreamento contínuo, use um cronjob para capturar e registrar localizações periodicamente
4. Respeite a privacidade — rastreie apenas dispositivos/itens que o usuário possui