card-scan

name	card-scan
description	명함 사진에서 이름·회사·직함·연락처를 추출해 구글시트에 저장하고, 리멤버용 vCard를 만들며 로컬 연락처에 등록한다. 사용자가 명함 이미지를 올리거나 "명함 등록/스캔"을 요청할 때 사용.

명함 스캔 → 저장

사용자가 명함 사진을 올리거나 명함 등록을 요청하면 아래 순서로 처리한다.

처음 사용이면: 사진에서 정보 추출·로컬 저장은 설정 없이도 된다. 다만 구글시트 저장이나 발송을 하려면 설정이 필요하니, 등록을 마친 뒤 자연스럽게 "설정을 도와드릴까요?"라고 물어 setup 스킬로 안내한다. 사용자가 JSON을 직접 만지게 하지 말 것.

1. 이미지에서 정보 추출

명함 이미지를 읽고 다음 필드를 JSON으로 정리한다. 없는 값은 빈 문자열.

{
  "name": "", "company": "", "title": "",
  "phone": "", "email": "", "address": "", "website": "",
  "met_at": "", "memo": ""
}

• phone은 휴대폰 우선(여러 개면 010 번호). 하이픈 포함 그대로 둔다.
• 여러 장을 한 번에 올리면 각각 처리한다.

2. 만난 정보 확인

met_at(예: "2026-07-26 스타트업 밋업")이 이미지에 없으면 사용자에게 한 줄로 물어본다. 날짜는 오늘 날짜를 기본값으로 제안한다. 추가 메모가 있으면 memo에 넣는다.

3. 추출 결과 확인

표로 정리해 사용자에게 보여주고, 잘못 읽은 값이 있으면 고치도록 한다.

4. 저장 실행

확인되면 연락처 JSON을 저장 스크립트에 넘긴다(구글시트 + 로컬 동시 저장):

echo '<연락처 JSON>' | python3 "$CLAUDE_PLUGIN_ROOT/scripts/sheet_append.py"

• 설정(config.json)이 아직 없으면 스크립트가 안내를 출력한다. 그럴 땐 config.example.json을 복사해 채우도록 사용자에게 알려준다.
• 시트 없이 로컬에만 먼저 쌓고 싶으면 --dry-run을 붙여 미리보기만 한다.

5. 리멤버용 내보내기(선택)

사용자가 리멤버/연락처 반입을 원하면:

python3 "$CLAUDE_PLUGIN_ROOT/scripts/export_vcard.py"

생성된 data/remember_import.vcf(또는 .csv)를 리멤버 앱 가져오기나 휴대폰 연락처로 반입하도록 안내한다.

6. 다음 단계 제안

저장이 끝나면 "바로 인사/자료를 보낼까요?"라고 물어 outreach 스킬로 이어질 수 있게 한다.