TikTok LIVE 채팅 봇 만들기
어떤 TikTok LIVE 방송이든 채팅, 선물, 입장 이벤트를 전부 읽고 내 앱에서 명령어에 반응하세요. Node.js나 Python으로 60줄 이하 코드면 돼요.
SDK 설치
패키지 하나면 끝. 빌드 단계도 없어요. Node 18+ 또는 Python 3.9+ 환경이라면 어디서든 작동해요.
npm install @tiktool/live인증 정보 설정
필요한 건 딱 하나예요:
- API 키 - 내 대시보드에서 받으세요. 방송 하나라면 무료 요금제로 충분해요.
export TIKTOOL_API_KEY="tk_yourkey"
export TIKTOK_USERNAME="target_streamer"봇 작성
채팅, 선물, 입장, 좋아요를 수신해요. !hello, !ping 명령어가 오면 오버레이, 효과음, 웹훅 같은 원하는 동작으로 반응해요.
// bot.mjs
import { TikTokLive } from '@tiktool/live'
const USERNAME = process.env.TIKTOK_USERNAME
const API_KEY = process.env.TIKTOOL_API_KEY
// Your reaction to a command: trigger an overlay, play a sound, call a webhook.
function onCommand(name, user) {
console.log(`command ${name} from @${user}`)
}
const client = new TikTokLive({ uniqueId: USERNAME, apiKey: API_KEY })
client.on('connected', e => console.log(`connected to room ${e.roomId}`))
client.on('chat', e => {
console.log(`@${e.user.uniqueId}: ${e.comment}`)
if (e.comment.toLowerCase() === '!hello') onCommand('hello', e.user.uniqueId)
if (e.comment.toLowerCase() === '!ping') onCommand('ping', e.user.uniqueId)
})
client.on('gift', e => console.log(`gift: ${e.user.uniqueId} → ${e.giftName} (${e.diamondCount}💎)`))
client.connect()실행하기
봇은 직접 멈출 때까지 연결을 유지해요. 재연결 로직은 SDK에 기본으로 들어 있어요.
node bot.mjs아무 TikTok 계정으로 스트리머 채팅창에 !hello 또는 !ping 메시지를 보내고 봇이 반응하는 걸 확인해 보세요.
미리 알아 둘 제한 사항
아래 내용은 TikTok이 내 계정/IP에 적용하는 제한이라 tik.tools가 풀어 줄 수 없어요. 봇 로직을 짤 때 꼭 고려하세요.
방송당 분당 이벤트
대형 크리에이터(시청자 백만 명 이상) 방송에서는 분당 수만 건의 이벤트가 쏟아져요. 봇은 이벤트를 느긋하게 처리해야 해요. 채팅마다 이벤트 루프를 막지 말고, 무거운 작업은 버리거나 큐에 넣으세요.
LIVE가 끝나면 세션도 종료
스트리머가 LIVE를 끝내면 WebSocket이 닫히고 SDK에서 disconnected 이벤트가 발생해요. 스트리머가 다시 라이브를 시작하면 재연결하세요. tik.tools/api/live/check-live 엔드포인트를 폴링하거나 웹훅을 쓰면 돼요.
TikTok 공식 승인 아님
이건 비공식 연동이에요. 크리에이터를 사칭하지 말고, 봇이 실행하는 모든 동작이 TikTok 커뮤니티 가이드라인을 지키도록 하세요.