# secondhand-mcp [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/jlsookiki/secondhand-mcp  
**GitHub Stars:** 106  
**npm Downloads (last month):** 905  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/secondhand-mcp

## Description
Search Facebook Marketplace, eBay, Depop, and Poshmark from AI — filters, photos, full listings.

## Tools
Capabilities this server exposes over MCP:

- **search_marketplace** — Search live listings on secondhand marketplaces by keyword. Marketplaces: facebook. Returns up to `limit` listings with id, title, price, location, seller and a thumbnail; call get_listing_details with an id for the description, every photo and shipping. Requirements: Facebook Marketplace needs no credentials but is local, so pass `location` as "City, ST"; eBay needs EBAY_CLIENT_ID and EBAY_CLIENT_SECRET in the server environment; Depop and Poshmark need Chrome or Chromium on the machine. Behavior: read-only, no login, no purchases. Facebook may rate-limit repeated searches from one IP, and results for a query are cached for 90 seconds. Errors: a marketplace that fails returns success:false with the reason instead of throwing; an unknown marketplace name lists the valid ones; an empty result usually means the query was too specific, so widen the keywords or drop a price bound before concluding nothing exists. Not for: buying, messaging sellers, saved searches, or new-retail catalogs.
- **get_listing_details** — Get one listing in full using an id from search_marketplace or from a marketplace URL: description, every photo, location, seller and shipping options. Photos: by default (imageMode:"urls") you get direct full-resolution CDN image URLs to fetch yourself, which is the most reliable option because some CDNs block server-side fetches. Set imageMode:"inline" (or includeImages:true) to have the server fetch the photos and return them as base64 image blocks; if that fetch is blocked the server falls back to URLs. Use imageSize to trade resolution for payload and maxImages to cap the count. Requirements: the same as search_marketplace for that marketplace. Behavior: read-only, one listing per call, no login. Errors: a listing that has been removed, or an id from the wrong marketplace, returns an error message rather than a partial listing. Not for: searching (use search_marketplace) or fetching many listings at once.
- **list_marketplaces** — List the marketplaces this server can search right now, with each one's display name, whether it needs credentials, and whether it is currently reachable. Call it once when a search fails with an unknown-marketplace error or before offering a marketplace the user did not name. Behavior: read-only, no arguments, no network calls beyond a health check. Not for: searching or fetching listings.
- **search** — Search every available secondhand marketplace at once with a single query string, following the ChatGPT deep research tool contract. Returns results whose ids (marketplace:listingId) can be passed to the fetch tool. Behavior: read-only; Facebook results use the server's default location because this contract carries no location, so prefer search_marketplace when a place matters. Not for: filtered or local searches.
- **fetch** — Fetch one listing in full for an id returned by the search tool, following the ChatGPT deep research tool contract. Id format: marketplace:listingId (for example "facebook:12345" or "ebay:v1|123|456"). Behavior: read-only. Errors: an id without the marketplace prefix, or for a removed listing, returns an error message. Not for: ids from search_marketplace, which take get_listing_details.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "secondhand-mcp": {
    "command": "npx",
    "args": ["-y","secondhand-mcp"]
  }
}
```

## Documentation

## What secondhand-mcp MCP server does

The secondhand-mcp MCP server exposes secondhand shopping searches to MCP-compatible AI assistants. It can query Facebook Marketplace, eBay, Depop, and Poshmark, then return search results or fuller information for a selected listing. Search criteria can include query text, price bounds, marketplace, result count, condition, category, size, and color. Some filters are marketplace-specific: Facebook supports location, radius, and sold-item settings; Poshmark supports brand and department; Depop and Poshmark support clothing-oriented categories and sizes.

Search results provide core listing information such as title and price. Depending on the marketplace, results can also include location, condition, seller data, and a thumbnail. A second request can retrieve the description, complete photo set, seller identity, location, delivery information, and shipping details available for that marketplace.

## How it works

Facebook Marketplace searches use a city and radius, with a default location of San Francisco and a default radius of 25 miles. The server resolves the city to coordinates and does not require a login or browser. If Facebook limits its non-browser search response, the server falls back to reading the logged-out search page.

eBay searches use the official Browse API and OAuth 2.0 client credentials. Access tokens are cached and refreshed automatically. The selected regional eBay site is controlled by `EBAY_MARKETPLACE_ID`, which defaults to the US marketplace.

Depop and Poshmark searches run through a shared headless Chrome or Chromium browser. The browser is launched only for those searches. On macOS, Node.js may need permission to control Chrome the first time one of these marketplaces is used.

## Setup and configuration

Run the server locally through `npx -y secondhand-mcp` and add that command to an MCP client configuration. The README provides configurations for Claude Desktop and Claude Code, and identifies Cursor as supported. eBay access requires an eBay developer application with a client ID and client secret. The `EBAY_MARKETPLACE_ID` setting can select regional sites such as `EBAY_DE`, `EBAY_GB`, or `EBAY_CA`.

All marketplaces are enabled by default when available. Set `MARKETPLACES` to a comma-separated list such as `facebook,ebay` to restrict the active sources. Missing eBay credentials disable eBay, while missing Chrome disables Depop and Poshmark; the remaining sources continue to operate. This makes the secondhand-mcp MCP server usable without configuring every marketplace.

## Tools and capabilities

- `search_marketplace` searches one marketplace or all enabled marketplaces. It supports price limits, result limits, optional image URLs, marketplace-specific sorting, and supported condition or product filters.
- `get_listing_details` retrieves full information using a listing ID returned by a search.
- `list_marketplaces` reports which marketplaces are enabled and their status.
- `search` and `fetch` provide a simpler pair for research clients that expect the ChatGPT Deep Research tool contract. `search` returns normalized result records, while `fetch` returns normalized listing details.

## Limitations and notes

Facebook location filtering applies only to Facebook. Brand and department filters apply only to Poshmark, while category, size, and color support varies across Depop and Poshmark. Depop and Poshmark are not location-based in the documented behavior. The local setup is intended for desktop clients and requires the computer running the server to remain available; the README specifically says it does not work with ChatGPT’s hosted experience. The secondhand-mcp MCP server is therefore a fit for local MCP workflows rather than phone-based or always-on searching.

_Full upstream README: https://allmcps.com/mcp/secondhand-mcp/readme_

