query_deck_cards_bulk

デッキカード一括取得

複数デッキのカード構成（カード番号・カード名・枚数）を一括取得します。デッキ ID（内部数値）またはデッキレシピ ID（URL の 5BVMZ 等の英数字コード）による直接指定、または推しホロメン・イベントシリーズ・日付範囲・順位によるフィルタ検索の 2 モードに対応します。

パラメータ

名前	型	必須	デフォルト	説明
`deck_ids`	number[]	任意	-	デッキ ID（内部数値）リスト（直接指定モード、最大 100 件）
`deck_recipe_ids`	string[]	任意	-	デッキレシピ ID（URL の `5BVMZ` 等）リスト（直接指定モード、最大 100 件）。`deck_ids` と併用可、両方を OR で結合
`oshi_holomen`	string	任意	-	推しホロメン名（部分一致フィルタ）
`event_series`	string	任意	-	イベントシリーズ名（部分一致フィルタ）
`date_from`	string	任意	-	開始日（YYYY-MM-DD）
`date_to`	string	任意	-	終了日（YYYY-MM-DD）
`rank_max`	number	任意	-	順位上限フィルタ
`limit`	number	任意	50	取得デッキ数上限

使用例

デッキ ID を指定して一括取得する

プロンプト例:

デッキID 42, 58, 73 のカード構成を一括取得してください

デッキレシピ ID（URL コード）を指定して取得する

プロンプト例:

デッキレシピID 5BVMZ と 4CXS5 のカード構成を取得してください

フィルタ条件で一括取得する

プロンプト例:

ときのそらの Top4 入賞デッキのカード構成を一括取得してください

レスポンス例:

{
  "deckCount": 3,
  "decks": [
    {
      "deckId": 42,
      "deckRecipeId": "2CK09",
      "oshiHolomen": "ときのそら",
      "rank": 1,
      "cards": [
        { "cardNumber": "hSD01-001", "cardName": "ときのそら", "rarity": "OSR", "count": 1 },
        { "cardNumber": "hBP07-001", "cardName": "AZKi", "rarity": "R", "count": 4 },
        { "cardNumber": "hBP07-071", "cardName": "フロンティアスピリット", "rarity": "C", "count": 2 },
        { "cardNumber": "hBP07-071", "cardName": "フロンティアスピリット", "rarity": "SR", "count": 2 }
      ]
    }
  ]
}

注意事項

deck_ids または deck_recipe_ids を指定した場合は直接指定モード、それ以外のパラメータを指定した場合はフィルタ検索モードで動作します
直接指定モードで両方とも空配列 ([]) を渡した場合は deckCount: 0 で即座に返却します
存在しない deck_recipe_ids を含めても他の有効な ID 分は返却されます（部分一致ではなく完全一致）
カード情報が未同期のデッキは結果に含まれません（バックエンドのバッチで順次取り込まれます）
大量のデッキを一括取得する場合は limit で件数を制御してください
同一カード番号が複数レアリティで印刷されている場合、レアリティごとに別エントリとして返されます。合計枚数を知りたい場合は rarity 違いの行を合算してください