Skip to content
Back to search

secondhand-mcp

MCP server for searching secondhand marketplaces — Facebook Marketplace, eBay, and Depop. Works with Claude Desktop, Claude Code, and other MCP clients.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jlsookiki--secondhand-mcp/badge.svg)](/listings/jlsookiki--secondhand-mcp)

HTML

<a href="/listings/jlsookiki--secondhand-mcp"><img src="/api/listings/jlsookiki--secondhand-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

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_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

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

Depop & Poshmark / Chrome Requirement

Depop and Poshmark require a headless browser. If **Google Chrome or Chromium** is installed on your system, both are automatically enabled — no config needed. If Chrome isn't found, they are silently skipped.

On macOS, the first time you search Depop or Poshmark, 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 or Poshmark.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 239 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/jlsookiki-secondhand-mcp-badge.png)](https://mseep.ai/app/jlsookiki-secondhand-mcp)
  2. [![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/3c5664f0-af0e-47f3-8027-de49f25cad5c)
  3. # Secondhand MCP
  4. A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that lets AI assistants search secondhand marketplaces. Search Facebook Marketplace, eBay, Depop, and Poshmark for used and secondhand items — filter by price, category, condition, size, and color, then get full listing details with photos, descriptions, and seller info.
  5. Works with Claude Desktop, Claude Code, Cursor, and other clients that run MCP servers locally.
  6. > [!TIP]
  7. > **Using ChatGPT? This one won't work there.**
  8. >
  9. > It runs on your computer, so it only works where your computer is — Claude Desktop, Claude Code, Cursor. [Secondhand MCP Cloud](https://secondhandmcp.com) is the same search, always on, so whichever assistant you actually use can reach it. Free tier, no card.
  10. | | This repo | [Cloud](https://secondhandmcp.com) |
  11. |---|---|---|
  12. | Claude Desktop, Code, Cursor | ✅ | ✅ |
  13. | ChatGPT, Claude, and other assistants | — | ✅ |
  14. | Searching from your phone | — | ✅ |
  15. | Chrome running in the background | needed | not needed |
  16. | Price | free, forever | free tier, then $4.99 |
  17. ## Supported Marketplaces
  18. | Marketplace | Auth Required | Notes |
  19. |-------------|---------------|-------|
  20. | Facebook Marketplace | No | Location-based search |
  21. | eBay | Yes (API keys) | Official Browse API |
  22. | Depop | No | Requires Chrome installed |
  23. | Poshmark | No | Requires Chrome installed |
  24. ## Setup
  25. ### Claude Desktop
  26. Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
  27. ```json
  28. {
  29. "mcpServers": {
  30. "secondhand": {
  31. "command": "npx",
  32. "args": ["-y", "secondhand-mcp"],
  33. "env": {
  34. "EBAY_CLIENT_ID": "your-ebay-client-id",
  35. "EBAY_CLIENT_SECRET": "your-ebay-client-secret",
  36. "EBAY_MARKETPLACE_ID": "EBAY_US"
  37. }
  38. }
  39. }
  40. }
  41. ```
  42. ### Claude Code
  43. Add to `~/.claude/.mcp.json`:
  44. ```json
  45. {
  46. "mcpServers": {
  47. "secondhand": {
  48. "command": "npx",
  49. "args": ["-y", "secondhand-mcp"],
  50. "env": {
  51. "EBAY_CLIENT_ID": "your-ebay-client-id",
  52. "EBAY_CLIENT_SECRET": "your-ebay-client-secret",
  53. "EBAY_MARKETPLACE_ID": "EBAY_US"
  54. }
  55. }
  56. }
  57. }
  58. ```
  59. eBay, Depop, and Poshmark are all optional — if eBay API keys are missing or Chrome isn't installed, those marketplaces are automatically disabled and the rest still work.
  60. ### Depop & Poshmark / Chrome Requirement
  61. Depop and Poshmark require a headless browser. If **Google Chrome or Chromium** is installed on your system, both are automatically enabled — no config needed. If Chrome isn't found, they are silently skipped.
  62. On macOS, the first time you search Depop or Poshmark, 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.
  63. The browser runs invisibly in the background and only launches when you actually search Depop or Poshmark.
  64. ## Configuration
  65. ### Choosing Marketplaces
  66. By default all marketplaces are enabled. To limit which are active, set the `MARKETPLACES` env var (comma-separated):
  67. ```json
  68. {
  69. "env": {
  70. "MARKETPLACES": "facebook,ebay"
  71. }
  72. }
  73. ```
  74. Valid values: `facebook`, `ebay`, `depop`, `poshmark`
  75. ### eBay API Keys
  76. eBay uses the official [Browse API](https://developer.ebay.com/api-docs/buy/browse/overview.html). You need a free eBay developer account:
  77. 1. Create an account at [developer.ebay.com](https://developer.ebay.com)
  78. 2. Create an application to get a Client ID and Client Secret
  79. 3. Add them to your MCP config as `EBAY_CLIENT_ID` and `EBAY_CLIENT_SECRET`
  80. ### eBay Marketplace / Region
  81. By default the server targets the **US** eBay site. To search a different regional marketplace, set the `EBAY_MARKETPLACE_ID` environment variable:
  82. ```json
  83. {
  84. "env": {
  85. "EBAY_MARKETPLACE_ID": "EBAY_DE"
  86. }
  87. }
  88. ```
  89. Common values:
  90. | Value | Site |
  91. |-------|------|
  92. | `EBAY_US` | ebay.com (default) |
  93. | `EBAY_DE` | ebay.de |
  94. | `EBAY_GB` | ebay.co.uk |
  95. | `EBAY_AU` | ebay.com.au |
  96. | `EBAY_FR` | ebay.fr |
  97. | `EBAY_IT` | ebay.it |
  98. | `EBAY_ES` | ebay.es |
  99. | `EBAY_CA` | ebay.ca |
  100. The full list is available in the [eBay API docs](https://developer.ebay.com/api-docs/static/rest-request-components.html#marketpl).
  101. ## Tools
  102. ### `search_marketplace`
  103. Search for items across marketplaces.
  104. | Parameter | Required | Default | Description |
  105. |-----------|----------|---------|-------------|
  106. | `query` | Yes | | Search terms |
  107. | `marketplace` | No | `facebook` | `facebook`, `ebay`, `depop`, `poshmark`, or `all` |
  108. | `location` | No | `san francisco` | City to search in (Facebook only) |
  109. | `radiusMiles` | No | `25` | Search radius in miles, up to 500 (Facebook only) |
  110. | `maxPrice` | No | | Maximum price |
  111. | `minPrice` | No | | Minimum price |
  112. | `limit` | No | `20` | Max results |
  113. | `showSold` | No | `false` | Include sold items (Facebook only) |
  114. | `includeImages` | No | `false` | Include image URLs in output |
  115. | `sort` | No | `relevance` | Sort order (Depop, Poshmark): `relevance`, `newest`, `most_popular`, `price_low_to_high`, `price_high_to_low` |
  116. | `condition` | No | | Item condition. eBay: `new`, `like_new`, `good`, `fair`. Depop: `new`, `like_new`, `excellent`, `good`, `fair`, `used`. Poshmark: `new` (NWT), `like_new` (NWOT), `good`, `fair` |
  117. | `category` | No | | Product category. Depop: `tops`, `bottoms`, `dresses`, `coats-jackets`, `footwear`, `accessories`, `bags`, `jewellery`, `activewear`, `swimwear`. Poshmark: `Jackets_&_Coats`, `Dresses`, `Shoes`, `Accessories`, etc. |
  118. | `brand` | No | | Brand filter (Poshmark only): e.g. `"Nike"`, `"Levi's"`, `"Gucci"` |
  119. | `department` | No | | Department filter (Poshmark only): `Women`, `Men`, `Kids` |
  120. | `sizes` | No | | Size filter (Depop, Poshmark): e.g. `["S", "M", "L"]` or `["US 9", "US 10"]` |
  121. | `colors` | No | | Color filter (Depop, Poshmark): `black`, `white`, `red`, `blue`, `green`, `yellow`, `orange`, `pink`, `purple`, `brown`, `grey`, `cream`, `multi`, `silver`, `gold` |
  122. **Data returned per marketplace:**
  123. | Field | Facebook | eBay | Depop | Poshmark |
  124. |-------|----------|------|-------|----------|
  125. | Title | Yes | Yes | Yes | Yes |
  126. | Price | Yes | Yes | Yes | Yes |
  127. | Location | City | City, State | — | — |
  128. | Condition | — | Yes | — | — |
  129. | Photo count | 1 thumbnail | 1 thumbnail | 1 thumbnail | 1 thumbnail |
  130. | Seller | Yes | Yes | — | — |
  131. ### `get_listing_details`
  132. Get full details for a specific listing using an ID from search results.
  133. | Parameter | Required | Default | Description |
  134. |-----------|----------|---------|-------------|
  135. | `listingId` | Yes | | Listing ID from search results |
  136. | `marketplace` | No | `facebook` | `facebook`, `ebay`, `depop`, or `poshmark` |
  137. **Data returned per marketplace:**
  138. | Field | Facebook | eBay | Depop | Poshmark |
  139. |-------|----------|------|-------|----------|
  140. | Description | Yes | Yes | Yes | Yes |
  141. | All photos | Yes | Yes | Yes | Yes |
  142. | Location | City | City, State, Country | — | — |
  143. | Seller | Name | Username | Username | Username |
  144. | Delivery types | Yes | — | — | — |
  145. | Shipping | Yes/No | Service codes | Yes/No | Always included |
  146. ### `list_marketplaces`
  147. List all enabled marketplaces and their status.
  148. ### `search` / `fetch` (deep research)
  149. Convenience pair following the [ChatGPT Deep Research tool contract](https://developers.openai.com/api/docs/guides/deep-research) — exact names, a single string argument each:
  150. - `search(query)` — searches every enabled marketplace at once and returns `{ results: [{ id, title, text, url }] }`, where `id` is `marketplace:listingId`
  151. - `fetch(id)` — returns full listing details for a `search` result ID as `{ id, title, text, url, metadata }`
  152. Useful for research-style clients that expect these standard tool names; for filtered searches use `search_marketplace`.
  153. ## How It Works
  154. **Facebook Marketplace** — Searches listings by location, radius, price, and query. Resolves city names to coordinates. No login or browser needed. Facebook serves non-browser callers a gated version of its search API from time to time (a single result with more pages behind it, or stubs with no listing inside); when that happens the server reads the logged-out search page instead, which still carries a full first page of results.
  155. **eBay** — Uses the official eBay Browse API with OAuth 2.0 client credentials. Tokens are cached and auto-refreshed. The target regional marketplace is controlled by `EBAY_MARKETPLACE_ID` (default: `EBAY_US`).
  156. **Depop** — Uses a headless browser to search listings with support for category, condition, size, and color filters. The browser instance is shared across requests.
  157. **Poshmark** — Uses a headless browser to search listings with support for condition, size, color, sort, and price filters. Poshmark is not location-based — all items ship nationally.
  158. ## Development
  159. ```bash
  160. git clone https://github.com/jlsookiki/secondhand-mcp.git
  161. cd secondhand-mcp
  162. npm install
  163. npm run build
  164. ```
  165. ### Adding a Marketplace
  166. 1. Create a new file in `src/marketplaces/`
  167. 2. Extend `BaseMarketplace` and implement `search()` and optionally `getListingDetails()`
  168. 3. Add the constructor to `allMarketplaces` in `src/marketplaces/index.ts`
  169. ## Limitations
  170. - **Facebook**: May break if Facebook changes their frontend
  171. - **eBay**: Requires developer API keys (free tier available)
  172. - **Depop**: Requires Chrome/Chromium installed; slower than Facebook/eBay (~5s per search)
  173. - **Poshmark**: Requires Chrome/Chromium installed; no official API so relies on page scraping
  174. - **Rate limiting**: Don't make too many requests too quickly
  175. ## License
  176. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.