search_products
Search product data by keyword, category, brand, price, and recency, and retrieve totals, facets, and refinement suggestions to narrow ambiguous product queries.
Instructions
商品を検索する。query はキーワード(空白区切りでAND)、category は子カテゴリ名・親カテゴリ名・親スラッグのいずれでも可、brand はブランド名またはブランドグループ名(日英表記ゆれは自動で吸収する)。exclude_brand は除外したいブランド名(表記ゆれは同様に吸収する)。exclude_category は除外したいカテゴリ名(子・親・親スラッグのいずれでも可。親を指定すると配下の子カテゴリをすべて除外する)。
sort は score(既定)/ price_asc / price_desc / relevance(タイトル・カテゴリ一致を
重視する関連度順)/ newest(調査日が新しい順)。offset で続きのページを取得できる。
updated_within_days を渡すと、直近その日数以内に調査された商品だけに絞る。
応答には total_count(条件に合う全件数)と facets(全件のブランド・カテゴリ・
親カテゴリ・価格帯)が含まれる。条件が曖昧な相談では、facets の実際の選択肢を
使って絞り込みを提案できる。
結果が3件以下の場合は suggestions(どの条件を緩めると何件出るか)が含まれる。
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | score | |
| brand | No | ||
| limit | No | ||
| query | No | ||
| offset | No | ||
| category | No | ||
| max_price | No | ||
| min_price | No | ||
| min_score | No | ||
| exclude_brand | No | ||
| in_stock_only | No | ||
| exclude_category | No | ||
| updated_within_days | No |