describe_tool before executing.
Common operations
| Operation | What it returns |
|---|---|
search-item-list_v1 | Ranked list of products matching a keyword or filter query |
get-item-detail_v1 / get-product-detail_v1 | Full product record — title, price, specs, images, and reviews |
get-best-sellers_v1 | Best-seller rankings for a given category or marketplace segment |
get-category-products_v1 | All products listed under a specific category node |
Example
The three-step flow for searching wireless earbuds:Available marketplaces, supported filter fields, and response schemas differ by provider. Before executing any e-commerce tool, call
describe_tool("Provider/Operation") to confirm the exact required and optional parameters, understand what marketplace it targets, and review the per-call credit cost.