TikTok LIVE Agency SDK

ماذا تقدم للوكالات

تغلّف tiktok-live-agency واجهة tik.tools API في عميل محدد الأنواع مصمم لوكالات TikTok LIVE (Creator Networks و TCN و MCN). اسم الحزمة نفسه موجود على npm و PyPI، والعميلان يتشاركان قائمة الدوال نفسها.

• اعثر على صناع محتوى للاستقطاب. صناع محتوى مرتبون حسب المنطقة مرشحون للانضمام لوكالة، والوافدون الجدد إلى مجموعة الاستقطاب، وصناع المحتوى الخارجون من الدوريات.
• حالة بث القائمة والماسات. اعرف أي صناع المحتوى لديك يبثون الآن، واقرأ الماسات لكل صانع محتوى ولكل قائمة من الهدايا المرصودة أثناء بثهم.
• Webhooks. تنبيهات موقّعة لبدء البث وانتهائه تصل إلى خادمك، مع أداة تحقق لـ Node و Edge و Workers و Python.
• لوحات تحكم مخصصة. JSON بسيط بأسماء الحقول نفسها في API، فتنتقل البيانات مباشرة إلى صفحة Next.js أو دفتر ملاحظات أو تصدير جدول بيانات.

التثبيت

JavaScript و TypeScript

npm install tiktok-live-agency

Python

pip install tiktok-live-agency

# optional, for the real-time big gifts stream
pip install "tiktok-live-agency[realtime]"

ضع مفتاحك في متغير البيئة TIKTOOLS_API_KEY على الخادم. لا ترسله أبدًا إلى المتصفح: عميل TypeScript يرفض العمل داخل صفحة متصفح. المفاتيح موجودة في صفحة الأسعار.

أمثلة

أي صناع المحتوى لدي يبثون الآن (TypeScript)

import { AgencyClient } from 'tiktok-live-agency'

const tt = new AgencyClient() // reads TIKTOOLS_API_KEY

const { live, offline, unknown } = await tt.whoIsLive(['creator_one', 'creator_two', 'creator_three'])
console.log(live.map((r) => r.unique_id))

التحقق من webhook بدء البث في Route Handler على Next.js (TypeScript)

// app/api/webhooks/tiktools/route.ts
import { verifyWebhook } from 'tiktok-live-agency/webhooks'

export async function POST(req: Request) {
  const raw = await req.text() // raw body, verify before parsing
  try {
    const event = await verifyWebhook(raw, req.headers, process.env.TIKTOOLS_WEBHOOK_SECRET!)
    console.log(event.event, event.creator.unique_id)
  } catch {
    return new Response('bad signature', { status: 400 })
  }
  return new Response('ok')
}

صناع محتوى للاستقطاب وماسات القائمة (Python)

from tiktok_live_agency import AgencyClient, is_free_to_join

tt = AgencyClient()  # reads TIKTOOLS_API_KEY

rows = list(tt.iter_creators_to_recruit("UK", max_pages=5))
free = [r for r in rows if is_free_to_join(r)]

roster = tt.list_rosters()["lists"][0]
week = tt.roster_diamonds(roster["id"], days=7)
print(len(free), week["totalDiamonds"])

أي استدعاء لا تشمله باقتك يرمي PlanRequiredError مع الباقة المطلوبة ورابط الترقية، فتعرض لوحة التحكم بطاقة ترقية بدلًا من أن تتعطل. بيانات webhooks وتوقيعاتها موثقة في مرجع API.

مجموعات الدوال

تستخدم Python الأسماء نفسها بصيغة snake_case، مثل who_is_live و find_creators_to_recruit. كل دالة مع باقتها مذكورة في ملف README لكل حزمة.

لمساعدي الذكاء الاصطناعي

ملخص قابل للقراءة آليًا لكل الدوال موجود في tik.tools/sdk/agency/llms.txt. وجّه إليه Cursor أو Claude أو ChatGPT أو أي أداة بناء بالذكاء الاصطناعي، واذكر اسم الحزمة tiktok-live-agency، ليستخدم الكود المولَّد بيانات حقيقية من API.

الكود المصدري والحزم

• TypeScript: github.com/tiktool/tiktok-live-agency و npm
• Python: github.com/tiktool/tiktok-live-agency-python و PyPI
• الترخيص: MIT

غير رسمية، وغير تابعة لـ TikTok أو ByteDance. tiktok-live-agency حزمة SDK مستقلة لواجهة tik.tools API. TikTok علامة تجارية لمالكها، وتُذكر هنا فقط لوصف التوافق.