# eBay Shopper MCP

> eBay Shopper connects your AI client directly to the eBay product catalog. Use it to search for items by keyword, image, or category, and pull deep data like full specifications, current pricing, shipping estimates, and aggregated customer reviews—all automatically.

## Overview
- **Category:** industry-titans
- **Price:** Free

## Description

Shopping on eBay is a mess of tabs and conflicting details. This MCP lets your agent bypass the manual research phase entirely. Instead of clicking through pages to verify if an auto part fits your vehicle or comparing five different listings for the best price, you just ask your AI client. It handles all that grunt work: finding specific product IDs, pulling full technical specs from the merchant side, and calculating estimated shipping costs before you commit. You get a clean data dump ready for decision-making. Because Vinkius hosts this MCP, your agent can access eBay's entire structure—from discovering niche categories to running visual searches based on an uploaded picture. It turns complex, multi-step market research into a single query.

## Tools

### get_categories
Lists the available product categories, helping you navigate eBay's massive organizational structure.

### get_item_compatibility
Checks if an auto part listing will fit your specific vehicle model before you buy it.

### get_item_details
Pulls the full technical specifications for a product using its item ID, ideal for comparison shopping.

### get_item_rating
Provides an immediate summary of customer quality ratings for any listed item.

### get_item_reviews
Retrieves specific customer reviews and star ratings, letting you gauge product satisfaction depth.

### get_merchant_item_details
Shows item specifics from the seller's point of view, which is useful for checking inventory status.

### search_items
Searches the entire platform using keywords, brand names, or general product titles to find multiple matches.

### search_by_category
Searches only within a specific product category, allowing you to narrow down browsing quickly.

### search_by_image
Finds similar products on eBay just by uploading a picture of what you're looking for.

### get_shipping_estimate
Calculates the total estimated shipping cost and expected delivery date for a purchase.

## Capabilities

### Discovering Inventory
Find product listings by general keywords, specific image URLs, or deep within the structured category hierarchy.

### Product Deep Dive
Retrieve every available detail for a single item, including specs from the merchant and full customer review summaries.

### Verifying Fitment & Logistics
Check if an auto part matches your vehicle model or calculate the final cost by estimating shipping rates and delivery dates.

## Use Cases

### Need to buy a replacement auto part
A user uploads a photo of the broken component. The agent runs `search_by_image` and then uses `get_item_compatibility` on the top results to confirm which ones actually fit their vehicle model.

### Comparing electronics from different sellers
A user needs a new camera lens. The agent runs `search_items` for 'Canon 50mm' and then loops through the top five results, using `get_item_details` and `get_merchant_item_details` on each one to pull detailed specs and seller-specific inventory notes.

### Determining if a collectible is worth it
A user finds an old piece of furniture. The agent uses `search_by_category` in the 'Home Goods' section, then runs `get_item_reviews` on the top listings to see what actual buyers thought about similar items.

## Benefits

- Stop guessing if a part fits. Use `get_item_compatibility` to verify auto-parts fitment instantly, avoiding costly mistakes.
- Don't just look at the price. Run `get_item_reviews` or `get_item_rating` to quickly assess product quality and customer satisfaction before you buy.
- Know the true cost up front. Use `get_shipping_estimate` to calculate the total expense, including shipping and delivery time, so there are no surprises at checkout.
- Go beyond basic search. Upload a photo and use `search_by_image` to find items that look like what you're searching for—perfect when you don't know the model name.
- Compare deep specs easily. Grab the full product details using `get_item_details` so you can compare technical features across different brands side-by-side.

## How It Works

The bottom line is you get structured market intelligence without ever leaving your chat window.

1. First, tell your agent what you need. For example, 'Find me a listing for this brand of lawnmower' or 'What are the specs on item ID 12345?'
2. Your AI client runs the necessary tool calls—it might need to search first, then pull details, and finally check compatibility.
3. You receive a consolidated JSON object containing all the gathered data: prices, condition reports, full specifications, and review summaries.

## Frequently Asked Questions

**How do I find a product by picture using search_by_image?**
Just upload the image directly to your agent. The tool uses it to locate visually similar items across the whole eBay catalog, returning price and detail information for comparison.

**Can get_item_compatibility verify parts for my car?**
Yes. This tool is built specifically for auto parts buyers; you pass your vehicle details to `get_item_compatibility` to confirm fitment before making a purchase decision.

**What if I want to see all reviews? Do I use get_item_reviews?**
Yes, that's the right tool. `get_item_reviews` pulls specific customer feedback—including the review text and star rating—which is more detailed than just looking at the average score.

**How do I search for items if I don't know the brand?**
Use `search_items`. You can provide general keywords, product type, or a description and it will return multiple matching listings with titles and current prices.

**If I need to explore available product types, should I use get_categories?**
Yes, you must use get_categories. This tool lists both parent and subcategories within the entire eBay catalog structure. Use it first to determine the correct category ID before running any targeted searches.

**How can I find out the full cost of an item including shipping? Do I need get_shipping_estimate?**
Yes, you run get_shipping_estimate. This tool calculates the total estimated cost and delivery date for any specific listing ID. It’s key to knowing the final price before committing.

**What is the difference between general product specs and merchant data? When should I use get_merchant_item_details?**
get_merchant_item_details provides inventory-focused information from the seller's perspective. Use this when you are researching stock levels or need details beyond what a public listing shows.

**If I know my category but not specific keywords, how do I use search_by_category?**
Use search_by_category to filter results by an ID you get from the categories endpoint. This narrows your search scope immediately, giving you relevant items within a precise section of eBay.