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. 제품 링크 > 웹 도메인에 기본값인 https://pypi.org를 등록합니다.

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

kakaome configure --rest-api-key YOUR_KEY
kakaome auth

Client Secret 기능을 활성화한 앱은 --client-secret도 지정합니다. 기본 메시지 링크는 https://pypi.org/project/kakaome/입니다. 다른 주소를 쓰려면 해당 도메인을 제품 링크에 등록하고 --default-link로 지정합니다.

사용

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/*