Зачем TikTools для Python?
Python-клиент TikTokLive под лицензией MIT подключается напрямую к протоколу трансляций TikTok и передаёт подпись запросов управляемому бэкенду (по умолчанию это Euler Stream со своим бесплатным тарифом и платными планами). Это модель «клиент у вас + управляемая подпись», которую поддерживает команда Euler Stream.
TikTools - независимый управляемый API-сервис со своей инфраструктурой подписи. Изменения протокола обрабатываются на сервере, заявленная цель по аптайму - 99,9%, а работает всё с любым языком через стандартный WebSocket. Разбираться с протоколом не нужно - просто подключайтесь и получайте события. Выбирайте модель, которая подходит вашей команде.
Что понадобится
- Установленный Python 3.8+
- Бесплатный API-ключ TikTools - получите здесь
Вариант 1: asyncio + websockets
Самый простой путь - подключиться к WebSocket API TikTools через стандартную библиотеку websockets:
pip install websocketsimport asyncio
import websockets
import json
import os
API_KEY = os.environ.get("TIKTOOL_API_KEY", "YOUR_API_KEY")
STREAMER = "tv_asahi_news" # TikTok username (without @)
async def connect():
uri = f"wss://api.tik.tools?uniqueId={STREAMER}&apiKey={API_KEY}"
async with websockets.connect(uri) as ws:
print(f"✅ Connected to @{STREAMER}")
async for message in ws:
event = json.loads(message)
event_type = event.get("event", "")
data = event.get("data", {})
if event_type == "chat":
user = data.get("user", {}).get("uniqueId", "?")
comment = data.get("comment", "")
print(f"[CHAT] {user}: {comment}")
elif event_type == "gift":
user = data.get("user", {}).get("uniqueId", "?")
gift = data.get("giftName", "?")
diamonds = data.get("diamondCount", 0)
print(f"[GIFT] {user} sent {gift} ({diamonds} 💎)")
elif event_type == "member":
user = data.get("user", {}).get("uniqueId", "?")
print(f"[JOIN] {user} joined")
elif event_type == "roomUserSeq":
viewers = data.get("viewerCount", 0)
print(f"[VIEWERS] {viewers} watching")
asyncio.run(connect())Вариант 2: REST API через requests
Для разовых запросов данных (информация о комнате, профили пользователей) используйте REST API:
pip install requestsimport requests
API_KEY = "YOUR_API_KEY"
BASE = "https://api.tik.tools"
# Get room info for a streamer
resp = requests.get(f"{BASE}/webcast/room_info/", params={
"uniqueId": "tv_asahi_news",
"apiKey": API_KEY,
})
data = resp.json()
print(f"Title: {data.get('title', 'N/A')}")
print(f"Viewers: {data.get('viewer_count', 0)}")
print(f"Status: {'LIVE' if data.get('alive') else 'OFFLINE'}")Запуск скриптов
# Set your API key as environment variable
export TIKTOOL_API_KEY=your_api_key_here
# Run the WebSocket example
python tiktok_live.pyЧто вы увидите
✅ Connected to @tv_asahi_news
[VIEWERS] 1,234 watching
[CHAT] viewer42: Hello everyone!
[GIFT] big_fan sent Rose (1 💎)
[CHAT] news_watcher: Great coverage
[JOIN] new_viewer joined
[VIEWERS] 1,237 watchingЧто дальше
- Сохраняйте события в базу данных - отправляйте события в PostgreSQL, MongoDB или SQLite
- Сделайте дашборд - создайте веб-дашборд в реальном времени на Flask или FastAPI
- AI-анализ - передавайте сообщения чата в GPT/Claude для анализа тональности
- Несколько стримов - отслеживайте несколько стримов одновременно (тариф Pro: 50 подключений)