chzzkpy (gunyu1019)

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

파이썬 선택의 의미

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

무엇을 만들 수 있나

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

스트리밍 봇이라는 시장

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

비공식 라이브러리의 리스크

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

라이브러리 하나로 늘어나는 봇

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

같은 결의 한국 스트리밍 도구

• chzzk4j (Java API)
• 비공식 치지직 안드로이드 TV 앱
• 치지직 플러스 (브라우저 확장)
• Chzzk-Rekoda (자동 녹화)

안내

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

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

이런 분께 맞아요

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