eスポーツツール

VCT・PACIFICなどのプロVALORANT試合データを取得・分析します。

get_esports_matches

プロeスポーツ試合の一覧を取得します。

パラメーター

名前	型	デフォルト	説明
`team_name`	string	`""`	チーム名で絞り込み
`event_name`	string	`""`	イベント名で絞り込み
`status`	string	`""`	試合状態（下記参照）
`limit`	int	`20`	取得件数
`offset`	int	`0`	オフセット

status の値：

値	説明
`completed`	試合終了
`upcoming`	開催予定
`live`	進行中
`""`	全状態

レスポンス

json

{
  "total": 128,
  "limit": 20,
  "offset": 0,
  "results": [
    {
      "uuid": "xxxxxxxx-...",
      "event_name": "VCT 2026 Pacific Stage 1",
      "series_name": "Week 5",
      "status": "completed",
      "team_a": { "name": "ZETA DIVISION", "tag": "ZETA", "score": 2 },
      "team_b": { "name": "T1",            "tag": "T1",   "score": 0 },
      "scheduled_at": "2026-04-20T10:00:00Z"
    }
  ]
}

使用例

# ZETA DIVISIONの試合を取得
get_esports_matches(team_name="ZETA", status="completed")

# VCT Pacific Week5の試合
get_esports_matches(event_name="VCT 2026 Pacific Stage 1", limit=10)

get_esports_match_detail

プロ試合の詳細（マップ別スコア・エージェント構成・選手スタッツ）を取得します。

パラメーター

名前	型	説明
`uuid`	string	`get_esports_matches` または `search_esports_matches` で取得したUUID

レスポンス

json

{
  "uuid": "...",
  "event_name": "VCT 2026 Pacific Stage 1",
  "team_a": { "name": "ZETA DIVISION", "tag": "ZETA" },
  "team_b": { "name": "T1", "tag": "T1" },
  "maps": [
    {
      "map_name": "アセント",
      "team_a_score": 13,
      "team_b_score": 7,
      "winner": "ZETA DIVISION",
      "agents_a": ["ジェット", "オーメン", "クローヴ", "ソーヴァ", "KAY/O"],
      "agents_b": ["ジェット", "アストラ", "サイファー", "ソーヴァ", "レイズ"],
      "players": [
        {
          "name": "Laz",
          "team": "ZETA DIVISION",
          "agent": "ジェット",
          "acs": 312,
          "kills": 28,
          "deaths": 14,
          "assists": 4
        }
      ]
    }
  ]
}

使用例

get_esports_match_detail(uuid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")

search_esports_matches

eスポーツ試合を柔軟な条件で検索します。get_esports_matches より多くの絞り込み条件が使えます。

パラメーター

名前	型	デフォルト	説明
`query_text`	string	`""`	チーム名・イベント名を横断検索
`team_a`	string	`""`	チームAの名前またはタグ
`team_b`	string	`""`	チームBの名前またはタグ
`event_name`	string	`""`	イベント名
`series_name`	string	`""`	シリーズ名（Week1など）
`status`	string	`""`	試合状態
`year`	int	`0`	開催年（0で全年）
`include_detail_summary`	bool	`false`	マップ詳細のサマリーを含める
`limit`	int	`50`	取得件数
`offset`	int	`0`	オフセット

使用例

# ZETA vs T1 の直接対戦を全件取得
search_esports_matches(team_a="ZETA", team_b="T1")

# 2026年のVCT Pacific試合
search_esports_matches(event_name="VCT 2026 Pacific", year=2026, status="completed")

# キーワードで横断検索
search_esports_matches(query_text="ZETA DIVISION", include_detail_summary=true)

analyze_esports_team_matchup

2チームの直接対戦履歴と直近試合を集計し、勝敗・マップ傾向・エージェント構成を比較します。

パラメーター

名前	型	デフォルト	説明
`team_a`	string	必須	チームAの名前またはタグ
`team_b`	string	必須	チームBの名前またはタグ
`status`	string	`"試合終了"`	対象とする試合状態
`year`	int	`0`	対象年（0で全年）
`limit_per_team`	int	`20`	各チームの直近試合取得数

レスポンス

json

{
  "team_a": "ZETA DIVISION",
  "team_b": "T1",
  "direct_matches_found": 5,
  "direct_record": {
    "team_a_wins": 3,
    "team_b_wins": 2
  },
  "team_a_recent": {
    "matches": 20,
    "wins": 14,
    "map_win_rates": { "アセント": 75.0, "バインド": 60.0 },
    "top_agents": ["ジェット", "クローヴ", "ソーヴァ"]
  },
  "team_b_recent": { ... },
  "direct_matches": [ ... ]
}

使用例

# ZETA vs T1 のマッチアップ分析
analyze_esports_team_matchup(team_a="ZETA", team_b="T1", year=2026)

備考

チーム同士の直接対戦データが少ない場合でも、各チームの直近試合傾向から強みと弱みを把握できます。

get_team_info

チーム名またはタグでeスポーツチームの基本情報を取得します。

パラメーター

名前	型	説明
`name`	string	チーム名またはタグ（部分一致）

レスポンス

json

[
  {
    "id": 1,
    "name": "ZETA DIVISION",
    "tag": "ZETA",
    "region": "Pacific",
    "logo_url": null
  }
]

使用例

get_team_info(name="ZETA")
get_team_info(name="T1")

get_pro_round_stats

プロ試合のラウンド別データ（スパイク植え付け座標・サイト・勝敗）を取得します。

パラメーター

名前	型	デフォルト	説明
`map_url`	string	`""`	マップID（`/Game/Maps/Ascent/Ascent` 形式）
`year`	int	`0`	開催年
`plant_site`	string	`""`	植え付けサイト（`A` / `B` / `C`）
`attacker_tag`	string	`""`	攻撃側チームタグ
`limit`	int	`50`	取得件数

レスポンス

json

[
  {
    "map_url": "/Game/Maps/Ascent/Ascent",
    "plant_site": "B",
    "plant_x": 2578,
    "plant_y": -8757,
    "round_result": "Bomb detonated",
    "winning_team_role": "Attacker",
    "attacker_tag": "ZETA"
  }
]

使用例

# アセントのBサイト植え付けラウンドを取得
get_pro_round_stats(map_url="/Game/Maps/Ascent/Ascent", plant_site="B")

# ZETAが攻撃側のラウンドのみ
get_pro_round_stats(attacker_tag="ZETA", year=2026)

get_esports_agent_meta

プロ試合のエージェント別ピック数・勝率を取得します。

パラメーター

名前	型	デフォルト	説明
`limit`	int	`30`	取得するエージェント数

レスポンス

json

[
  {
    "agent_name": "ジェット",
    "pick_count": 142,
    "win_count": 78,
    "win_rate": 54.9
  }
]

get_esports_map_picks

プロ試合のマップピック・バン統計を取得します。

パラメーター

名前	型	デフォルト	説明
`limit`	int	`20`	取得するマップ数

レスポンス

json

[
  {
    "map_name": "アセント",
    "pick_count": 48,
    "ban_count": 22,
    "total_appearances": 70
  }
]

eスポーツツール ​

get_esports_matches ​

パラメーター ​

レスポンス ​

使用例 ​

get_esports_match_detail ​

パラメーター ​

レスポンス ​

使用例 ​

search_esports_matches ​

パラメーター ​

使用例 ​

analyze_esports_team_matchup ​

パラメーター ​

レスポンス ​

使用例 ​

get_team_info ​

パラメーター ​

レスポンス ​

使用例 ​

get_pro_round_stats ​

パラメーター ​

レスポンス ​

使用例 ​

get_esports_agent_meta ​

パラメーター ​

レスポンス ​

get_esports_map_picks ​

パラメーター ​

レスポンス ​

eスポーツツール

get_esports_matches

パラメーター

レスポンス

使用例

get_esports_match_detail

パラメーター

レスポンス

使用例

search_esports_matches

パラメーター

使用例

analyze_esports_team_matchup

パラメーター

レスポンス

使用例

get_team_info

パラメーター

レスポンス

使用例

get_pro_round_stats

パラメーター

レスポンス

使用例

get_esports_agent_meta

パラメーター

レスポンス

get_esports_map_picks

パラメーター

レスポンス