Communitygithub.com

a-funk/image2obsidian

에어드롭한 아이폰 사진을 옵시디언 저장소로 자동 가져옵니다 — OCR, 분류, Claude 비전 기반 라우팅. CLI + Claude Code 스킬.

image2obsidian란 무엇인가요?

이 스킬은 iOS 기기에서 에어드롭으로 전송된 사진을 자동으로 감지하여 옵시디언(Obsidian) 저장소에 통합하는 개발자 도구입니다. Claude의 비전 기능을 활용하여 사진 속 텍스트를 OCR로 추출하고, 이미지를 분류한 후 적절한 옵시디언 노트나 폴더로 라우팅합니다. CLI(명령줄 인터페이스)와 Claude Code 스킬 두 가지 방식으로 동작하므로, 사용자는 사진을 에어드롭한 후 자동화된 워크플로우를 통해 사진을 노트, 인용, 또는 연구 자료로 변환할 수 있습니다. 이 도구는 옵시디언 사용자라면 누구나 쉽게 사진 기반 지식 관리를 자동화할 수 있도록 설계되었으며, 특히 아이폰 사용자에게 최적화되어 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add a-funk/image2obsidian

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

image2obsidian은(는) 무엇을 하나요?

에어드롭한 아이폰 사진을 옵시디언 저장소로 자동 가져옵니다 — OCR, 분류, Claude 비전 기반 라우팅. CLI + Claude Code 스킬.

개요

이 스킬은 iOS 기기에서 에어드롭으로 전송된 사진을 감지하고, Claude의 비전 기능을 사용하여 이미지 내 텍스트를 추출(OCR)하고, 이미지를 분류한 후 적절한 옵시디언 노트나 폴더로 자동 라우팅합니다.

주요 기능

  • 에어드롭 감시: 특정 폴더(예: ~/Downloads/AirDrop)를 감시하여 새로 에어드롭된 사진을 감지합니다.
  • OCR 처리: Claude 비전 API를 사용하여 이미지에서 텍스트를 추출합니다.
  • 이미지 분류: 이미지 내용을 분석하여 적절한 카테고리(예: 회의 메모, 화이트보드, 문서, 영수증 등)로 분류합니다.
  • 자동 라우팅: 분류 결과에 따라 옵시디언 저장소의 적절한 폴더로 이미지와 추출된 텍스트를 저장합니다.
  • CLI 지원: 명령줄에서 직접 실행할 수 있습니다.
  • Claude Code 스킬: Claude Code 환경 내에서 스킬로 호출할 수 있습니다.

설치 방법

# npm을 통해 전역 설치 (예시)
npm install -g @a-funk/image2obsidian

또는 Claude Code 설정에 추가:

{
  "skills": [
    {
      "name": "image2obsidian",
      "source": "a-funk/image2obsidian"
    }
  ]
}

사용 방법

CLI로 사용하기

image2obsidian --watch ~/Downloads/AirDrop --vault ~/my-obsidian-vault

옵션:

  • --watch: 감시할 디렉토리 (기본값: ~/Downloads/AirDrop)
  • --vault: 옵시디언 저장소 경로
  • --dry-run: 실제 파일 이동 없이 시뮬레이션만 실행

Claude Code 스킬로 사용하기

claude add-skill a-funk/image2obsidian

그런 다음 Claude Code에서 다음과 같이 호출:

"에어드롭된 최근 사진을 옵시디언에 추가해줘" "방금 에어드롭한 화이트보드 사진을 처리해줘"

환경 변수

변수명설명필수
ANTHROPIC_API_KEYClaude API 키예
OBSIDIAN_VAULT_PATH옵시디언 저장소 경로아니요 (CLI 인수로 대체 가능)
WATCH_DIR감시할 디렉토리아니요

예시 워크플로우

  1. 아이폰에서 사진을 찍고 에어드롭으로 맥북으로 전송합니다.
  2. 스킬이 자동으로 새 파일을 감지합니다.
  3. Claude 비전이 이미지를 분석하고 텍스트를 추출합니다.
  4. 이미지 분류에 따라 옵시디언 저장소의 Inbox/Photos/ 폴더에 저장됩니다.
  5. 추출된 텍스트는 노트 파일과 함께 저장되며, 원본 이미지도 첨부됩니다.

지원 플랫폼

  • CLI: macOS, Linux (AirDrop 지원 시스템)
  • Claude Code: macOS (Claude Code 환경)

라이선스

MIT

관련 스킬