query_decks

デッキ検索

データベースに蓄積されたデッキ一覧を検索・フィルタします。推しホロメン名、イベントシリーズ名、日付範囲、順位上限で絞り込みが可能です。

パラメータ

名前	型	必須	デフォルト	説明
`oshi_holomen`	string	任意	-	推しホロメン名（部分一致）
`event_series`	string	任意	-	イベントシリーズ名（部分一致）
`date_from`	string	任意	-	開始日（YYYY-MM-DD）
`date_to`	string	任意	-	終了日（YYYY-MM-DD）
`rank_max`	number	任意	-	順位上限（例: `4` で Top4 のみ）
`region`	string	任意	-	地域（地方区分）。`hokkaido-tohoku` / `kanto` / `hokuriku-koshinetsu` / `tokai` / `kansai` / `chugoku-shikoku` / `kyushu-okinawa`
`min_participants`	number	任意	-	最小参加人数（例: `32` で32人以上の大会のみ）
`limit`	number	任意	50	取得件数
`offset`	number	任意	0	オフセット

使用例

特定の推しホロメンの入賞デッキを検索する

プロンプト例:

ときのそらの Top4 入賞デッキを検索してください

レスポンス例:

{
  "decks": [
    {
      "deckId": 42,
      "deckRecipeId": "2CK09",
      "oshiHolomen": "ときのそら",
      "rank": 1,
      "username": "プレイヤーA",
      "eventSeries": "hOCG Vol.5 ショップ大会",
      "organizerName": "カードショップ○○",
      "date": "2025-01-15",
      "participants": 16
    }
  ],
  "total": 12
}

期間を指定してデッキを検索する

プロンプト例:

2025年1月から3月までの全デッキを検索してください

注意事項

検索対象はデータベースに蓄積済みのデータのみです
oshi_holomen と event_series は部分一致検索です
rank_max を指定すると、指定順位以内のデッキのみが返されます
region は地方区分キーで指定します（サーバ側で都道府県へ解決）。不明な値はフィルタなし扱いです
min_participants は大会の参加人数以上で絞り込みます