secondhand-mcp

Secondhand MCP

A Model Context Protocol (MCP) server that lets AI assistants search secondhand marketplaces. Search Facebook Marketplace, eBay, and Depop for used and secondhand items — filter by price, category, condition, size, and color, then get full listing details with photos, descriptions, and seller info.

Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client.

Supported Marketplaces

Marketplace	Auth Required	Notes
Facebook Marketplace	No	Location-based search
eBay	Yes (API keys)	Official Browse API
Depop	No	Requires Chrome installed

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "secondhand": {
      "command": "npx",
      "args": ["-y", "secondhand-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your-ebay-client-id",
        "EBAY_CLIENT_SECRET": "your-ebay-client-secret"
      }
    }
  }
}

Claude Code

Add to ~/.claude/.mcp.json:

{
  "mcpServers": {
    "secondhand": {
      "command": "npx",
      "args": ["-y", "secondhand-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your-ebay-client-id",
        "EBAY_CLIENT_SECRET": "your-ebay-client-secret"
      }
    }
  }
}

eBay and Depop are both optional — if eBay API keys are missing or Chrome isn't installed, those marketplaces are automatically disabled and the rest still work.

Depop / Chrome Requirement

Depop uses a headless browser to bypass Cloudflare. If Google Chrome or Chromium is installed on your system, Depop is automatically enabled — no config needed. If Chrome isn't found, Depop is silently skipped.

On macOS, the first time you search Depop, you may see a system prompt asking to allow Node.js to control Chrome. This is expected — puppeteer needs to launch Chrome in headless mode. Allow it once and it won't ask again.

The browser runs invisibly in the background and only launches when you actually search Depop.

Configuration

Choosing Marketplaces

By default all marketplaces are enabled. To limit which are active, set the MARKETPLACES env var (comma-separated):

{
  "env": {
    "MARKETPLACES": "facebook,ebay"
  }
}

Valid values: facebook, ebay, depop

eBay API Keys

eBay uses the official Browse API. You need a free eBay developer account:

• Create an account at developer.ebay.com
• Create an application to get a Client ID and Client Secret
• Add them to your MCP config as EBAY_CLIENT_ID and EBAY_CLIENT_SECRET

Tools

search_marketplace

Search for items across marketplaces.

Parameter	Required	Default	Description
query	Yes		Search terms
marketplace	No	facebook	facebook, ebay, depop, or all
location	No	san francisco	City to search in (Facebook only)
maxPrice	No		Maximum price
minPrice	No		Minimum price
limit	No	20	Max results
showSold	No	false	Include sold items (Facebook only)
includeImages	No	false	Include image URLs in output
sort	No	relevance	Sort order (Depop only): relevance, newest, most_popular, price_low_to_high, price_high_to_low
condition	No		Item condition. eBay: new, like_new, good, fair. Depop: new, like_new, excellent, good, fair, used
category	No		Product category (Depop only): tops, bottoms, dresses, coats-jackets, footwear, accessories, bags, jewellery, activewear, swimwear
sizes	No		Size filter (Depop only): e.g. ["S", "M", "L"] or ["US 9", "US 10"]
colors	No		Color filter (Depop only): black, white, red, blue, green, yellow, orange, pink, purple, brown, grey, cream, multi, silver, gold

Data returned per marketplace:

Field	Facebook	eBay	Depop
Title	Yes	Yes	Yes
Price	Yes	Yes	Yes
Location	City	City, State	—
Condition	—	Yes	—
Photo count	1 thumbnail	1 thumbnail	1 thumbnail
Seller	Yes	Yes	—

get_listing_details

Get full details for a specific listing using an ID from search results.

Parameter	Required	Default	Description
listingId	Yes		Listing ID from search results
marketplace	No	facebook	facebook, ebay, or depop

Data returned per marketplace:

Field	Facebook	eBay	Depop
Description	Yes	Yes	Yes
All photos	Yes	Yes	Yes
Location	City	City, State, Country	—
Seller	Name	Username	Username
Delivery types	Yes	—	—
Shipping	Yes/No	Service codes	Yes/No

list_marketplaces

List all enabled marketplaces and their status.

How It Works

Facebook Marketplace — Uses Facebook's internal GraphQL API. Resolves city names to coordinates, then searches with location/price/query filters. No login or browser needed.

eBay — Uses the official eBay Browse API with OAuth 2.0 client credentials. Tokens are cached and auto-refreshed.

Depop — Uses a headless browser (puppeteer-core + stealth plugin) to bypass Cloudflare TLS fingerprinting, then calls Depop's internal web API from within the browser context. Returns clean JSON — no DOM scraping. The browser instance is shared across requests.

Development

git clone https://github.com/jlsookiki/secondhand-mcp.git
cd secondhand-mcp
npm install
npm run build

Adding a Marketplace

• Create a new file in src/marketplaces/
• Extend BaseMarketplace and implement search() and optionally getListingDetails()
• Add the constructor to allMarketplaces in src/marketplaces/index.ts

Limitations

• Facebook: Uses undocumented GraphQL API — may break if Facebook changes doc_id values
• eBay: Requires developer API keys (free tier available)
• Depop: Requires Chrome/Chromium installed; slower than Facebook/eBay (~5s per search) due to headless browser startup
• Rate limiting: Don't make too many requests too quickly

License

MIT