Search products by ingredient
inkeedecoder_search_productsSearch cosmetic products by name and required or forbidden ingredients, such as moisturizers with squalane and no fragrance, returning one page at a time with next-page availability.
Instructions
Search INKEEDecoder for cosmetic products using the advanced filter: match a name and/or require and forbid specific ingredients. Use it for questions like "moisturizers with squalane and no fragrance". Returns one page of products — each response says whether another page is available. Read-only.
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": "inkeedecoder_search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number. Each response states whether another page is available. | |
| query | No | Free-text part of the search: a product or brand name. Leave empty to filter purely by ingredients — but then pass `include` or `exclude`. | |
| exclude | No | Ingredients the product must not contain, using the site's display names — for example ["Fragrance", "Alcohol Denat."]. | |
| include | No | Ingredients the product must contain, using the site's display names — for example ["Squalane", "Tocopherol"]. Take these from an ingredient page's name, not from an INCI list. | |
| include_mode | No | `all` (default) requires every `include` ingredient; `any` requires at least one. | all |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | 1-based page number of this page. | |
| items | Yes | Results on this page. | |
| hasMore | Yes | Whether another page is available. | |
| nextPageUrl | No | URL of the next page, present when hasMore is true. |