query_cards

カード検索

カードマスタを検索します。カード番号の前方一致、カード名の部分一致で絞り込みが可能です。

パラメータ

名前	型	必須	デフォルト	説明
`card_number`	string	任意	-	カード番号（前方一致、例: `hBP07`）
`card_name`	string	任意	-	カード名（部分一致）
`limit`	number	任意	50	取得件数
`offset`	number	任意	0	オフセット

使用例

カード番号で検索する

プロンプト例:

hBP07 のカード一覧を検索してください

カード名で検索する

プロンプト例:

「ときのそら」のカードを検索してください

レスポンス例:

{
  "cards": [
    {
      "cardNumber": "hSD01-001",
      "cardName": "ときのそら",
      "cardKind": "推しホロメン",
      "cardImageUrl": "https://...",
      "rarity": "OSR",
      "bloomLevel": null
    }
  ],
  "total": 5
}

注意事項

検索対象は DB に同期済みのカードのみです（同期はバックエンドで定期的に行われています）
card_number は前方一致、card_name は部分一致で検索されます
パラメータを何も指定しない場合、全カードが返されます（limit でページネーション）