apple-contacts

TotalClaw 作者 totalclaw

从 macOS Contacts.app 查找联系人。将电话号码解析为姓名、查找联系信息或搜索地址簿时使用。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~tyler6204-apple-contacts

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~tyler6204-apple-contacts/file -o tyler6204-apple-contacts.md

## 概述（中文）

从 macOS Contacts.app 查找联系人。将电话号码解析为姓名、查找联系信息或搜索地址簿时使用。

## 原文

# Apple Contacts

Query Contacts.app via AppleScript.

## Quick Lookups

```bash
# 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'
```

## Full Contact Info

⚠️ Don't use `first person whose` — buggy. Use this pattern:

```bash
# 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'
```

## Phone Lookup

⚠️ **Exact string match required** — must match stored format exactly.

| Stored | Search | Works? |
|--------|--------|--------|
| `+1XXXXXXXXXX` | `+1XXXXXXXXXX` | ✅ |
| `+1XXXXXXXXXX` | `XXXXXXXXXX` | ❌ |

Try with `+1` prefix first. If fails, search by name instead.

## Name Search

- Case-insensitive
- Partial match with `contains`
- Exact match: use `is` instead of `contains`

## Output

Returns comma-separated: `name, phone1, [phone2...], email1, [email2...]`

No match = empty output (not an error).