Amazon Product Search

by sharavanask

Not rated
GitHub

About

An AI-powered server for Amazon product search and recommendations.

Details

Author
sharavanask
Categories
Search, Other

Setup

Install Amazon Product Search in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/sharavanask/ShopAssist-MCP

Follow the installation instructions in the repository README, then restart your MCP client.

An AI-powered server for Amazon product search and recommendations.

The site is live here ! :https://shopassist-sharavana.streamlit.app/

An MCP (Model Context Protocol) server that provides AI-powered Amazon product search and recommendations using FastMCP.

- πŸ” Smart product search with Amazon API
- πŸ€– AI-powered product recommendations using Hugging Face
- πŸ’° Price range filtering
- πŸ“‹ Feature-based matching
- 🎯 Tailored recommendations for Small/Medium Enterprises
- Clone this repository and navigate to the project directory
- Install dependencies:

# Using uv (recommended) uv sync # Or using pip pip install -r requirements.txt
# Activate your virtual environment source .venv/bin/activate # On Windows: .venv\Scripts\activate # Run the server python main.py

- getdata: Search Amazon products with AI recommendations

We provide multiple client implementations to interact with your MCP server:

1. Python Interactive Client (client.py)

A full-featured Python client with examples and interactive mode.

- Pre-built examples (laptops, smartphones)
- Interactive search mode
- Real-time communication with MCP server

2. Command Line Interface (cli_client.py)

Quick command-line searches for automation and scripting.

# Basic search python cli_client.py "laptop" # With features and price range python cli_client.py "laptop" --features "8GB RAM, SSD storage" --min-price 30000 --max-price 80000 # Smartphone search python cli_client.py "smartphone" --features "good camera, 5G" --min-price 15000 --max-price 50000

- product: Product to search for (required)
- --features,-f: Specific features to look for
- --min-price,-min: Minimum price in rupees
- --max-price,-max: Maximum price in rupees

A beautiful web interface with REST API backend.

# Install additional dependencies pip install fastapi uvicorn # Run the web server python web_client.py

Then openhttp://localhost:8000in your browser for a user-friendly interface.

- GET /: Web interface
- POST /search: REST API for product search
- GET /health: Health check

You can also use the MCP CLI to interact with your server:

# Install MCP CLI if not already installed pip install mcp # Connect to your server mcp connect stdio -- python main.py
{ "product": "laptop", "specific_features": "8GB RAM, SSD storage, good for programming", "min_price": 30000, "max_price": 80000 }
{ "product": "smartphone", "specific_features": "good camera, long battery life, 5G support", "min_price": 15000, "max_price": 50000 }
{ "product": "wireless headphones", "specific_features": "noise cancellation, comfortable", "min_price": 1000, "max_price": 5000 }

- Hugging Face API Token: UpdateHF_API_TOKENinserver/buy.py
- RapidAPI Key: Update thex-rapidapi-keyinserver/buy.py

You can customize the AI recommendation prompt in thedecision_agentfunction inserver/buy.py.

To use this MCP server with Claude Desktop, add this configuration to yourclaude_desktop_config.json:

{ "mcpServers": { "amazon-search": { "command": "python", "args": ["path/to/your/main.py"], "env": {} } } }

- Import errors: Make sure you're in the correct virtual environment
- API failures: Check your API keys and internet connection
- Connection issues: Ensure the MCP server is running before starting clients

- "No result": Usually indicates API issues or no products found
- "Connection refused": MCP server is not running
- "Tool not found": Server initialization issue
- Add new tools inserver/buy.pyusing the@mcp.tool()decorator
- Update client code to use new tools
- Test with the interactive client first

# Test the server directly python -c "from server.buy import mcp; print('Server loads successfully')" # Test with the interactive client python client.py
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ MCP Client │◄──►│ MCP Server │◄──►│ External APIs β”‚ β”‚ (Your Choice) β”‚ β”‚ (FastMCP) β”‚ β”‚ (Amazon/HF AI) β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β”‚ β”‚ β–Ό β–Ό β–Ό β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ β€’ client.py β”‚ β”‚ β€’ Tool: getdata β”‚ β”‚ β€’ Amazon Search β”‚ β”‚ β€’ cli_client β”‚ β”‚ β€’ AI Agent β”‚ β”‚ β€’ HuggingFace β”‚ β”‚ β€’ web_client β”‚ β”‚ β€’ FastMCP β”‚ β”‚ β€’ Recommendationsβ”‚ β”‚ β€’ Claude β”‚ β”‚ β”‚ β”‚ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

This project is open source. Please ensure you comply with the terms of service of the APIs used (Amazon, RapidAPI, Hugging Face).

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Search and get install details on MCP servers directly from your agent -- a unified marketplace index.

Argentina's trust-first local services marketplace. Six read-only tools to search verified professionals and deep-link into on-platform task creation. β”‚

Discover ethical, origin-verified products from the US and Canada by country, category, or brand.

Real-time search API for AI agents. Search Google, Amazon, Walmart, and YouTube with 9 tools -- product search, product details, video search, transcripts, and more. Build price comparison agents, retail arbitrage tools, content research pipelines, and brand monitors. 500 free credits/month.

Connects AI to Facebook Marketplace, Ebay, Poshmark, and Depop to find you the best deals

Google for agentic fashion shopping/discovery. Indexed fashion brand e-coms. Semantic search.

Real-time product search and price comparison across 15+ SG/SEA/US merchants (161M+ products) via MCP server and REST API

DesiDime MCP Server is the AI powered Deal & Coupon Search: Search deals, coupons, stores, and more from India's largest shopping community directly in Claude, ChatGPT, Cursor, or any MCP-compatible AI assistant.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.