apple-contacts

Apple Contacts

AppleScript を介して Contacts.app にクエリを実行します。

簡易検索

# By phone (name only)
osascript -e 'tell application "Contacts" to get name of every person whose value of phones contains "+1XXXXXXXXXX"'

# By name
osascript -e 'tell application "Contacts" to get name of every person whose name contains "John"'

# List all
osascript -e 'tell application "Contacts" to get name of every person'

連絡先の詳細情報

⚠️ first person whose は使用しないでください。動作に不具合があります。次のパターンを使用してください。

# By phone
osascript -e 'tell application "Contacts"
  set matches to every person whose value of phones contains "+1XXXXXXXXXX"
  if length of matches > 0 then
    set p to item 1 of matches
    return {name of p, value of phones of p, value of emails of p}
  end if
end tell'

# By name
osascript -e 'tell application "Contacts"
  set matches to every person whose name contains "John"
  if length of matches > 0 then
    set p to item 1 of matches
    return {name of p, value of phones of p, value of emails of p}
  end if
end tell'

電話番号検索

⚠️ 完全一致が必要です — 保存されている形式と完全に一致させる必要があります。

保存形式	検索	成功するか
+1XXXXXXXXXX	+1XXXXXXXXXX	✅
+1XXXXXXXXXX	XXXXXXXXXX	❌

まず +1 の接頭辞を付けて検索してください。見つからない場合は、名前で検索してください。

名前検索

• 大文字と小文字は区別されません
• contains による部分一致
• 完全一致の場合は、contains の代わりに is を使用します

出力

カンマ区切りで返されます：name, phone1, [phone2...], email1, [email2...]

一致するものがない場合は、空の出力が返されます（エラーではありません）。