Tutorial · Kostenlos · 5 Minuten

Bau einen TikTok-LIVE-Chatbot

Lies jedes Chat-, Geschenk- und Beitritts-Event aus jedem TikTok-LIVE-Stream und reagiere in deiner eigenen App auf Befehle. Läuft in Node.js oder Python mit weniger als 60 Zeilen Code.

1

SDK installieren

Ein Paket. Kein Build-Schritt. Läuft in jeder Umgebung mit Node 18+ oder Python 3.9+.

npm install @tiktool/live
2

Zugangsdaten setzen

Du brauchst nur eins:

export TIKTOOL_API_KEY="tk_yourkey"
export TIKTOK_USERNAME="target_streamer"
3

Bot schreiben

Hört auf Chat, Geschenke, Beitritte und Likes. Reagiert auf die Befehle !hello und !ping mit deiner eigenen Aktion: ein Overlay, ein Sound, ein Webhook.

// 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()
4

Ausführen

Der Bot bleibt verbunden, bis du ihn stoppst. Die Reconnect-Logik steckt schon im SDK.

node bot.mjs

Schreib !hello oder !ping von einem beliebigen TikTok-Account in den Chat des Streamers und sieh zu, wie dein Bot reagiert.

Einschränkungen, die du einplanen solltest

Alles unten setzt TikTok für deinen Account bzw. deine IP durch - tik.tools kann das nicht aufheben. Bau deine Bot-Logik mit diesen Grenzen im Hinterkopf.

~100k

Events pro Stream und Minute

Große Creator (1M+ Zuschauer) erzeugen Zehntausende Events pro Minute. Dein Bot muss sie entspannt verarbeiten - blockier nicht bei jeder Chatnachricht den Event-Loop. Schwere Arbeit verwerfen oder in eine Queue schieben.

Stream-Ende

die Session endet mit dem LIVE

Wenn der Streamer sein LIVE beendet, wird der WebSocket geschlossen. Das SDK feuert disconnected. Verbinde dich neu, sobald der Streamer wieder live geht - frag tik.tools/api/live/check-live ab oder nutze Webhooks.

keine Verbindung

nicht von TikTok unterstützt

Das ist eine inoffizielle Integration. Gib dich nicht als andere Creator aus und halte alles, was dein Bot auslöst, im Rahmen der TikTok-Community-Richtlinien.