pacesync-live-connector

A high-performance TikTok LIVE event connector for PaceSync — receive real-time chat, gifts, and viewer events with automatic session refresh.

Features

• Real-time events: chat, gifts, likes, follows, shares, viewers, subscriptions
• Auto session refresh: Chrome CDP経由でsessionidを自動取得・更新
• Auto reconnect: 切断時に自動再接続
• TypeScript: 完全な型定義付き
• Zero credentials required: sessionidのみで動作（公式APIキー不要）

Status

✅ 動作確認済み (2026-06-30) — roomId取得・Webcastエンドポイント接続を確認

Installation

npm install pacesync-live-connector

Quick Start

import { TikTokLiveConnector } from 'pacesync-live-connector';

const connector = new TikTokLiveConnector('your_tiktok_username', {
  sessionId: process.env.TIKTOK_SESSION_ID!,
  targetIdc: process.env.TIKTOK_TARGET_IDC,
});

connector.on('chat', (event) => {
  console.log(`${event.user.nickname}: ${event.comment}`);
});

connector.on('gift', (event) => {
  console.log(`${event.user.nickname} sent ${event.giftName} x${event.repeatCount}`);
});

connector.on('viewer', (event) => {
  console.log(`Viewers: ${event.viewerCount}`);
});

connector.on('error', (err) => {
  console.error('Error:', err);
});

connector.on('disconnect', (reason) => {
  console.log('Disconnected:', reason);
});

// ライブ配信に接続
const roomInfo = await connector.connect();
console.log(`Connected to: ${roomInfo.title}`);

Session Refresh

sessionidが失効した場合、Chrome CDP経由で自動更新できます:

// Chromeを --remote-debugging-port=9222 で起動してTikTokにログインした状態で実行
await connector.refreshSession();

または手動で更新:

import { refreshSessionFromChrome } from 'pacesync-live-connector';

const { sessionId, targetIdc } = await refreshSessionFromChrome(9222);

Events

| Event | Payload | Description | |---|---|---| | chat | ChatEvent | チャットメッセージ | | gift | GiftEvent | ギフト | | like | LikeEvent | いいね | | follow | FollowEvent | フォロー | | share | ShareEvent | シェア | | viewer | ViewerEvent | 視聴者数更新 | | subscribe | SubscribeEvent | サブスクリプション | | connect | roomId: string | 接続完了 | | disconnect | reason: string | 切断 | | error | Error | エラー |

vs TikTok-Live-Connector

| | TikTok-Live-Connector | pacesync-live-connector | |---|---|---| | セッション管理 | 手動 | Chrome CDP自動取得 | | TypeScript | ❌ | ✅ | | 自動再接続 | △ | ✅ | | PaceSync統合 | ❌ | ✅ |

License

MIT