icloud-findmy
بواسطة liamnichols
Apple Apps & Servicesموجز
Query Find My locations and battery status for family devices.
الوصف
ما الذي تفعله هذه المهارة
Queries Apple iCloud Find My to retrieve device locations and battery status for personal and family devices. Uses pyicloud CLI under the hood. Requires one-time 2FA authentication, after which sessions persist for 1-2 months.
Gives programmatic access to Find My data without manual app interaction, enabling automated battery checks and location queries from any agent workflow.
متى تستخدمها
- Check iPhone battery before leaving home
- Find where a family member's device is located
- Confirm if a device is charging or not
- Detect whether user is home or away based on coordinates
- Get current coordinates to answer location-aware questions
مثال على سير العمل
User asks: Where is my wife's iPhone and what's the battery level?
- 1
Run
icloud --username APPLE_ID --with-family --listto fetch all device data - 2
Parse output sections separated by dashes to find the matching device
- 3
Extract Battery Level value and multiply by 100 for percentage
- 4
Extract Location dict and parse latitude/longitude coordinates
- 5
Format and return location and battery status to user
Wife's iPhone is at 52.248, 0.761 with 72% battery, not charging.
المتطلبات
- Apple ID (iCloud account)
- iCloud Family Sharing enabled to access family devices
التثبيت
clawhub install liamnichols/icloud-findmyشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.