Secondhand MCP

Un servidor del Model Context Protocol (MCP) que permite a los asistentes de IA buscar en mercados de segunda mano. Busca en Facebook Marketplace, eBay, Depop y Poshmark artículos usados y de segunda mano — filtra por precio, categoría, estado, talla y color, y obtén detalles completos del anuncio con fotos, descripciones e información del vendedor.

Funciona con Claude Desktop, Claude Code, Cursor y cualquier cliente compatible con MCP.

[!TIP] ¿Quieres saltarte la configuración? Prueba Secondhand MCP Cloud — la versión alojada que se conecta a Claude.ai y ChatGPT en 30 segundos. Sin instalación ni Chrome necesario. Nivel gratuito incluido.

Mercados compatibles

Related MCP server: BopMarket MCP Server

Configuración

Claude Desktop

Añade a ~/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

Añade a ~/.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 y Poshmark son opcionales — si faltan las claves API de eBay o Chrome no está instalado, esos mercados se desactivan automáticamente y el resto sigue funcionando.

Depop y Poshmark / Requisito de Chrome

Depop y Poshmark requieren un navegador sin interfaz gráfica. Si Google Chrome o Chromium está instalado en tu sistema, ambos se activan automáticamente — no se necesita configuración. Si no se encuentra Chrome, se omiten silenciosamente.

En macOS, la primera vez que busques en Depop o Poshmark, puede aparecer un aviso del sistema pidiendo permiso para que Node.js controle Chrome. Esto es normal — puppeteer necesita lanzar Chrome en modo sin interfaz. Permítelo una vez y no volverá a preguntar.

El navegador se ejecuta de forma invisible en segundo plano y solo se lanza cuando realmente buscas en Depop o Poshmark.

Configuración

Elegir mercados

Por defecto todos los mercados están habilitados. Para limitar cuáles están activos, establece la variable de entorno MARKETPLACES (separada por comas):

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

Valores válidos: facebook, ebay, depop, poshmark

Claves API de eBay

eBay utiliza la API Browse oficial. Necesitas una cuenta gratuita de desarrollador de eBay:

1. Crea una cuenta en developer.ebay.com

2. Crea una aplicación para obtener un ID de cliente y un Secreto de cliente

3. Añádelos a tu configuración de MCP como EBAY_CLIENT_ID y EBAY_CLIENT_SECRET

Mercado / Región de eBay

Por defecto el servidor apunta al sitio de eBay de EE. UU.. Para buscar en un mercado regional diferente, establece la variable de entorno EBAY_MARKETPLACE_ID:

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

Valores comunes:

La lista completa está disponible en la documentación de la API de eBay.

Herramientas

search_marketplace

Busca artículos en todos los mercados.

Datos devueltos por mercado:

get_listing_details

Obtén los detalles completos de un anuncio específico usando un ID de los resultados de búsqueda.

Datos devueltos por mercado:

list_marketplaces

Lista todos los mercados habilitados y su estado.

search / fetch (investigación profunda)

Par de conveniencia que sigue el contrato de herramienta de investigación profunda de ChatGPT — nombres exactos, un único argumento de cadena cada uno:

• search(query) — busca en todos los mercados habilitados a la vez y devuelve { results: [{ id, title, text, url }] }, donde id es marketplace:listingId

• fetch(id) — devuelve los detalles completos del anuncio para un ID de resultado de search como { id, title, text, url, metadata }

Útil para clientes orientados a la investigación que esperan estos nombres de herramienta estándar; para búsquedas filtradas usa search_marketplace.

Cómo funciona

Facebook Marketplace — Busca anuncios por ubicación, precio y consulta. Resuelve nombres de ciudades a coordenadas. No necesita inicio de sesión ni navegador.

eBay — Utiliza la API oficial eBay Browse con credenciales de cliente OAuth 2.0. Los tokens se almacenan en caché y se actualizan automáticamente. El mercado regional objetivo se controla mediante EBAY_MARKETPLACE_ID (predeterminado: EBAY_US).

Depop — Utiliza un navegador sin interfaz para buscar anuncios con soporte para filtros de categoría, estado, talla y color. La instancia del navegador se comparte entre solicitudes.

Poshmark — Utiliza un navegador sin interfaz para buscar anuncios con soporte para filtros de estado, talla, color, orden y precio. Poshmark no se basa en la ubicación: todos los artículos se envían a nivel nacional.

Desarrollo

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

Añadir un mercado

1. Crea un nuevo archivo en src/marketplaces/

2. Extiende BaseMarketplace e implementa search() y opcionalmente getListingDetails()

3. Añade el constructor a allMarketplaces en src/marketplaces/index.ts

Limitaciones

• Facebook: Puede fallar si Facebook cambia su interfaz

• eBay: Requiere claves API de desarrollador (nivel gratuito disponible)

• Depop: Requiere Chrome/Chromium instalado; más lento que Facebook/eBay (~5 s por búsqueda)

• Poshmark: Requiere Chrome/Chromium instalado; no tiene API oficial, por lo que depende del raspado de páginas

• Límite de velocidad: No hagas demasiadas solicitudes demasiado rápido

Licencia

MIT