Introduction

파이썬 기반의 치지직(네이버 라이브 스트리밍 서비스)의 비공식 라이브러리 입니다.

An unofficial python library for Chzzk(Naver Live Streaming Service).

기능

• 치지직 방송 채팅

• 영상, 실시간 방송, 채널 검색

• 치지직 실시간 방송 정보

• 치지직 채널 관리

설치

Python 3.10 이상의 버전이 요구됩니다.

# Linux/MacOS
python3 -m pip install chzzkpy

# Windows
py -3 -m pip install chzzkpy

개발 버전 설치 방법:

$ git clone https://github.com/gunyu1019/chzzk_py
$ chzzk_py
$ python3 -m pip install -U .

빠른 예제

이 섹션은 간단한 예제를 보여줍니다. chzzkpy를 사용한 사례를 보시려면, 이곳 을 확인해주세요..

방송인 검색

import asyncio
import chzzkpy


async def main():
   client = chzzkpy.Client()
   result = await client.search_channel("건유1019")
   if len(result) == 0:
      print("검색 결과가 없습니다 :(")
      await client.close()
      return

   print(result[0].name)
   print(result[0].id)
   print(result[0].image)
   await client.close()

asyncio.run(main())

채팅 봇

from chzzkpy.chat import ChatClient, ChatMessage, DonationMessage

client = ChatClient("channel_id")


@client.event
async def on_chat(message: ChatMessage):
   if message.content == "!안녕":
      await client.send_chat("%s님, 안녕하세요!" % message.profile.nickname)


@client.event
async def on_donation(message: DonationMessage):
   await client.send_chat("%s님, %d원 후원 감사합니다." % (message.profile.nickname, message.extras.pay_amount))


client.run("NID_AUT", "NID_SES")

팔로워 조회

import asyncio
import chzzkpy


async def main():
   client = chzzkpy.Client()

   # 채널 관리 기능을 이용하기 위해서는 네이버 사용자 인증이 필요합니다.
   # 웹브라우저의 쿠키 값에 있는 NID_AUT와 NID_SES 값으로 로그인을 대체할 수 있습니다.
   client.login("NID_AUT", "NID_SES")
   manage_client = client.manage("channel_id")

   followers = await manage_client.followers()
   if len(result) == 0:
      print("팔로워가 없습니다. :(")
      await client.close()
      return

   for user in result.data:
      print(f"{user.user.nickname}: {user.following.follow_date}부터 팔로우 중.")
   await client.close()

asyncio.run(main())