Supplier: Get Product Ideas
list_featured_product_collections[Supply Product]
[What it does] Lists curated product collections visible to the account's supplier applications: collection names, descriptions and scene types. Theme entry points only, never product records.
[When to use] Call it when the merchant gives no category or keyword and asks what to sell, what is recommended, or what is selling well; the agent also calls it first when a supplier product search needs a direction. Trigger words: product ideas, best sellers, what should I sell, curated collections, inspiration.
[When not to use] With a clear category or keyword, use search_supplier_products for products and prices and get_supplier_product for one product; use create_pre_publish_products to import, and list_managed_store_products for the merchant's own listings.
[How to use]
Collections are editorial placements, not a sales ranking, and the scene type is not a product category: present them as curated themes and use the type for grouping only.
Collection IDs are banner identifiers, not product IDs; never pass them to a product lookup, and show the name and description instead.
An empty list is a valid result, not a failure: say no themes are available and stop; do not retry or re-tune parameters.
To limit platforms, copy supplier platform IDs only from
list_storessupplier_apps[].supplier_platform_id; omit them when unsure to cover every visible platform. [Side effects] Read-only; no data or configuration is changed. [Confirmation] None required. [Follow-up] Themes only: once the merchant picks a collection, search it withsearch_supplier_products; listing themes alone does not answer "what should I sell".
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": "list_featured_product_collections"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| supplier_platform_ids | No | Optional supplier platform IDs to intersect with visible supplier apps. Copy exact values from list_stores supplier_apps[].supplier_platform_id. Paste JSON example: ["100000001"]. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ideas | Yes | All visible product-idea scenes matching the requested supplier applications | |
| matched_count | Yes | Number of visible scenes returned | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |