SportAPI
Интеграция API

Discord-бот для киберспорта: расписание матчей, счёт и коэффициенты на сервере

Как сделать Discord-бота, который показывает расписание матчей CS2 и Dota 2, live-счёт и коэффициенты: данные из SportAPI, код на Python и автопубликация в канал.

Discord-бот публикует расписание матчей CS2 и Dota 2 со счётом и коэффициентами

Discord-бот с киберспортивными матчами — это небольшой скрипт, который берёт данные из API и публикует их на сервере: расписание на день, live-счёт по картам и коэффициенты. Данные для такого бота даёт API киберспорта SportAPI: Counter-Strike 2, Dota 2 и другие дисциплины, prematch и live, рынки и коэффициенты в JSON. Тариф на одну дисциплину — от $25 в месяц, а проверить всё можно на тестовом ключе за 2 дня.

Ниже — что умеет такой бот, как получить матчи CS2 и Dota 2 через API, готовый код на Python с командой /matches и автопубликацией, и как не превратить канал в спам.

Что умеет киберспортивный бот

ФункцияКак работаетДанные SportAPI
Команда /matchesУчастник сервера получает ближайшие матчи по запросуPrematch-матчи дисциплины
Расписание дняБот публикует список матчей в канал по расписаниюPrematch-матчи дисциплины
Live-счётБот сообщает, когда меняется счёт по картамLive-матчи: общий счёт и счёт текущей карты
КоэффициентыВ сообщении рядом с матчем — основной рынокРынки и коэффициенты матча
ИтогиВечером — кто выиграл матчи дняLive-матчи и результаты

Админу не нужно ничего обновлять вручную: бот работает 24/7, а сервер получает живой канал, ради которого участники заходят чаще.

Как получить матчи CS2 и Dota 2 через API

Киберспорт в SportAPI запрашивается теми же методами, что и спорт, с параметром cybersport=true:

GET https://YOUR_API_DOMAIN/v1/menu/line/ru?cybersport=true
GET https://YOUR_API_DOMAIN/v1/events/{sportId}/0/sub/50/line/ru?cybersport=true
GET https://YOUR_API_DOMAIN/v1/events/{sportId}/0/sub/50/live/ru?cybersport=true
Package: YOUR_API_KEY
  1. menu возвращает дисциплины, турниры и их идентификаторы. По справочнику видов спорта у Counter-Strike sport_id 86, у Dota — 97, но берите ID из актуального ответа menu.
  2. events с типом line — предстоящие матчи дисциплины с основными рынками.
  3. events с типом live — матчи, которые идут сейчас: общий счёт score_full, счёт текущей карты score_period и её название period_name.

Для киберспорта метод events всегда возвращает весь список матчей дисциплины, без отбора «Топ». Полное описание методов и полей — в документации метода events.

Бот на Python: команда /matches и автопубликация

Понадобятся Python 3.10+, библиотека discord.py и бот, созданный в Discord Developer Portal и приглашённый на сервер с правом отправлять сообщения. Ключ SportAPI и токен бота храните в переменных окружения, а не в коде.

import os
from datetime import datetime

import aiohttp
import discord
from discord import app_commands
from discord.ext import tasks

API = "https://YOUR_API_DOMAIN/v1"
HEADERS = {"Package": os.environ["SPORTAPI_KEY"]}
CS2_SPORT_ID = 86            # проверьте по ответу menu с cybersport=true
CHANNEL_ID = 123456789012345678  # канал для расписания

client = discord.Client(intents=discord.Intents.default())
tree = app_commands.CommandTree(client)


async def fetch_matches(kind="line"):
    url = f"{API}/events/{CS2_SPORT_ID}/0/sub/50/{kind}/ru?cybersport=true"
    async with aiohttp.ClientSession(headers=HEADERS) as session:
        async with session.get(url, timeout=aiohttp.ClientTimeout(total=10)) as response:
            response.raise_for_status()
            data = await response.json()
    return [(t["tournament_name"], m) for t in data["body"] for m in t["events_list"]]


def format_match(tournament, match):
    start = datetime.fromtimestamp(match["game_start"]).strftime("%d.%m %H:%M")
    line = f'**{match["opp_1_name"]}** vs **{match["opp_2_name"]}** · {start}\n{tournament}'
    groups = match.get("game_oc_list", [])
    if groups:
        odds = " · ".join(f'{o["oc_name"]} {o["oc_rate"]}' for o in groups[0]["oc_list"])
        line += f"\n{groups[0]['group_name']}: {odds}"
    return line


def build_embed(matches, title):
    embed = discord.Embed(title=title, color=0xC2FF1F)
    embed.description = "\n\n".join(format_match(t, m) for t, m in matches[:8]) or "Матчей нет"
    return embed


@tree.command(name="matches", description="Ближайшие матчи CS2 с коэффициентами")
async def matches_command(interaction: discord.Interaction):
    matches = await fetch_matches("line")
    await interaction.response.send_message(embed=build_embed(matches, "Ближайшие матчи CS2"))


@tasks.loop(hours=6)
async def post_schedule():
    channel = client.get_channel(CHANNEL_ID)
    matches = await fetch_matches("line")
    await channel.send(embed=build_embed(matches, "Расписание CS2"))


@client.event
async def on_ready():
    await tree.sync()
    if not post_schedule.is_running():
        post_schedule.start()


client.run(os.environ["DISCORD_TOKEN"])

Что делает код:

  • fetch_matches запрашивает матчи дисциплины: line — предстоящие, live — текущие.
  • format_match собирает строку матча: команды, время, турнир и первую группу рынков из краткого набора коэффициентов.
  • /matches — команда, которую участник вызывает сам.
  • post_schedule раз в 6 часов публикует расписание в выбранный канал.

Чтобы добавить Dota 2, достаточно второго sport_id и отдельной команды или параметра команды.

Live-счёт по картам

Live-уведомления строятся на сравнении двух запросов:

  1. Раз в 30–60 секунд бот запрашивает events с типом live.
  2. Сравнивает score_full и score_period каждого матча с прошлым запросом.
  3. Если счёт изменился — публикует сообщение: «NAVI 1 : 0 Vitality, 2-я карта 8 : 5».

Документация рекомендует запрашивать список live-матчей не чаще раза в 7 секунд, так что у бота большой запас. Публикуйте изменения только по матчам, которые интересны вашему серверу, — например, по топ-турнирам или командам из ролей участников.

Как развить бота дальше

Когда расписание и live-счёт работают, бот можно превратить в центр активности сервера:

  • Прогнозы участников. Перед матчем бот публикует сообщение с реакциями на каждую команду, участники голосуют, а после матча бот подводит итог.
  • Таблица лидеров. Бот считает, кто чаще угадывает победителя, и раз в неделю публикует рейтинг — хороший повод заходить на сервер регулярно.
  • Итоги турнира. По завершении турнира бот собирает результаты всех матчей в одно сообщение.
  • Несколько дисциплин. Отдельные каналы для CS2, Dota 2 и League of Legends, у каждого — своя роль-подписка.
  • Свой сайт. Если сервер растёт, тот же поток данных можно вывести на сайт сообщества с полным расписанием и live-разделом.

Все эти функции используют те же методы API — меняется только логика бота.

Как не превратить канал в спам

  • Отдельный канал для бота. Расписание и live-счёт — в #матчи, чтобы не мешать общению.
  • Не больше 8 матчей в сообщении. Длинные списки никто не читает; дайте команду /matches для остального.
  • Только важные изменения. Счёт по картам и итог матча, а не каждый раунд.
  • Роли-подписки. Упоминайте роль, например @cs2-live, только в сообщениях о начале и конце матча.
  • Коэффициенты — по правилам сервера и платформы. Если вашей аудитории это не нужно, отключите строку с рынком — бот останется полезным как расписание и live-счёт.

Сколько стоит и как проверить

Что нужноСтоимость
Данные одной дисциплины: матчи, prematch и live, рынки, коэффициенты, краткая live-статистикаот $25 в месяц
Хостинг ботаЛюбой недорогой сервер или контейнер
Проверка до оплатыТестовый ключ SportAPI на 2 дня, все дисциплины

Если кроме киберспорта нужны футбол или баскетбол, тот же бот работает с API спортивной линии и коэффициентов: меняется только sport_id и параметр cybersport.

Частые вопросы

Какие дисциплины поддерживает бот?

Любые, которые есть в киберспортивной линии SportAPI: Counter-Strike 2, Dota 2, League of Legends и другие. Актуальный список с идентификаторами возвращает menu с параметром cybersport=true.

Можно ли обойтись без программирования?

Простой вариант — n8n или похожий конструктор: расписание, запрос к SportAPI и отправка сообщения через вебхук Discord. Но команды вроде /matches и live-уведомления удобнее делать в коде из этой статьи.

Как часто обновлять live-счёт?

Для бота достаточно раза в 30–60 секунд. Документация SportAPI разрешает запрашивать список live-матчей не чаще раза в 7 секунд.

Нужно ли показывать коэффициенты?

Нет. Коэффициенты помогают оценить фаворита матча, но бот полезен и без них — как расписание и live-счёт. Учитывайте правила своего сервера и Discord.

Можно ли проверить данные до оплаты?

Да. Тестовый ключ на 2 дня включает все дисциплины, prematch и live — этого хватит, чтобы запустить бота из статьи на своём сервере.

Что сделать сегодня

  1. Создайте бота в Discord Developer Portal и пригласите его на сервер.
  2. Получите тестовый ключ SportAPI.
  3. Проверьте ID дисциплины через menu с cybersport=true.
  4. Запустите код из статьи и вызовите /matches.
  5. Добавьте live-уведомления по картам для турниров, которые смотрит ваш сервер.

Напишите менеджеру SportAPI в Telegram, какие дисциплины нужны вашему серверу, — вы получите тестовый ключ к API киберспорта и запустите бота в тот же день.

← Все статьи