query_player

選手の入賞履歴・成績取得

選手（プレイヤー）の入賞履歴・成績を取得します。フレンドコードを安定キーとして、通算成績（優勝/準優勝/TOP8）、出場大会数、使用推しホロメン分布、デッキ傾向（アーキタイプ別分布）、関連選手（同推しの上位選手）、入賞履歴を返します。

パラメータ

名前	型	必須	デフォルト	説明
`friend_code`	string	必須	-	選手のフレンドコード（安定キー）
`wgp_only`	boolean	任意	false	true で WGP決勝ラウンドの実績のみに絞り込む
`season_id`	string	任意	-	弾シーズンID（例: `hBP08`）で期間を絞り込む

使用例

選手の成績を調べる

プロンプト例:

フレンドコード ABCD-1234 の選手の戦績と使用推しを教えてください

レスポンス例:

{
  "friendCode": "ABCD-1234",
  "displayName": "プレイヤーA",
  "wgpOnly": false,
  "seasonId": null,
  "stats": { "total": 12, "champions": 3, "runnerUps": 2, "top8": 8 },
  "eventCount": 10,
  "oshiDistribution": [{ "oshiHolomen": "ときのそら", "count": 7, "champions": 2, "top8": 5 }],
  "archetypeDistribution": [{ "archetypeName": "そらビート", "archetypeId": 42, "oshiHolomen": "ときのそら", "count": 5 }],
  "relatedOshi": "ときのそら",
  "relatedPlayers": [{ "friendCode": "EFGH-5678", "displayName": "プレイヤーB", "total": 9 }],
  "results": [
    {
      "rank": 1,
      "oshiHolomen": "ときのそら",
      "deckRecipeId": "2CK09",
      "sourceEventId": 12345,
      "eventSeries": "hOCG Cup",
      "eventTitle": null,
      "date": "2026-07-05",
      "place": "東京"
    }
  ]
}

注意事項

キーは friend_code（フレンドコード）です。displayName は最新の表示名で、変動しうるためキーには使いません
フレンドコードが記録されていない結果は対象外です
oshiDistribution は推しごとの入賞数（count）に加え、優勝数（champions）・TOP8 数（top8）の内訳を含みます（入賞数降順）
wgp_only / season_id を指定すると、stats / 各分布 / results がその範囲で再計算されます（displayName は全期間の最新名を保持）
archetypeDistribution はデッキがアーキタイプ分類済みの入賞のみを集計します（未分類・デッキ欠損は除外。空配列になりうる）
relatedPlayers はこの選手の最頻出推し（relatedOshi）を共有する他の上位選手です。入賞数が一定数（薄い選手を除外する閾値）以上の選手のみを返します（空配列になりうる）
該当が無い場合は { "error": "Player not found" } を返します