Title99/100
Search products
The title clearly communicates the tool’s action and subject. Keep it concise.
Description98/100
Search CheapestInIndia for products sold in India, with live prices from Amazon, Flipkart, Croma, Reliance Digital, Myntra, Nykaa and other Indian retailers. Use it for any shopping question about products in India: prices, where to buy, options under a budget. For 'is ₹X a good price' or price history of a named product, call get_price_history with `query` directly. Results are ordered category-first: real products before accessories, stores mixed. Put the brand in the query ('samsung 55 inch tv'). Returns products (price, MRP, discount, store, image, buy link, price-history page) and facets (stores, categories, price range). The results are shown to the user as product cards automatically, with a link to all results on CheapestInIndia. Next steps: get_price_history to judge a price, compare_products to compare 2–4 items; render_product_results only to show a hand-picked subset.
The description explains the capability, when to use it, and what to expect.
Inputs84/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
What the user is shopping for, e.g. 'jbl flip 6'
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
stores
Only these retailers, e.g. ['amazon.in', 'flipkart.com']
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
category_ids
Category group ids from browse_categories or a previous search's facets
Clear enough to supply this argument.
min_price
Minimum price in INR
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
max_price
Maximum price in INR
Clear enough to supply this argument.
sort
Default relevance. price_asc = cheapest first
Clear enough to supply this argument.
page
Page number (default 1)
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
per_page
Results per page (default 10, max 20)
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations75/100
Declare idempotentHint based on the tool’s actual behavior.
{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}Output schema88/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"page",
"total",
"hasMore",
"products",
"facets",
"searchPageUrl"
],
"properties": {
"page": {
"type": "number"
},
"query": {
"type": "string"
},
"total": {
"type": "number"
},
"facets": {
"type": "object",
"required": [
"stores",
"categories"
],
"properties": {
"stores": {
"type": "array",
"items": {
"type": "string"
}
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"priceRange": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"hasMore": {
"type": "boolean"
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"price",
"currency",
"store",
"productUrl",
"productPageUrl",
"outOfStock"
],
"properties": {
"id": {
"type": "string",
"description": "CheapestInIndia product id — pass through unchanged"
},
"mrp": {
"type": "number",
"description": "Maximum retail price in INR, when known"
},
"brand": {
"type": "string"
},
"price": {
"type": "number",
"description": "Current price in INR"
},
"store": {
"type": "string",
"description": "Retailer, e.g. amazon.in, flipkart.com"
},
"title": {
"type": "string"
},
"currency": {
"type": "string",
"const": "INR"
},
"imageUrl": {
"type": "string"
},
"outOfStock": {
"type": "boolean"
},
"productUrl": {
"type": "string",
"description": "Attributed buy link (CheapestInIndia redirect to the retailer)"
},
"lowestPrice": {
"type": "number",
"description": "Lowest price ever recorded by CheapestInIndia, INR"
},
"priceChange": {
"type": "number",
"description": "Most recent price change in INR (negative = price dropped, positive = went up)"
},
"atLowestPrice": {
"type": "boolean",
"description": "True when the current price is the lowest ever recorded"
},
"priceChangeAt": {
"type": "string",
"description": "When that price change happened (ISO 8601)"
},
"productPageUrl": {
"type": "string",
"description": "CheapestInIndia price-history page — use for citations"
},
"discountPercent": {
"type": "number",
"description": "Discount from MRP, %"
}
},
"additionalProperties": false
}
},
"searchPageUrl": {
"type": "string"
},
"correctedQuery": {
"type": "string"
}
},
"additionalProperties": false
}