query_deck_composition

デッキ構成分析

特定デッキのカード構成を取得します。カード種別（推し / メイン / エール）ごとにグループ化して返します。複数デッキ指定時は共通カード・差分を分析します。

パラメータ

使用例

1つのデッキの構成を確認する

プロンプト例:

デッキID 42 のカード構成を教えてください

レスポンス例:

{
  "deckId": 42,
  "deckRecipeId": "2CK09",
  "composition": {
    "推しホロメン": [
      { "cardNumber": "hSD01-001", "cardName": "ときのそら", "count": 1, "rarity": "OSR" }
    ],
    "メイン": [
      { "cardNumber": "hBP07-001", "cardName": "AZKi", "count": 4, "rarity": "R" },
      { "cardNumber": "hBP07-002", "cardName": "星街すいせい", "count": 3, "rarity": "SR" },
      { "cardNumber": "hBP07-071", "cardName": "フロンティアスピリット", "count": 2, "rarity": "C" },
      { "cardNumber": "hBP07-071", "cardName": "フロンティアスピリット", "count": 2, "rarity": "SR" }
    ],
    "エール": [
      { "cardNumber": "hSD01-020", "cardName": "応援エール", "count": 4, "rarity": "C" }
    ]
  },
  "totalCards": 50
}

複数デッキを比較する

プロンプト例:

デッキID 42 と 58 のカード構成を比較してください

レスポンス例:

{
  "deckCount": 2,
  "commonCards": [
    { "cardNumber": "hSD01-001", "cardName": "ときのそら", "rarity": "OSR" }
  ],
  "sharedCards": [
    { "cardNumber": "hBP07-001", "cardName": "AZKi", "rarity": "R", "presentInDecks": [42, 58] }
  ],
  "uniqueCards": {
    "42": [{ "cardNumber": "hBP07-010", "cardName": "白上フブキ", "rarity": "SR" }],
    "58": [{ "cardNumber": "hBP07-020", "cardName": "大空スバル", "rarity": "C" }]
  }
}

注意事項

• deck_ids は必須パラメータです。デッキ ID は query_decks で検索できます
• カード情報が未同期のデッキはカード構成が空で返ります（バックエンドのバッチで順次取り込まれます）
• 複数デッキを指定すると、共通カード・一部共通カード・固有カードに分類して返します
• 同一カード番号が複数レアリティで印刷されている場合、レアリティごとに別エントリとして返されます（例: フロンティアスピリットが C 2 枚 + SR 2 枚 で構成される場合、count: 2 のエントリが 2 つ返る）
• 複数デッキ比較モードでは、カードの同一性判定に (cardNumber, rarity) の組を用います。レアリティ違いは別カードとして扱われるため、「同じ cardNumber でも片方にしか存在しない」ケースが uniqueCards に分類されます