プレイヤー分析ツール

10万件超の試合データを使ってプレイヤーのパフォーマンスを多角的に分析します。

全ツールに共通する profile_uuid は search_player で取得してください。試合履歴が非公開のプレイヤーは、本人のAPIキーを使った場合のみデータを取得できます。

get_player_hourly_stats

時間帯別（JST 0〜23時）の勝率・平均ACS・K/Dを返します。

パラメーター

名前	型	デフォルト	説明
`profile_uuid`	string	必須	プレイヤーのUUID
`queue`	string	`"competitive"`	キュー（`competitive` / `unrated` / `swiftplay`）
`limit`	int	`200`	分析する最大試合数（最大500）

レスポンス

json

{
  "queue": "competitive",
  "total_matches": 200,
  "hourly": [
    { "hour": 0,  "matches": 2,  "win_rate": null,  "avg_acs": null,  "avg_kd": null },
    { "hour": 1,  "matches": 0,  "win_rate": null,  "avg_acs": null,  "avg_kd": null },
    { "hour": 21, "matches": 34, "win_rate": 61.8,  "avg_acs": 248.3, "avg_kd": 1.12 },
    { "hour": 22, "matches": 28, "win_rate": 42.9,  "avg_acs": 219.7, "avg_kd": 0.98 },
    { "hour": 23, "matches": 12, "win_rate": 33.3,  "avg_acs": 201.4, "avg_kd": 0.87 }
  ]
}

情報

3試合未満の時間帯は win_rate / avg_acs / avg_kd が null になります。

使用例

get_player_hourly_stats(profile_uuid="...", queue="competitive")

活用例： 「21時台の勝率が高く深夜は下がる → 疲れが出る前にやめるべき」

get_player_agent_breakdown

エージェント別のパフォーマンス（勝率・ACS・K/D）を試合数降順で返します。

パラメーター

名前	型	デフォルト	説明
`profile_uuid`	string	必須	プレイヤーのUUID
`queue`	string	`"competitive"`	キュー
`limit`	int	`200`	分析する最大試合数

レスポンス

json

{
  "queue": "competitive",
  "total_matches": 200,
  "agents": [
    {
      "agent": "ジェット",
      "matches": 42,
      "wins": 24,
      "losses": 18,
      "win_rate": 57.1,
      "avg_acs": 271.3,
      "avg_kd": 1.24
    },
    {
      "agent": "オーメン",
      "matches": 28,
      "wins": 12,
      "losses": 16,
      "win_rate": 42.9,
      "avg_acs": 198.7,
      "avg_kd": 0.94
    }
  ]
}

使用例

get_player_agent_breakdown(profile_uuid="...")

活用例： 「ジェットは57%勝率・ACS271と高いが、オーメンは勝率が低い → ジェットをメインにすべき」

get_player_map_breakdown

マップ別のパフォーマンス（勝率・ACS・K/D）を試合数降順で返します。

パラメーター

名前	型	デフォルト	説明
`profile_uuid`	string	必須	プレイヤーのUUID
`queue`	string	`"competitive"`	キュー
`limit`	int	`200`	分析する最大試合数

レスポンス

json

{
  "queue": "competitive",
  "total_matches": 200,
  "maps": [
    {
      "map": "アセント",
      "matches": 24,
      "wins": 16,
      "losses": 8,
      "win_rate": 66.7,
      "avg_acs": 261.4,
      "avg_kd": 1.18
    },
    {
      "map": "カロード",
      "matches": 18,
      "wins": 6,
      "losses": 12,
      "win_rate": 33.3,
      "avg_acs": 187.2,
      "avg_kd": 0.81
    }
  ]
}

使用例

get_player_map_breakdown(profile_uuid="...", queue="competitive")

活用例： 「アセントは66%の高勝率、カロードは33%と苦手 → BANにカロードを優先」

get_player_weekly_trends

週別の成長トレンド（ACS・K/D・勝率の時系列推移）を返します。

パラメーター

名前	型	デフォルト	説明
`profile_uuid`	string	必須	プレイヤーのUUID
`queue`	string	`"competitive"`	キュー
`weeks`	int	`12`	取得する週数（最大52）

レスポンス

json

{
  "queue": "competitive",
  "total_matches": 180,
  "trends": [
    {
      "week": "2026-W10",
      "matches": 8,
      "wins": 4,
      "losses": 4,
      "win_rate": 50.0,
      "avg_acs": 218.4,
      "avg_kd": 1.02
    },
    {
      "week": "2026-W11",
      "matches": 12,
      "wins": 8,
      "losses": 4,
      "win_rate": 66.7,
      "avg_acs": 251.7,
      "avg_kd": 1.19
    }
  ]
}

week は ISO週番号（YYYY-Www）形式です。

使用例

# 直近12週のトレンド
get_player_weekly_trends(profile_uuid="...", weeks=12)

# 直近1年
get_player_weekly_trends(profile_uuid="...", weeks=52)

活用例： 「3月以降ACSが継続的に上昇 → エイム練習の成果が出ている」

get_player_teammate_stats

一緒にプレイしたチームメイト別の勝率・試合数を返します（min_games 試合以上のみ）。

パラメーター

名前	型	デフォルト	説明
`profile_uuid`	string	必須	プレイヤーのUUID
`queue`	string	`"competitive"`	キュー
`limit`	int	`200`	分析する最大試合数
`min_games`	int	`2`	最低共同試合数のフィルター

レスポンス

json

{
  "queue": "competitive",
  "total_matches": 200,
  "teammates": [
    {
      "riot_id": "Buddy#JP1",
      "games": 24,
      "wins": 16,
      "losses": 8,
      "win_rate": 66.7
    },
    {
      "riot_id": "AnotherPlayer#0101",
      "games": 12,
      "wins": 4,
      "losses": 8,
      "win_rate": 33.3
    }
  ]
}

使用例

# 2試合以上組んだ全員を表示
get_player_teammate_stats(profile_uuid="...")

# 5試合以上の相棒に絞る
get_player_teammate_stats(profile_uuid="...", min_games=5)

活用例： 「Buddy#JP1 と組んだ24試合は66%勝率 → 最もシナジーのある相方」

get_meta_map_stats

VALOTOWNの直近試合データから、マップ別の勝率・試合数・ラウンド数を集計します。

パラメーター

名前	型	デフォルト	説明
`queue`	string	`"competitive"`	キュー
`tier_group`	string	`""`	ランク帯絞り込み

レスポンス

json

{
  "queue": "competitive",
  "tier_group": "全体",
  "sample_matches": 1500,
  "maps": [
    {
      "map": "アセント",
      "matches": 214,
      "win_rate": 51.4,
      "attacker_round_win_rate": 48.9,
      "defender_round_win_rate": 52.1,
      "avg_rounds": 22.4
    }
  ]
}

使用例

get_meta_map_stats()
get_meta_map_stats(tier_group="diamond")

compare_players

2人のプレイヤーの基本スタッツを並べて比較します。

パラメーター

名前	型	デフォルト	説明
`profile_uuid_a`	string	必須	1人目のプレイヤーUUID
`profile_uuid_b`	string	必須	2人目のプレイヤーUUID
`queue`	string	`"competitive"`	キュー
`limit`	int	`100`	比較対象の最大試合数

レスポンス

json

{
  "queue": "competitive",
  "player_a": {
    "riot_id": "PlayerA#JP1",
    "matches": 100,
    "win_rate": 54.0,
    "avg_acs": 231.5,
    "avg_kd": 1.08
  },
  "player_b": {
    "riot_id": "PlayerB#JP1",
    "matches": 100,
    "win_rate": 49.0,
    "avg_acs": 219.8,
    "avg_kd": 0.97
  }
}

使用例

compare_players(profile_uuid_a="...", profile_uuid_b="...")

get_player_recent_form

直近N試合の勝敗推移、連勝・連敗ストリーク、直近の調子を確認します。

パラメーター

名前	型	デフォルト	説明
`profile_uuid`	string	必須	プレイヤーのUUID
`queue`	string	`"competitive"`	キュー
`limit`	int	`20`	直近何試合を見るか

レスポンス

json

{
  "queue": "competitive",
  "matches": 20,
  "wins": 12,
  "losses": 8,
  "current_streak": {
    "type": "win",
    "count": 3
  },
  "recent_results": ["W", "W", "W", "L", "W", "L", "L", "W"]
}

使用例

get_player_recent_form(profile_uuid="...", limit=20)

get_player_performance_distribution

ACS・K/D・キル数の平均、中央値、標準偏差、パーセンタイルを返します。

パラメーター

名前	型	デフォルト	説明
`profile_uuid`	string	必須	プレイヤーのUUID
`queue`	string	`"competitive"`	キュー
`limit`	int	`100`	分析対象の最大試合数

レスポンス

json

{
  "queue": "competitive",
  "total_matches": 100,
  "acs": {
    "mean": 228.4,
    "median": 221.0,
    "stddev": 34.6,
    "p25": 203.5,
    "p75": 251.2
  },
  "kd": {
    "mean": 1.04,
    "median": 1.01,
    "stddev": 0.21,
    "p25": 0.89,
    "p75": 1.18
  },
  "kills": {
    "mean": 16.8,
    "median": 16,
    "stddev": 4.7,
    "p25": 13,
    "p75": 20
  }
}

使用例

get_player_performance_distribution(profile_uuid="...")

get_player_vs_enemy_agent_stats

敵エージェントごとの対面成績や勝率を集計します。

パラメーター

名前	型	デフォルト	説明
`profile_uuid`	string	必須	プレイヤーのUUID
`queue`	string	`"competitive"`	キュー
`limit`	int	`100`	分析対象の最大試合数

レスポンス

json

{
  "queue": "competitive",
  "total_matches": 100,
  "enemy_agents": [
    {
      "agent": "ジェット",
      "matches": 41,
      "wins": 19,
      "losses": 22,
      "win_rate": 46.3
    }
  ]
}

使用例

get_player_vs_enemy_agent_stats(profile_uuid="...")

get_agent_duo_stats

エージェントペアごとの共起率と勝率を集計します。

パラメーター

名前	型	デフォルト	説明
`queue`	string	`"competitive"`	キュー
`tier_group`	string	`""`	ランク帯絞り込み
`limit`	int	`20`	表示件数

レスポンス

json

{
  "queue": "competitive",
  "tier_group": "全体",
  "sample_matches": 1500,
  "duos": [
    {
      "agent_a": "ヴァイパー",
      "agent_b": "オーメン",
      "matches": 132,
      "pair_rate": 8.8,
      "win_rate": 54.5
    }
  ]
}

使用例

get_agent_duo_stats()
get_agent_duo_stats(tier_group="ascendant", limit=10)

get_meta_agent_stats

VALOTOWNの直近試合データからエージェントのピック率・勝率を集計します。ランク帯別にフィルタリングできます。

パラメーター

名前	型	デフォルト	説明
`queue`	string	`"competitive"`	キュー
`tier_group`	string	`""`	ランク帯絞り込み（下記参照）

tier_group の値：

値	対象ランク
`""`	全体
`iron`	アイアン
`bronze`	ブロンズ
`silver`	シルバー
`gold`	ゴールド
`platinum`	プラチナ
`diamond`	ダイヤモンド
`ascendant`	アセンダント
`immortal`	イモータル
`radiant`	レディアント

レスポンス

json

{
  "queue": "competitive",
  "tier_group": "全体",
  "sample_matches": 1500,
  "agents": [
    {
      "agent": "ジェット",
      "picks": 972,
      "pick_rate": 6.5,
      "win_rate": 51.8
    },
    {
      "agent": "クローヴ",
      "picks": 826,
      "pick_rate": 5.5,
      "win_rate": 53.2
    }
  ]
}

使用例

# 全体メタ
get_meta_agent_stats()

# ダイヤ帯のメタ
get_meta_agent_stats(tier_group="diamond")

# イモータル〜レディアントで強いエージェントは？
get_meta_agent_stats(tier_group="immortal")

サンプル数について

直近1,500試合のサンプルから集計しています。プレイヤーが多いランク帯（ゴールド・プラチナ）は信頼性が高く、レディアントは試合数が少ないため参考値です。

分析の組み合わせ例

# 現環境でジェットが強いか調べてから、自分のジェット勝率と比べる
meta = get_meta_agent_stats(tier_group="diamond")
my_agents = get_player_agent_breakdown(profile_uuid="...")
# → メタ勝率と自分の勝率を比較

プレイヤー分析ツール ​

get_player_hourly_stats ​

パラメーター ​

レスポンス ​

使用例 ​

get_player_agent_breakdown ​

パラメーター ​

レスポンス ​

使用例 ​

get_player_map_breakdown ​

パラメーター ​

レスポンス ​

使用例 ​

get_player_weekly_trends ​

パラメーター ​

レスポンス ​

使用例 ​

get_player_teammate_stats ​

パラメーター ​

レスポンス ​

使用例 ​

get_meta_map_stats ​

パラメーター ​

レスポンス ​

使用例 ​

compare_players ​

パラメーター ​

レスポンス ​

使用例 ​

get_player_recent_form ​

パラメーター ​

レスポンス ​

使用例 ​

get_player_performance_distribution ​

パラメーター ​

レスポンス ​

使用例 ​

get_player_vs_enemy_agent_stats ​

パラメーター ​

レスポンス ​

使用例 ​

get_agent_duo_stats ​

パラメーター ​

レスポンス ​

使用例 ​

get_meta_agent_stats ​

パラメーター ​

レスポンス ​

使用例 ​

プレイヤー分析ツール

get_player_hourly_stats

パラメーター

レスポンス

使用例

get_player_agent_breakdown

パラメーター

レスポンス

使用例

get_player_map_breakdown

パラメーター

レスポンス

使用例

get_player_weekly_trends

パラメーター

レスポンス

使用例

get_player_teammate_stats

パラメーター

レスポンス

使用例

get_meta_map_stats

パラメーター

レスポンス

使用例

compare_players

パラメーター

レスポンス

使用例

get_player_recent_form

パラメーター

レスポンス

使用例

get_player_performance_distribution

パラメーター

レスポンス

使用例

get_player_vs_enemy_agent_stats

パラメーター

レスポンス

使用例

get_agent_duo_stats

パラメーター

レスポンス

使用例

get_meta_agent_stats

パラメーター

レスポンス

使用例