eBay MCP Server — Product Search for AI Agents

Search eBay product listings worldwide by keyword. Extract prices, condition, shipping costs, seller info, and item specifics.

🧠 MCP Server — AI Agent Ready

This actor is a Model Context Protocol (MCP) server — AI assistants can call it directly:

{
  "searchQuery": "iphone",
  "maxResults": 10,
  "country": "US"
}

Returns structured product data: title, price, condition, shipping, seller, item specifics — perfect for price monitoring, product research, and e-commerce AI agents.

Features

• 13 country marketplaces — US, UK, DE, FR, IT, ES, AU, CA, IN, JP, AE, SA, BR
• 28 output fields — itemId, title, price, currency, listing type, bids, shipping, seller, feedback, coupons, discounts, sold counts, sponsored detection
• Pay-per-result — no monthly subscription, only pay for what you scrape
• Playwright browser — handles JavaScript-rendered content, better anti-bot bypass
• Multi-page pagination — scrape all results, not just page 1
• Sort options — best match, ending soonest, newly listed, price low/high

Quick Start

🇺🇸 Search iPhone 14 (US)

{
  "searchQuery": "iphone 14",
  "maxResults": 30,
  "maxPages": 1,
  "countryCode": "US",
  "useProxy": true,
  "sortOrder": "EBAY_BEST_MATCH"
}

🇩🇪 Search cameras (Germany)

{
  "searchQuery": "canon kamera",
  "maxResults": 20,
  "maxPages": 2,
  "countryCode": "DE",
  "useProxy": true,
  "sortOrder": "EBAY_PRICE_ASCENDING"
}

🇬🇧 Vintage clothing (UK, auctions ending soon)

{
  "searchQuery": "vintage levis denim jacket",
  "maxResults": 10,
  "maxPages": 1,
  "countryCode": "UK",
  "useProxy": true,
  "sortOrder": "EBAY_ENDING_SOONEST"
}

🇯🇵 Electronics (Japan)

{
  "searchQuery": "sony α7 iv",
  "maxResults": 15,
  "maxPages": 1,
  "countryCode": "JP",
  "useProxy": true
}

🇮🇳 Mobiles (India)

{
  "searchQuery": "oneplus 12",
  "maxResults": 10,
  "maxPages": 1,
  "countryCode": "IN",
  "useProxy": true
}

Input Parameters

Field	Type	Default	Description
searchQuery	string	"laptop"	Search keyword
maxResults	integer	30	Max results per run
maxPages	integer	1	Number of search result pages
countryCode	string	"US"	Country code: US, UK, DE, FR, IT, ES, AU, CA, IN, JP, AE, SA, BR
useProxy	boolean	true	Use Apify proxy (required for eBay)
sortOrder	string	"EBAY_BEST_MATCH"	Sort: EBAY_BEST_MATCH, EBAY_ENDING_SOONEST, EBAY_NEWLY_LISTED, EBAY_PRICE_ASCENDING, EBAY_PRICE_DESCENDING

Output Fields

Field	Description
itemId	eBay item ID
title	Listing title
price	Current price (numeric)
priceString	Formatted price (e.g. "$237.36")
currency	Currency code (USD, GBP, EUR, etc.)
listPriceString	Original/list price before discount
shippingCost	Shipping cost text ("Free delivery", "+$14.99")
condition	Item condition ("New", "Pre-Owned")
listingType	"Buy It Now" or "Auction"
bidCount	Number of bids (auctions only)
timeLeft	Time remaining (auctions only)
bestOffer	Accepts Best Offer (boolean)
soldCount	Number sold
coupon	Coupon/promo text
discountText	Discount/savings text
returnPolicy	Return policy text
isSponsored	Sponsored listing (boolean)
sellerName	Seller username
sellerUrl	Seller profile URL
sellerFeedbackPercent	Positive feedback %
sellerFeedbackCount	Total feedback count
imageUrl	Product image URL
url	Direct listing URL
scrapedAt	ISO timestamp

Pricing

$1.00 / 1,000 results — pay only for what you scrape. No monthly subscription. Platform costs (compute, proxy, storage) included.

Country Codes

Code	Domain	Marketplace
US	ebay.com	United States
UK	ebay.co.uk	United Kingdom
DE	ebay.de	Germany
FR	ebay.fr	France
IT	ebay.it	Italy
ES	ebay.es	Spain
AU	ebay.com.au	Australia
CA	ebay.ca	Canada
IN	ebay.in	India
JP	ebay.co.jp	Japan
AE	ebay.ae	UAE
SA	ebay.sa	Saudi Arabia
BR	ebay.com.br	Brazil

Support

• Open an issue for bugs or feature requests
• Leave a review — it helps others discover the tool