katok

name	katok
description	macOS 카카오톡 자동화 CLI. 친구 목록, 채팅방 목록, 메시지 읽기, 메시지 보내기를 지원합니다. 카카오톡 관련 작업이 필요할 때 사용하세요.
allowed-tools	Bash(katok *)

KakaoTalk Automation with katok

macOS 접근성 API를 사용하여 카카오톡을 자동화합니다. 카카오톡 앱이 설치되어 있어야 하며, 접근성 권한이 필요합니다.

Quick start

# 채팅방 목록 보기 (기본 명령)
katok chats
# 친구 목록 보기
katok friends
# 특정 채팅방 메시지 읽기
katok messages "홍길동"
# 메시지 보내기
katok send "홍길동" "안녕하세요"

Commands

chats (기본 명령)

채팅방 목록을 CSV 형식으로 출력합니다.

# 기본 (최근 50개)
katok chats
# 개수 제한
katok chats --limit 10
katok chats -l 10
# 건너뛰기 (페이지네이션)
katok chats --offset 20
katok chats -o 20
# 조합
katok chats -l 10 -o 20

출력 형식: name,time,member_count,unread_count

friends

친구 목록을 CSV 형식으로 출력합니다. 섹션별로 # 구분자가 포함됩니다.

katok friends

출력 형식: name,status_message

messages

특정 채팅방의 메시지를 CSV 형식으로 출력합니다. 시스템 메시지는 #으로 시작합니다.

# 기본 (최근 50개)
katok messages "채팅방 이름"
# 개수 제한
katok messages "채팅방 이름" --limit 20
katok messages "채팅방 이름" -l 20

출력 형식: sender,content,time

• 본인이 보낸 메시지의 sender는 나
• 이미지는 [이미지]로 표시
• 시스템 메시지는 # 메시지 내용 형식

send

특정 채팅방에 메시지를 보냅니다.

katok send "채팅방 이름" "보낼 메시지"

Example: 읽지 않은 채팅 확인

katok chats -l 10
# 출력에서 unread_count > 0인 채팅방 확인 후 메시지 읽기
katok messages "친구이름" -l 5

Example: 메시지 읽고 답장

katok messages "친구이름" -l 10
katok send "친구이름" "확인했습니다!"

Prerequisites

• katok CLI가 설치되어 있어야 합니다
  • 미설치 시: brew install sunghyun-k/tap/katok
• 카카오톡 macOS 앱이 설치되어 있어야 합니다
  • 미설치 시: 카카오톡 다운로드 페이지에서 설치하거나, mas install 869223134 (mas-cli 필요)
  • 미실행 시 katok이 자동으로 실행합니다
• 터미널(또는 실행 환경)에 macOS 접근성 권한이 필요합니다
  • 시스템 설정 → 개인정보 보호 및 보안 → 접근성에서 터미널 앱을 허용하세요
• 화면보호기 또는 화면 잠김 상태에서는 작동하지 않습니다
• 채팅방 이름은 정확히 일치해야 합니다