# chzzkpy (gunyu1019)

> 네이버 치지직의 비공식 파이썬 라이브러리. 채팅 봇·알림 도구를 만드는 가장 쉬운 경로

- 페이지: https://dreamboat.kr/discover/chzzkpy-python
- 공식 사이트: https://github.com/gunyu1019/chzzkpy
- 분야: 개발도구, 콘텐츠
- 쓰는 환경: 라이브러리
- 상태: 운영 중
- 등재: 2026-08-10 · 마지막 갱신: 2026-10-23


## 소개

chzzkpy는 네이버 라이브 스트리밍 서비스 치지직의 **비공식** 파이썬 라이브러리입니다. 2024년 2월 시작해 2026년 8월 기준 스타 45개·포크 3개를 기록 중입니다.

파이썬 선택의 의미:
스트리밍 봇을 만드는 사람 중 상당수는 전업 개발자가 아닙니다. 스트리머 본인이거나 시청자 커뮤니티의 열정적인 사용자입니다. 파이썬은 그런 층이 접근하기 가장 쉬운 언어이고, 그래서 봇 생태계에서 널리 쓰입니다. Java 라이브러리(chzzk4j)와 함께 언어별 선택지를 채웁니다.

무엇을 만들 수 있나:
- 채팅 봇: 명령어 응답, 룰렛, 음악 신청, 자동 관리
- 방송 알림: 방송 시작 시 디스코드·텔레그램 알림
- 시청자 참여 도구: 투표, 미션, 포인트 시스템
- 데이터 수집: 채팅 로그, 시청자 통계

스트리밍 봇이라는 시장:
치지직 이전에는 트위치·아프리카TV 생태계에서 같은 도구들이 만들어졌습니다. 플랫폼이 바뀌면 도구도 새로 만들어야 하고, 그때마다 초기 진입자가 자리를 잡습니다. 국내 스트리밍 지형이 재편되는 시기에 이런 라이브러리가 나온 이유입니다.

비공식 라이브러리의 리스크:
플랫폼 내부 API 변경 시 즉시 깨지고, 약관상 허용 범위도 불명확합니다. 취미·소규모 도구에는 충분하지만 상업 서비스의 핵심으로 삼기엔 위험합니다.

라이브러리 하나로 늘어나는 봇:
플랫폼이 공식 SDK를 안 주면 커뮤니티가 만듭니다. 그리고 그 라이브러리 하나가 수십 개의 봇·도구를 가능하게 합니다. 기반을 만드는 기여의 전형입니다.

같은 결의 한국 스트리밍 도구:
- chzzk4j (Java API)
- 비공식 치지직 안드로이드 TV 앱
- 치지직 플러스 (브라우저 확장)
- Chzzk-Rekoda (자동 녹화)

안내:
비공식 라이브러리라 **플랫폼이 프로토콜을 바꾸면 동작이 멈춥니다.** 확장 프로그램이 화면 변경에 깨진다면, 이쪽은 내부 API·웹소켓 규격 변경에 깨집니다.

그리고 공식 지원이 아니므로 **약관상 허용 범위**를 스스로 판단해야 합니다. 자동화 봇은 특히 제재 대상이 될 수 있어, 개인 용도와 서비스 운영은 위험이 다릅니다.

타겟 사용자:
- 치지직 채팅 봇을 만들려는 스트리머·시청자
- 파이썬으로 첫 봇을 만들어보려는 입문자
- 스트리밍 데이터를 수집·분석하려는 개발자
- 플랫폼 API 래핑을 배우려는 개발자

## 인용

이 소개는 Dreamboat(드림보트)이 공식 사이트를 직접 확인해 작성했습니다.
출처(https://dreamboat.kr/discover/chzzkpy-python)를 명시하면 인용 가능합니다. 서비스 자체의 권리는 각 제작자에게 있습니다.
전체 목록: https://dreamboat.kr/llms.txt · 전문: https://dreamboat.kr/llms-full.txt