search_site
サイト内を横断検索(カード/デッキ/大会/選手/会場/推し)
サイト内を横断検索します。自由文クエリ(カード名/番号・デッキ・大会・選手名・店舗名・推しホロメン名)から、カード・デッキ・大会・選手・会場・推しを種別を問わず検索し、種別混在のランク付き結果(type / title / 正準URL / snippet)を返します。フレンドコードや店舗IDを知らなくても名前で発見できます。
パラメータ
| 名前 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
query |
string | 必須 | - | 検索キーワード(カード/デッキ/大会/選手/店舗/推しの名前や番号。1〜100文字) |
types |
string[] | 任意 | 全種別 | 検索対象の種別を絞り込む。card / deck / tournament / player / venue / oshi の配列 |
limit_per_type |
number | 任意 | 5 | 種別ごとの最大件数(1〜20) |
使用例
名前から何でも探す
プロンプト例:
「ときのそら」に関係するカードや推し、大会成績をまとめて探して
選手・店舗を名前で見つける
プロンプト例:
「○○カードショップ」で開催された大会の会場ページを探して
種別を絞って検索
プロンプト例:
カードだけを対象に「hBP09」で検索して
レスポンス例:
{
"query": "ときのそら",
"results": [
{
"type": "oshi",
"title": "ときのそら",
"url": "https://hocg-logs.holotune.jp/oshi/%E3%81%A8%E3%81%8D%E3%81%AE%E3%81%9D%E3%82%89",
"snippet": "入賞 42 件",
"score": 3.4
},
{
"type": "card",
"title": "ときのそら (hBP01-001)",
"url": "https://hocg-logs.holotune.jp/cards/hBP01-001",
"snippet": "推し",
"score": 3
}
],
"totalsByType": { "card": 1, "oshi": 1, "deck": 0, "tournament": 0, "player": 0, "venue": 0 }
}
注意事項
- 検索は LIKE ベース(部分一致)です。一致の強さ(完全一致 > 前方一致 > 部分一致)と各エンティティの実績件数で
scoreを付与し、種別混在で降順ソートして返します。 cardはカード名の部分一致・カード番号の前方一致、deckはタイトル/レシピIDで照合します。player(選手)は入賞数が一定数以上の選手のみを返します(薄い選手ページは除外)。venue(会場)は開催数が一定数以上の店舗のみが対象です。oshi(推しホロメン)は入賞実績テーブルから名前を導出します(推しのマスタテーブルは持ちません)。urlは各エンティティの正準 Web URL(https://hocg-logs.holotune.jp/...)です。推し名・フレンドコードは URL エンコードされます。- 該当が無い場合は
resultsを空配列、totalsByTypeを 0 件で返します(エラーにはなりません)。 - 結果は種別ごとに
limit_per_type(既定 5・最大 20)で上限管理されます。