search_offers
Search multiple Chinese and Australian marketplaces at once for a product and get ranked, landed-cost offers with shipping estimates, plus past sale prices and per-marketplace diagnostics.
Instructions
Search marketplaces for a product and return ranked offers.
The result lists buyable offers first (kind='offer', ranked by `sort`), then
past sale prices (kind='comp'), then one kind='diagnostic' entry for every
requested marketplace that returned no offers. A diagnostic's
diagnostic_code is one of: missing_key, timeout, upstream_error, quota,
unsupported, degraded, unsubscribed, no_results.
Each offer has shipping.delivery (direct, pickup, via_forwarder or unknown)
for the destination postcode and landed_aud, the total for `qty` delivered.
landed_basis says how firm that total is: exact, estimated (China offers,
from a forwarder rate and an assumed weight) or item_only (shipping cost not
stated). Offers that cannot reach the destination are left out and counted
in a not_deliverable diagnostic.
All marketplaces run at once under one deadline. Hosted scraper sources
take 30 to 90 s, so a short deadline reports them as timeout.
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": "search_offers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| qty | No | Requested quantity. Offers with a larger minimum order rank last. | |
| sort | No | Ranking intent | best_value |
| query | Yes | Product keyword, e.g. 'wireless mouse'. Sent as written to every source. | |
| ship_to | No | Destination country code. Default: SHIP_TO_COUNTRY (AU). | |
| postcode | No | Destination postcode. Default: SHIP_TO_POSTCODE (4000, Brisbane). | |
| query_zh | No | The query in Chinese, e.g. 硅胶厨具. Used for taobao, tmall, 1688 and jd, which match Chinese far better than English. Translate the query yourself and pass it here. | |
| deadline_s | No | Seconds allowed for the whole search. Default: PROCUREMENT_DEADLINE_S. | |
| max_results | No | Per-marketplace cap, then ranked globally | |
| marketplaces | No | Subset to search. Defaults to all. Valid: taobao, tmall, 1688, jd, pdd, aliexpress, ebay_au, ebay_sold (past AU sale prices, returned as kind='comp'), amazon_au, gumtree, facebook, woolworths, coles, aldi (grocery with unit pricing), ozbargain, cheapies. An unknown name returns a diagnostic entry. | |
| ebay_auctions | No | eBay: auction listings only (current bid, bid count, end time). Default: fixed price. | |
| est_weight_kg | No | Weight of one item in kg. Used for the freight forwarder estimate on taobao, tmall, 1688, jd and pdd offers. Default: FORWARDER_DEFAULT_WEIGHT_KG. | |
| include_pickup | No | Include listings that must be collected in person near the destination. | |
| ebay_seller_scope | No | eBay seller scope. 'domestic': items located in AU. 'global': world-wide sellers on the AU marketplace. 'auto': eBay default ranking. | domestic |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |