iCloud设备定位查询

技能简介

通过PyiCloud命令行工具访问iCloud Find My服务，查询绑定Apple ID的设备实时位置、电池电量及充电状态。支持查看个人设备及家庭共享成员设备。

能做什么

• 列出所有关联设备的当前位置和电池信息
• 获取指定设备的经纬度坐标与时间戳
• 检查设备是否正在充电及剩余电量百分比
• 支持家庭共享场景下的多设备管理

使用说明

安装依赖

brew install pipx
pipx install pyicloud

首次认证

执行以下命令并输入Apple ID密码完成双因素认证，会话有效期1-2个月：

icloud --username 用户邮箱@example.com --with-family --list

日常使用

查询全部设备：

icloud --username APPLE_ID --with-family --list

筛选特定设备：

icloud --username APPLE_ID --with-family --list | grep -A 10 "设备名称"

提取坐标数据：

icloud --username ID --with-family --list | grep -A 10 "设备名" | grep "Location" | sed "s/.*- //" | python3 -c "import sys; loc=eval(sys.stdin.read()); print(f\"{loc['latitude']},{loc['longitude']}\")"

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管Apple ID凭证，避免泄露账户信息
• 会话过期后需重新完成双因素认证流程
• 设备离线或关闭定位服务时无法获取位置
• 仅支持macOS系统运行
• 家庭共享功能需提前在iCloud设置中开启

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/liamnichols/icloud-findmy/SKILL.md
来源类型：GitHub仓库