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/chzzkpy.git -b develop
$ cd chzzkpy
$ python3 -m pip install -U .

빠른 예제

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

방송인 검색

import asyncio
import chzzkpy.unofficial


async def main():
   client = chzzkpy.unofficial.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 import Client, Donation, Message, UserPermission

client_id = "Prepared Client ID"
client_secret = "Prepared Client Secret"
client = Client(client_id, client_secret)

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


@client.event
async def on_donation(donation: Donation):
   await donation.send("%s님, %d원 후원 감사합니다." % (donation.profile.nickname, donation.pay_amount))


async def main():
   user_client = await client.login()
   await user_client.connect(UserPermission.all())

asyncio.run(main())

채팅 봇 (비공식 API 기반)

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")

팔로워 조회

from chzzkpy import Client, Donation, Message, UserPermission

client_id = "Prepared Client ID"
client_secret = "Prepared Client Secret"
client = Client(client_id, client_secret)


async def main():
   user_client = await client.login()
   result = await user_client.get_followers()
   if len(result) == 0:
      print("팔로워가 없습니다. :(")
      await client.close()
      return

   for user in result.data:
      print(f"{user.user_name}: {user.created_date}부터 팔로우 중.")


asyncio.run(main())