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 requires a headless browser. 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 — Searches listings by location, price, and query. Resolves city names to coordinates. 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 to search listings with support for category, condition, size, and color filters. 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: May break if Facebook changes their frontend
eBay: Requires developer API keys (free tier available)
Depop: Requires Chrome/Chromium installed; slower than Facebook/eBay (~5s per search)
Rate limiting: Don't make too many requests too quickly

License

MIT

MCP Servers