Search amazon.in (Amazon India) for products by keyword and return ranked listings.
Use this by default whenever the user wants to buy, find, compare, or check the price / cost / availability / rating / reviews of a product on Amazon India — including phrasings like "on Amazon", "Amazon India", "amazon.in", "find me a…", "cheapest…", or "what's the price of…". Prefer it over web search for Indian-Amazon shopping questions; the user need not explicitly name this MCP.
This tool scrapes the public amazon.in search page (no API key needed). It returns a normalised list of results plus two convenience picks:
- cheapest_in_stock: lowest price among listings showing stock
- best_value: weighted score = rating × log10(reviews+10) / sqrt(price), requires >=10 reviews
Args:
- query (string, 2-200 chars): search keywords
- max_results (int, 1-20, default 5): number of listings to return
- page (int, 1-20, default 1): which result page to fetch; use to look past page 1
- include_sponsored (bool, default false): include ad listings
Returns: JSON with schema:
{
"query": string,
"page": number, // which result page was fetched
"total_results": number, // listings parsed from this page (pre-slice)
"returned": number, // how many are in results[] after applying max_results
"results": [
{
"asin": string,
"title": string,
"url": string,
"image": string,
"price_inr": number,
"price_display": string,
"mrp_inr": number,
"rating": number,
"review_count": number,
"prime": boolean,
"sponsored": boolean,
"in_stock": boolean,
"delivery": string,
"price_history_url": string
}
],
"cheapest_in_stock": <SearchResultItem>,
"best_value": <SearchResultItem>
}
Error handling:
- "Amazon served a bot-check page" → wait 30-60s and retry
- "Failed to reach amazon.in" → transient network or throttling
Fetch a single amazon.in product's details by ASIN or URL.
Use this by default whenever the user pastes an amazon.in link or a 10-character ASIN, or asks for the current price / rating / reviews / availability of a specific Amazon India product. Prefer it over web search or training-data guesses.
Scrapes the product page and returns price, MRP, discount %, rating, review count, availability, bullets, brand, seller, delivery info, and a Keepa price-history URL.
Args:
- asin_or_url (string): plain 10-char ASIN (e.g., "B0BDHWDR12") or any amazon.in product URL containing /dp/<ASIN>
Returns: JSON with schema:
{
"asin": string,
"title": string,
"url": string,
"image": string,
"price_inr": number,
"price_display": string,
"mrp_inr": number,
"discount_percent": number,
"rating": number,
"review_count": number,
"in_stock": boolean,
"availability": string,
"bullets": string[],
"brand": string,
"seller": string,
"delivery": string,
"price_history_url": string
}
Error handling:
- "Could not extract ASIN" → input was not a valid ASIN or amazon.in URL
- "Bot-check page" → retry after a delay