kakaome 0.1.0

Send KakaoTalk messages to your own chat from the command line

kakaome

카카오톡 나에게 보내기 REST API를 사용하는 작은 Python CLI입니다.

비공식 프로젝트이며 Kakao Corp.와 제휴하거나 Kakao가 보증하는 제품이 아닙니다.

설치

pipx install kakaome

개발 버전은 프로젝트 디렉터리에서 다음과 같이 실행할 수 있습니다.

uv sync
uv run kakaome --help

Kakao Developers 설정

1. 앱에서 카카오 로그인을 활성화합니다.
2. Redirect URI로 http://127.0.0.1:8765/callback을 등록합니다.
3. 동의 항목에서 **카카오톡 메시지 전송 (talk_message)**을 활성화합니다.
4. 메시지 링크에 사용할 도메인을 제품 링크 > 웹 도메인에 등록합니다.

REST API 키와 기본 링크를 저장하고 최초 한 번 로그인합니다.

kakaome configure --rest-api-key YOUR_KEY --default-link https://example.com
kakaome auth

Client Secret 기능을 활성화한 앱은 --client-secret도 지정합니다.

사용

kakaome send "배치 작업이 완료되었습니다."
kakaome send "결과 보기" --link https://example.com/report
kakaome send "오늘의 결과" --image-url https://example.com/result.png

카카오 기본 텍스트 템플릿은 링크를 필수로 요구하고 최대 200자까지 지원합니다. --image-url은 인터넷에서 공개 접근 가능한 이미지여야 합니다. PDF나 ZIP 같은 로컬 파일을 카카오톡 첨부파일로 직접 업로드하는 기능은 공식 나에게 보내기 REST API에서 지원하지 않습니다.

설정과 OAuth 토큰은 Windows의 %APPDATA%\kakaome\config.json 또는 다른 운영체제의 ~/.config/kakaome/config.json에 저장됩니다. 경로는 KAKAOME_CONFIG 환경 변수로 바꿀 수 있습니다.

배포 빌드

uv build
uv run twine check dist/*