FindMyPipe – 從 Linux 查詢 Apple Find My 的 AI 智能體工具

FindMyPipe 是一個開源的本地 CLI 橋接工具，專為 Linux 系統設計，讓用户能夠通過 iCloud 查詢 Apple Find My 網絡，實時獲取 iPhone、iPad、Mac 和 AirPods 等 Apple 設備的位置信息。它輸出結構化 JSON 數據，非常適合 AI 智能體、Shell 腳本和自動化工作流使用。

除了基本的設備定位功能，FindMyPipe 還能支持位置感知工作流：例如，AI 智能體可以利用設備的座標查詢附近的興趣點（如餐廳、酒店、醫院、公交站），從而構建更豐富的上下文感知應用。

該工具的主要特性包括：

• 實時定位 Apple 設備，支持 iPhone、iPad、Mac、AirPods
• 將座標輸入到任何 POI API（如 Google Places、OSM、Foursquare）以查找附近的興趣點
• 專業的 CLI 界面，輸出乾淨的 JSON 格式，易於管道處理和解析
• 隱私優先：日誌中隱藏憑證，設備 ID 用 SHA-256 哈希替代
• 無需配置即可使用 mock 模式，無需 Apple ID 即可體驗
• 可選緩存功能，可配置 TTL 以避免頻繁請求 iCloud API
• 智能過濾器：支持 --skip-offline 和 --max-age 參數，僅保留新鮮數據
• 完整的 Apple 2FA 登錄流程，支持交互式驗證
• 符合 AgentSkills.io 標準，可作為技能無縫集成到任何智能體框架中

FindMyPipe 還提供了豐富的 CLI 命令，包括 doctor（檢查狀態）、list（列出所有設備）、locate（按名稱或 ID 搜索設備）和 login（交互式 iCloud 認證）。所有命令均支持 --json 選項以輸出結構化數據。

在隱私與安全方面，FindMyPipe 採取了多項措施：不運行 HTTP 服務器，所有 I/O 通過標準輸入輸出；不設置 webhook，僅向 Apple 服務器發起出站輪詢；憑證從不記錄；設備 ID 使用哈希替換；原始敏感數據默認隱藏；文件權限嚴格限制（目錄 0700，文件 0600）。

安裝要求 Python 3.11+ 和 Linux（或 macOS），以及啓用了 Find My 功能的 Apple ID（僅實時模式需要）。安裝過程簡單，支持 pip 安裝，並可選實時 iCloud 支持。

FindMyPipe 的架構清晰：上層是 AI 智能體或 Shell 腳本，通過 CLI 與 findmy-agent 交互，其內部包含 CLI 層（基於 Typer）、緩存層、核心邏輯層和提供商層（支持 Mock 和 iCloud），最終通過 HTTPS 與 Apple iCloud API 通信。

目前，FindMyPipe 支持 iPhone、iPad、Mac 和 AirPods，但尚未支持 AirTag 或物品。未來計劃內置 POI 集成。該項目採用 MIT 許可證，由社區貢獻構建。