Secondhand MCP

by jlsookiki

Not rated
GitHub

About

Connects AI to Facebook Marketplace, Ebay, Poshmark, and Depop to find you the best deals

Details

Author
jlsookiki
Categories
Search, Other, Knowledge Base

Depop & Poshmark / Chrome Requirement

Depop and Poshmark require a headless browser. IfGoogle Chrome or Chromiumis 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.

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

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

Valid values:facebook,ebay,depop,poshmark

eBay uses the officialBrowse 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 asEBAY_CLIENT_IDandEBAY_CLIENT_SECRET

By default the server targets theUSeBay site. To search a different regional marketplace, set theEBAY_MARKETPLACE_IDenvironment variable:

{ "env": { "EBAY_MARKETPLACE_ID": "EBAY_DE" } }

The full list is available in theeBay API docs.

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

List all enabled marketplaces and their status.

Convenience pair following theChatGPT Deep Research tool contract— exact names, a single string argument each:

- search(query)— searches every enabled marketplace at once and returns{ results: [{ id, title, text, url }] }, whereidismarketplace:listingId
- fetch(id)— returns full listing details for asearchresult ID as{ id, title, text, url, metadata }

Useful for research-style clients that expect these standard tool names; for filtered searches usesearch_marketplace.

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. The target regional marketplace is controlled byEBAY_MARKETPLACE_ID(default:EBAY_US).

Depop— Uses a headless browser to search listings with support for category, condition, size, and color filters. The browser instance is shared across requests.

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.

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

- Create a new file insrc/marketplaces/
- ExtendBaseMarketplaceand implementsearch()and optionallygetListingDetails()
- Add the constructor toallMarketplacesinsrc/marketplaces/index.ts

- 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)
- Poshmark: Requires Chrome/Chromium installed; no official API so relies on page scraping
- Rate limiting: Don't make too many requests too quickly

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Search and get install details on MCP servers directly from your agent -- a unified marketplace index.

Argentina's trust-first local services marketplace. Six read-only tools to search verified professionals and deep-link into on-platform task creation. │

Search marketplace products, manage bookings, and handle customer relationships using the Rezdy Agent API.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.

All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.

MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.

At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.

Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/

AModel Context Protocol(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.

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

[!TIP]Want to skip the setup?TrySecondhand MCP Cloud— the hosted version that connects to Claude.ai and ChatGPT in 30 seconds. No install or Chrome required. Free tier included.

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" } } } }
{ "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. IfGoogle Chrome or Chromiumis 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.

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

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

Valid values:facebook,ebay,depop,poshmark

eBay uses the officialBrowse 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 asEBAY_CLIENT_IDandEBAY_CLIENT_SECRET

By default the server targets theUSeBay site. To search a different regional marketplace, set theEBAY_MARKETPLACE_IDenvironment variable:

{ "env": { "EBAY_MARKETPLACE_ID": "EBAY_DE" } }

The full list is available in theeBay API docs.

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

List all enabled marketplaces and their status.

Convenience pair following theChatGPT Deep Research tool contract— exact names, a single string argument each:

- search(query)— searches every enabled marketplace at once and returns{ results: [{ id, title, text, url }] }, whereidismarketplace:listingId
- fetch(id)— returns full listing details for asearchresult ID as{ id, title, text, url, metadata }

Useful for research-style clients that expect these standard tool names; for filtered searches usesearch_marketplace.

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. The target regional marketplace is controlled byEBAY_MARKETPLACE_ID(default:EBAY_US).

Depop— Uses a headless browser to search listings with support for category, condition, size, and color filters. The browser instance is shared across requests.

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.

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

- Create a new file insrc/marketplaces/
- ExtendBaseMarketplaceand implementsearch()and optionallygetListingDetails()
- Add the constructor toallMarketplacesinsrc/marketplaces/index.ts

- 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)
- Poshmark: Requires Chrome/Chromium installed; no official API so relies on page scraping
- Rate limiting: Don't make too many requests too quickly

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Search and get install details on MCP servers directly from your agent -- a unified marketplace index.

Argentina's trust-first local services marketplace. Six read-only tools to search verified professionals and deep-link into on-platform task creation. │

Search marketplace products, manage bookings, and handle customer relationships using the Rezdy Agent API.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.

All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.

MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.

At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.

Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.