Secondhand MCP

Сервер Model Context Protocol (MCP), который позволяет ИИ-ассистентам искать товары на вторичных рынках. Ищите на Facebook Marketplace, eBay, Depop и Poshmark подержанные товары — фильтруйте по цене, категории, состоянию, размеру и цвету, затем получайте полную информацию о лотах с фотографиями, описаниями и данными продавца.

Работает с Claude Desktop, Claude Code, Cursor и любыми MCP-совместимыми клиентами.

[!TIP] Не хотите настраивать? Попробуйте Secondhand MCP Cloud — облачную версию, которая подключается к Claude.ai и ChatGPT за 30 секунд. Никакой установки или Chrome не требуется. Есть бесплатный тариф.

Поддерживаемые торговые площадки

Related MCP server: BopMarket MCP Server

Настройка

Claude Desktop

Добавьте в ~/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

Добавьте в ~/.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 и Poshmark опциональны — если отсутствуют ключи eBay API или не установлен Chrome, эти площадки автоматически отключаются, а остальные продолжают работать.

Depop и Poshmark / Требование Chrome

Depop и Poshmark требуют headless-браузер. Если на вашей системе установлен Google Chrome или Chromium, обе площадки автоматически включаются — никакой настройки не нужно. Если Chrome не найден, они молча пропускаются.

На macOS при первом поиске на Depop или Poshmark может появиться системный запрос на разрешение Node.js управлять Chrome. Это нормально — puppeteer необходимо запустить Chrome в headless-режиме. Разрешите один раз, и запрос больше не появится.

Браузер работает невидимо в фоне и запускается только при фактическом поиске на Depop или Poshmark.

Конфигурация

Выбор торговых площадок

По умолчанию все площадки включены. Чтобы ограничить активные, установите переменную окружения MARKETPLACES (через запятую):

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

Допустимые значения: facebook, ebay, depop, poshmark

Ключи API eBay

eBay использует официальный Browse API. Вам понадобится бесплатная учетная запись разработчика eBay:

1. Создайте аккаунт на developer.ebay.com

2. Создайте приложение, чтобы получить Client ID и Client Secret

3. Добавьте их в конфигурацию MCP как EBAY_CLIENT_ID и EBAY_CLIENT_SECRET

Региональный рынок eBay

По умолчанию сервер нацелен на сайт eBay США. Для поиска на другом региональном рынке установите переменную окружения EBAY_MARKETPLACE_ID:

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

Распространенные значения:

Полный список доступен в документации eBay API.

Инструменты

search_marketplace

Поиск товаров по торговым площадкам.

Данные, возвращаемые по каждой площадке:

get_listing_details

Получение полной информации о конкретном лоте по ID из результатов поиска.

Данные, возвращаемые по каждой площадке:

list_marketplaces

Вывод списка всех включенных торговых площадок и их статуса.

search / fetch (глубокое исследование)

Удобная пара, следующая контракту инструмента ChatGPT Deep Research — точные названия, каждый с одним строковым аргументом:

• search(query) — ищет сразу по всем включенным площадкам и возвращает { results: [{ id, title, text, url }] }, где id — это marketplace:listingId

• fetch(id) — возвращает полную информацию о лоте по ID из результата search как { id, title, text, url, metadata }

Полезно для клиентов исследовательского типа, ожидающих эти стандартные названия инструментов; для фильтрованного поиска используйте search_marketplace.

Как это работает

Facebook Marketplace — Ищет объявления по местоположению, цене и запросу. Преобразует названия городов в координаты. Не требует входа в систему или браузера.

eBay — Использует официальный eBay Browse API с учетными данными клиента OAuth 2.0. Токены кэшируются и автоматически обновляются. Целевой региональный рынок управляется через EBAY_MARKETPLACE_ID (по умолчанию: EBAY_US).

Depop — Использует headless-браузер для поиска объявлений с поддержкой фильтров по категории, состоянию, размеру и цвету. Экземпляр браузера используется совместно для всех запросов.

Poshmark — Использует headless-браузер для поиска объявлений с поддержкой фильтров по состоянию, размеру, цвету, сортировке и цене. Poshmark не привязан к местоположению — все товары доставляются по стране.

Разработка

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

Добавление торговой площадки

1. Создайте новый файл в src/marketplaces/

2. Расширьте BaseMarketplace и реализуйте search() и, опционально, getListingDetails()

3. Добавьте конструктор в allMarketplaces в src/marketplaces/index.ts

Ограничения

• Facebook: Может перестать работать, если Facebook изменит свой интерфейс

• eBay: Требуются ключи разработчика API (доступен бесплатный тариф)

• Depop: Требуется установленный Chrome/Chromium; медленнее, чем Facebook/eBay (~5 секунд на поиск)

• Poshmark: Требуется установленный Chrome/Chromium; нет официального API, поэтому полагается на парсинг страниц

• Ограничение частоты запросов: Не делайте слишком много запросов слишком быстро

Лицензия

MIT