統計ツール

VALOTOWNプラットフォーム全体の集計統計を取得します。

get_platform_stats

プラットフォーム全体の統計情報を取得します。

レスポンス

{
  "total_matches": 107089,
  "total_players": 876,
  "total_clips": 2341,
  "last_updated": "2026-07-18 21:00:00"
}

使用例

get_platform_stats()

---

get_weapon_headshot_stats

武器別のヘッドショット率・キル統計を取得します。プラットフォーム全体の試合データから集計します。

パラメーター

名前	型	デフォルト	説明
limit	int	20	取得する武器数

レスポンス

[
  {
    "weapon_id": "63e6c2b6-4a8e-869c-3d4c-e38355226584",
    "weapon_name": "ゴースト",
    "headshots": 12840,
    "bodyshots": 38921,
    "legshots": 4102,
    "total_shots": 55863,
    "headshot_rate": 22.99
  },
  {
    "weapon_id": "...",
    "weapon_name": "オペレーター",
    "headshots": 8921,
    "bodyshots": 5123,
    "legshots": 412,
    "total_shots": 14456,
    "headshot_rate": 61.71
  }
]

使用例

# 全武器のHS率（上位20件）
get_weapon_headshot_stats()

# 上位10件のみ
get_weapon_headshot_stats(limit=10)

備考

HS率が高い武器はオペレーター（スナイパー）のような一撃必殺系が上位に来ます。練習の目安として、ゴーストやシェリフのHS率が参考になります。

---

get_map_stats

マップ別の試合数統計を取得します。

パラメーター

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

レスポンス

[
  {
    "map_id": "/Game/Maps/Juliett/Juliett",
    "map_name": "サンセット",
    "match_count": 438
  },
  {
    "map_id": "/Game/Maps/Jam/Jam",
    "map_name": "ロータス",
    "match_count": 428
  }
]

使用例

get_map_stats()

---

get_queue_stats

キュー別（コンペティティブ・アンレート・デスマッチなど）の試合数統計を取得します。

レスポンス

[
  { "queue": "competitive",  "match_count": 49346 },
  { "queue": "swiftplay",    "match_count": 19088 },
  { "queue": "deathmatch",   "match_count": 14731 },
  { "queue": "hurm",         "match_count": 7539  },
  { "queue": "unrated",      "match_count": 5626  }
]

使用例

get_queue_stats()