sold_price_stats
Calculates count, min, quartiles, median, max and mean of recent sold prices per site on Mercari, Yahoo! Auctions and Rakuma to judge whether a price is fair.
Instructions
What an item actually sells for: statistics over recently sold listings.
Reads the most recent sold listings from Mercari, Yahoo! Auctions (final prices) and Rakuma, and returns count, min, p25, median, p75, max and mean overall and per site, plus a few recent sales as examples.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "sold_price_stats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search keyword, ideally in Japanese. | |
| sites | No | Sites with sold history to use. Default: mercari, yahoo, rakuma. | |
| sample | No | Sold listings to read per site before filtering. | |
| exclude | No | Drop listings whose title contains any of these words (case-insensitive). | |
| max_price | No | Maximum price in JPY. | |
| min_price | No | Minimum price in JPY. | |
| match_all_words | No | Keep only listings whose title contains every word of the query (ignoring width, case, spaces and hyphens). The sites' own search is fuzzy: 'PS5 CFI-2000' also returns PS5 games. |